Skip to main content
Skip table of contents

Vytvoření expedic hromadně importováním

Jak vytvářet expedice?

V portálu Mailship máte dvě možnosti, jak vytvářet expedice

  1. Založit jednotlivě

  2. 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 image-20240809-144419.png vedle tlačítka "Vytvořit" a poté vyberte možnost "Importovat". Vyberte preferovaný formát a klikněte na "Stáhnout".

image-20241018-103101.png
image-20241018-103436.png

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

mailstep@mailstep.cz

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).

prace@mailstep.cz

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.50). U zásilek do České republiky se haléře nepodporují, takže uvádějte částku bez nich (např. 2500).

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Í
Volba služby “křehké”.

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Í
URL odkaz pro vložení PDF dokumentu.

http://example.com/invoice/123456.pdf

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“.

image-20241018-103101.png

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.

image-20241021-144554.png
image-20241023-085414.png
image-20241021-144626.png

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.

image-20241018-114022.png

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á.

image-20241018-115447.png

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.

image-20241018-120947.png

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.

image-20241018-121532.png

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.

image-20241018-120410.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.