Copy page

Hromadný import objednávek

Podací a výdejní místo

Při hromadném importu objednávek určujete v souboru oba konce cesty zásilky. U každého z nich volíte mezi adresou a místem konkrétního dopravce:

• Svozová adresa — kurýr přijede pro zásilku na adresu odesílatele. Adresu určuje pole from_address_id s ID svozové adresy z Manažeru zásilek, případně výchozí adresa odesílatele integrace.
• Podací místo — zásilku se štítkem odnesete sami na pobočku nebo do boxu dopravce. Konkrétní místo určuje pole pickup_branch_code.
• Adresa příjemce — kurýr doručí zásilku na adresu z polí to_*.
• Výdejní místo — příjemce si zásilku vyzvedne na pobočce nebo v boxu dopravce. Konkrétní místo určuje pole delivery_branch_code, nejbližší místo vybere pole auto_delivery_branch_location.

Cesta zásilky: plná čára = adresa, čárkovaná = místo dopravce. Obě strany lze kombinovat libovolně.

Jak zadat jednotlivé varianty

Chcete	Co zadat v souboru
Kurýr vyzvedne zásilku na adrese odesílatele	Pole from_address_id s ID svozové adresy (Svozy → Svozové adresy). Pole from_* a pickup_branch_code nevyplňujte.
Podání na libovolném podacím místě dopravce	U integrace zapněte přepínač Zásilky vytvářet s předáním na podacím místě (viz Nastavení importu). Platí pro všechny řádky souboru. Pokud máte v Nastavení → Šablony nastavené Výchozí podací místo daného dopravce, použije se ono.
Podání na konkrétním podacím místě	carrier + pickup_branch_code. Místo musí podporovat podání zásilek (v číselníku míst příznak is_collection).
Doručení na adresu příjemce	Pole to_*. Pole delivery_branch_code nevyplňujte.
Doručení na konkrétní výdejní místo nebo box	carrier + delivery_branch_code.
Doručení na nejbližší výdejní místo k adrese příjemce	auto_delivery_branch_location = 1. S polem carrier se vybírá jen z míst daného dopravce.

Kde získat kód místa

Kód místa (pickup_branch_code, delivery_branch_code) je kód, pod kterým místo vede daný dopravce. Kód je jedinečný pouze v rámci dopravce, proto je nutné vždy vyplnit i pole carrier. Podací i výdejní místo v jednom řádku musí patřit stejnému dopravci.

• Číselník míst: veřejný endpoint GET /parcelpoints/list vrací všechna místa včetně kódu (code) a příznaků is_collection (lze zde podat zásilku) a is_locker (box). Volat ho můžete bez API klíče, filtrovat lze podle země a dopravce.
• Mapový widget vrací po výběru místa na mapě stejný objekt včetně kódu.

Formát kódu se liší podle dopravce. Příklady odpovídají stavu číselníku v době psaní tohoto návodu, před použitím si je ověřte v číselníku:

Dopravce (carrier)	Podoba kódu	Příklad	Místo z příkladu
zasilkovna	číselné ID pobočky nebo Z-BOXu	4835	Alfamobil, Poštovská 455/8, Brno
ppl	KM + číslice	KM11460200	AKVARIUS, Novobranská 532/20, Brno
dpd	CZ + číslice	CZ10913	Allwyn – GAHO vinotéky, Charbulova 831/30, Brno
gls	CZ + PSČ + - + označení	CZ61500-PSHOP002	Apokryf knihy, Stará Osada 15, Brno
balikovna	číselný kód pobočky	60100	Brno 1, Šumavská 519/35, Brno