Vytvoření expedic hromadně importováním
Jak vytvářet expedice?
V portálu Mailship máte dvě možnosti, jak vytvářet expedice
Založit jednotlivě
Nahrát je hromadně pomocí importu
Na této stránce se podíváme na to, jak vytvářet produkty hromadně pomocí importu. Pokud vás zajímá, jak založit produkt jednotlivě, pokračujte podle tohoto návodu: Vytvoření expedice
Expedice lze nejen zakládat jednotlivě, ale také hromadně pomocí souboru. Šablonu pro import si můžete ve vybraném formátu stáhnout na portále. Ten následně vyplníte a nahrajete do systému Mailship.
Jak importovat expedice
Šablonu pro import ve vybraném formátu si můžete snadno stáhnout přímo na portále. Po vyplnění ji jednoduše nahrajete do systému Mailship, a vaše expedice budou přidány najednou.
1) Stažení šablony
V Mailship přejděte do sekce Expedice, klikněte na tři tečky vedle tlačítka "Vytvořit" a poté vyberte možnost "Importovat". Vyberte preferovaný formát a klikněte na "Stáhnout".


2) Vyplnění šablony
Vyplňte šablonu s údaji o objednávkách. Není nutné vyplňovat všechny sloupce, ale pouze ty povinné, případně ty, které chcete využít.

Jak upravovat pole v šabloně?
Po stažení šablony uvidíte vzorový řádek s příklady. Hodnoty ve špičatých závorkách <> jsou zde jen jako ukázky a při importu se závorky nepoužívají.
Sloupce, které nevyužijete, neodstraňujte, pouze je nechte prázdné. Pokud sloupec smažete, import nebude fungovat správně.
Jak importovat objednávku s více položkami?
Pokud chcete importovat objednávku s více produkty, je nutné pro každý produkt vytvořit nový řádek. Počet produktů v objednávce = počet řádků v importním souboru. Např. objednávka se třemi různými položkami bude mít tři řádky.
Vysvětlení jednotlivých polí
Název pole | Význam pole | Příklad |
Eshop Name* | Název Eshopu, pro který jsou objednávky zakládány (pevná hodnota pro konkrétní Eshop). | internal.mailstep |
Warehouse Name* | Název virtuálního skladu (pevná hodnota pro konkrétní Eshop). | internal.mailstep AVAILABLE |
Wms Name* | Název fyzického skladu (pevná hodnota pro konkrétní Eshop). | internal.mailstep PRG AVAILABLE |
Order Number* | Číslo objednávky (musí být v rámci Organizace jedinečné). | O000000 |
Číslo objednávky musí být jedinečné v rámci celé organizace (v rámci všech e-shopů). | ||
Note | Poznámka | Poznamka |
Billing First Name | Jméno | Josef |
Billing Last Name* | Příjmení | Naimportovany |
Billing Degree | Titul | PhD. |
Billing Company | Firma | MailStep |
Billing Street* | Ulice | Do Certous |
Billing House Nr | Číslo popisné | 2760/10 |
Billing House Nr sice není povinné pole, nicméně číslo popisné je pro adresu potřeba. Povinné není proto, že může být číslo popisné uvedeno v poli Billing Street. Tedy tento údaj je nezbytný, jen máte možnost ho zadat zvlášť ve dvou polích nebo dohromady v jednom poli. | ||
Billing Zip* | PSČ | 193 00 |
Billing City* | Město | Praha 9 |
Billing Country* | Země | CZ |
Billing Email* | Email zákazníka | |
Billing Phone* | Telefon zákazníka | +420 725 080 615 |
Billing Registration Number | IČO zákazníka (v případě nákupu na firmu). | 61859109 |
Billing Vat Number | DIČ (v případě nákupu na firmu). | CZ61859109 |
Different Delivery Address | Volba rozdílné doručovací adresy od fakturační. | 0 = vypnuto 1 = zapnuto a je následně nutné vyplnit další “billing” pole |
Delivery First Name | Jméno (vyplnit pouze pokud je Different Delivery Address = 1). | Oto |
Delivery Last Name | Příjmení (vyplnit pouze pokud je Different Delivery Address = 1). | Zavadil |
Delivery Degree | Titul (vyplnit pouze pokud je Different Delivery Address = 1). | Ja jsem |
Delivery Company | Firma (vyplnit pouze pokud je Different Delivery Address = 1). | MailStep |
Delivery Street | Ulice (vyplnit pouze pokud je Different Delivery Address = 1). | Do Čertous |
Delivery House Nr | Číslo popisné (vyplnit pouze pokud je Different Delivery Address = 1). | 2760/10 |
Delivery Zip | PSČ (vyplnit pouze pokud je Different Delivery Address = 1). | 193 00 |
Delivery City | Město (vyplnit pouze pokud je Different Delivery Address = 1). | Praha 9 – Horní Počernice |
Delivery Country | Země (vyplnit pouze pokud je Different Delivery Address = 1). | CZ |
Delivery Email | Email (vyplnit pouze pokud je Different Delivery Address = 1). | |
Delivery Phone | Telefon (vyplnit pouze pokud je Different Delivery Address = 1). | +420 284 816 211 |
Required Expedition Date | Den, kdy sklad začne zpracovávat objednávku. Pokud toto pole necháte prázdné, systém automaticky nastaví dnešní datum a zpracování objednávky začne ihned. | 2024-01-01 |
Carrier Code* | Kód dopravce. | 106 |
Carrier Service Code* | Kód dopravní služby. | 7 |
Kódy dopravců a dopravních služeb pro import naleznete zde: Kódy dopravců pro importy expedic | ||
Carrier Pickup Place Code* | Kód výdejního místa - povinné v případě volby přepravní služby s výdejními místy. | 900001 |
Carrier Note | Poznámka pro kurýra slouží k předání speciálních instrukcí doručovateli, například "Nezvonit, nechat u dveří". Tato poznámka je předána kurýrovi pouze u přepravců, kteří tuto funkci podporují. | Fofrem! |
Value* | Hodnota zásilky musí být uvedena v měně země, kam je zásilka odesílána. Desetinná místa oddělujte tečkou (např. | 2500 |
Currency* | Měna hodnoty zásilky musí odpovídat měně země, do které zásilku posíláte. Například pro Českou republiku zvolte CZK, pro Německo EUR. Použijte správný třípísmenný kód měny podle mezinárodního standardu ISO 4217 (např. CZK pro české koruny, EUR pro eura). | CZK |
Fragile | ZPOPLATNĚNÁ SLUŽBA BEZ VYŽÁDÁNÍ | 0 = bez označení křehké, 1= křehké |
Cod | Volba zásilky na dobírku. | off = zásilka bez dobírky on= zásilka na dobírku |
Cod Value | Hodnota dobírky - musí být v měně země, do které je zásilka expedována. Desetinná místa musí být oddělena tečkou, v případě CZ haléře nejsou podporovány. Povinné pokud je Cod = on. | 2345 |
Cod Currency | Měna dobírky zásilky - musí být v měně země, do které je zásilka expedována. Povinné pokud je Cod = on. | CZK |
Cod Variable Symbol | Variabilní symbol - povinné pokud je Cod = on. | 0000000000 |
Eshop Order Date | Datum, kdy došlo k objednávce v Eshopu. | Ve formátu rrrr-mm-dd 2024-01-01 |
Invoice Url | ZPOPLATNĚNÁ SLUŽBA BEZ VYŽÁDÁNÍ | |
Přílohy lze přidávat pouze pomocí URL odkazu. Dokument musí být ve formátu PDF a musí být dostupný online, například na webové stránce nebo FTP serveru. Před importem se ujistěte, že je odkaz funkční a soubor přístupný. | ||
Customer Group | Údaj pro vaši evidenci, který umožňuje rozdělení zákazníků podle skupin. | VIP |
Item Product SKU* | Primární EAN produktu | EAN000001 |
Item Internal SKU* | Interní SKU produktu | PRO000001 |
Produkty lze zadávat buď pomocí interního SKU (pole Item Internal SKU v šabloně), nebo pomocí EAN kódu (pole Item Product SKU v šabloně). Obě pole nelze vyplnit současně – vyberte tedy vždy jen jedno z nich. | ||
Item Count* | Počet jednotlivé položky | 20 |
Lifo | Typ vyskladnění šarží | 1 = vyskladňuje se "nejnovější" šarže (dle evidovaného datumu šarže) 0 nebo nezadané = vyskladňuje se "nejstarší" šarže (metoda fifo) |
Lot Number* | Číslo/název šarže (pouze u šaržovaných produktů). | 2021-33 |
Povinné pro produkty s evidencí šarže. Buď je potřeba šarži specifikovat, nebo určit pomocí Lifo. |
* Pole je povinné
3) Nahrání šablony
Jakmile máte šablonu vyplněnou, nahrajte ji přes tlačítko „Vyberte soubor“. Poté potvrďte import stisknutím tlačítka „Importovat soubory“.


Jak poznám, že import proběhl ne/úspěšně?
Po zahájení importu se v pravém dolním rohu obrazovky objeví upozornění o zpracování dat.
Úspěšný import: Pokud se na liště objeví zelená zpráva „Hotovo“ a vedle ní„Úspěch“, import expedic proběhl v pořádku. Uvidíte také počet úspěšně nahraných expedic.
Neúspěšný import: Pokud import selže, zobrazí se červená zpráva „Chyba“. Pro podrobnosti o problému stačí kliknout na „Více info“, kde najdete detaily o důvodu chyby.



Možné komplikace a jejich řešení
Produkt nenalezen
Row 2: Product not found in eshop named xxx
Tato chybová hláška znamená, že produkt, který chcete nahrát do expedice, buď pod zvoleným e-shopem neexistuje, nebo nemá přiřazený správný e-shop. Ověřte v sekci Produkty, zda je produkt zadán správně, a pokud nemá přiřazený e-shop, doplňte jej. Poté můžete produkt znovu nahrát do expedice.

Nevyplněný povinný údaj
Row 2: delivery_country is mandatory
V objednávce jste označili, že chcete použít odlišnou fakturační a doručovací adresu, ale doručovací adresa nebyla vyplněna. Aby byl import úspěšný, je potřeba doplnit všechny potřebné údaje k doručovací adrese, včetně země doručení. Ujistěte se, že všechna pole týkající se doručovací adresy jsou správně vyplněná.

Row 2: warehouseName: This value should not be blank.
Chybí informace o skladu (nebo jiné hodnoty), ze kterého má být objednávka vychystána. Řešením je doplnit správný název skladu do příslušného pole v šabloně. Po opravě tohoto údaje znovu nahrajte soubor, aby mohl být import úspěšně dokončen.

Row 2: quantity: This value should be greater than 0.
V objednávce chybí vyplnit počet kusů u produktu, který chcete expedovat. Tento údaj je nutné doplnit do příslušného pole. Po jeho vyplnění znovu importujte soubor, aby objednávka mohla být úspěšně zpracována.

Duplicitní číslo objednávky
Row 2: orderNumber: xxx, This value is already used.
Tato chyba znamená, že byl použit duplicitní název objednávky, což značí, že objednávka s tímto názvem už v systému existuje. Řešením je změnit název objednávky na unikátní a poté znovu provést import.
