Příklady importních souborů

Tato stránka doplňuje návod Hromadný import objednávek o hotové soubory pro typické situace. Soubory jsou připravené ke stažení a okamžitému otestování: stáhněte si soubor CSV (kódování UTF-8, oddělovač středník) a nahrajte ho přes Zásilky → Nahrát zásilky. Kódy míst v příkladech pochází z aktuálního číselníku; adresy příjemců jsou smyšlené. Soubory pro podání na podacím místě předpokládají, že máte u integrace nastavenou výchozí adresu odesílatele.

Zásilka ze svozové adresy

Kurýr vyzvedne zásilky na vaší svozové adrese. Odesílatele určuje jediné pole from_address_id — ID svozové adresy z Manažeru zásilek. Ostatní pole from_* nevyplňujte. Druhá zásilka má dva balíky, preferovaného dopravce a dobírku.

Soubor zasilka-ze-svozove-adresy.csv — stáhnout CSV

Code
reference;from_address_id;carrier;packages;to_firstname;to_surname;to_company;to_street;to_city;to_zip;to_country;to_phone;to_email;cod;cod_currency;cod_variable
OBJ-1001;12345;;2.5[30x20x15];Petr;Dvořák;;Vodičkova 12;Praha;11000;CZ;+420601123456;petr.dvorak@example.com;;;
OBJ-1002;12345;ppl;1[20x15x10]/3;Eva;Malá;Firma ABC s.r.o.;Masarykova 1;Ostrava;70200;CZ;+420602987654;eva.mala@example.com;1490;CZK;1002

Co jednotlivá pole znamenají:

• from_address_id = 12345 je ID vaší svozové adresy. Musí patřit vašemu účtu; kurýr přijede právě sem.
• carrier je u první zásilky prázdný — v Manažeru zásilek uvidíte nabídky všech dopravců. U druhé zásilky se nabídka omezí na PPL.
• packages = 2.5[30x20x15] je jeden balík o hmotnosti 2,5 kg a rozměrech 30 × 20 × 15 cm. Hodnota 1[20x15x10]/3 jsou dva balíky: první 1 kg s rozměry, druhý 3 kg bez rozměrů (rozměry doplní výchozí balík integrace, nebo je zadáte v detailu zásilky).
• cod = 1490 s cod_currency = CZK a cod_variable = 1002 je dobírka 1 490 Kč s variabilním symbolem 1002. Dobírka se vyplácí na účet pro CZK, který máte nastavený v účtu; jiný účet zadáte poli cod_account_number a cod_bank_code.

Výsledek: dvě rozpracované zásilky s vyzvednutím na svozové adrese. V detailu vyberete službu dopravce a zásilky objednáte. Datum vyzvednutí můžete určit polem from_date.

Zásilka z podacího místa na výdejní místo

Zásilku odnesete na podací místo dopravce a příjemce si ji vyzvedne na výdejním místě téhož dopravce. Kurýr nikam nejezdí. První řádek používá PPL ParcelShopy, druhý DPD Pickup místa.

Soubor zasilka-z-podaciho-na-vydejni-misto.csv — stáhnout CSV

Code
reference;carrier;pickup_branch_code;delivery_branch_code;packages;to_firstname;to_surname;to_street;to_city;to_zip;to_country;to_phone;to_email
OBJ-2001;ppl;KM11460200;KM10816200;1.2[25x20x10];Petr;Dvořák;Vodičkova 12;Praha;11000;CZ;+420601123456;petr.dvorak@example.com
OBJ-2002;dpd;CZ10913;CZ44203;0.8[20x15x10];Eva;Malá;Masarykova 1;Ostrava;70200;CZ;+420602987654;eva.mala@example.com

Co jednotlivá pole znamenají:

• carrier je povinný — podle něj se kódy míst dohledají. Obě místa v řádku musí patřit tomuto dopravci.
• pickup_branch_code = KM11460200 je podací místo PPL (AKVARIUS, Novobranská 532/20, Brno), delivery_branch_code = KM10816200 je výdejní místo PPL (B&T Potraviny, Brunclíkova 1878/8, Praha).
• pickup_branch_code = CZ10913 a delivery_branch_code = CZ44203 jsou podací a výdejní místo DPD (Allwyn – GAHO vinotéky, Brno, a 3T FOODS, Hartigova 2596/211, Praha).
• Adresu příjemce (to_street, to_city, to_zip, to_country) vyplňte i při doručení na výdejní místo — kontrola souboru ji vyžaduje. Doručovací místo určuje kód v delivery_branch_code.
• Pole from_address_id chybí: odesílatel se převezme z výchozí adresy integrace. Adresa odesílatele je potřebná i při podání na pobočce, například pro výpočet ceny.

Výsledek: zásilky s podáním na zvoleném místě a doručením na zvolené místo. Pokud kód podacího nebo výdejního místa neodpovídá žádnému místu daného dopravce, zásilka se vytvoří bez tohoto místa a doplníte ho v detailu zásilky.

Zásilka se Zásilkovnou jako dopravcem

Zásilkovna zásilky na adrese odesílatele nevyzvedává — podáte je vždy na pobočce Zásilkovny nebo v Z-BOXu. Doručit může na výdejní místo, do Z-BOXu i na adresu příjemce. Příklad ukazuje všechny tři varianty doručení a u první zásilky i konkrétní podací místo.

Soubor zasilka-zasilkovna.csv — stáhnout CSV

Code
reference;carrier;pickup_branch_code;delivery_branch_code;auto_delivery_branch_location;packages;to_firstname;to_surname;to_street;to_city;to_zip;to_country;to_phone;to_email;cod;cod_currency;cod_variable
OBJ-3001;zasilkovna;4835;28634;;1.5[30x20x10];Petr;Dvořák;Vodičkova 12;Praha;11000;CZ;+420601123456;petr.dvorak@example.com;;;
OBJ-3002;zasilkovna;;;;2[35x25x15];Eva;Malá;Masarykova 1;Ostrava;70200;CZ;+420602987654;eva.mala@example.com;890;CZK;3002
OBJ-3003;zasilkovna;;;1;1[20x15x10];Karel;Svoboda;Náměstí Svobody 8;Brno;60200;CZ;+420603111222;karel.svoboda@example.com;;;

Co jednotlivá pole znamenají:

• carrier = zasilkovna je nutný ve všech řádcích, i bez kódů míst. Podle něj import nastaví podání na pobočce a omezí nabídku na Zásilkovnu. Bez něj by se zásilka vytvořila s vyzvednutím kurýrem na adrese, které Zásilkovna nenabízí.
• Řádek 1: pickup_branch_code = 4835 je pobočka Zásilkovny Alfamobil (Poštovská 455/8, Brno), kde zásilku podáte. delivery_branch_code = 28634 je Z-BOX (Milevská 922/2, Praha), kde si ji příjemce vyzvedne.
• Řádek 2: bez kódů míst — zásilku podáte na libovolné pobočce Zásilkovny (nebo na svém výchozím podacím místě) a Zásilkovna ji doručí na adresu příjemce. Dobírka 890 Kč s variabilním symbolem 3002.
• Řádek 3: auto_delivery_branch_location = 1 — Manažer zásilek sám vybere výdejní místo Zásilkovny nejbližší k adrese příjemce.
• Kódy Zásilkovny jsou číselná ID poboček a Z-BOXů z číselníku míst; stejná ID používá Zásilkovna ve svých mapách.

Výsledek: tři rozpracované zásilky Zásilkovny. Přepínač integrace Zásilky vytvářet s předáním na podacím místě u Zásilkovny nemusíte zapínat, podání na pobočce se nastaví automaticky.