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_ids 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 poleauto_delivery_branch_location.
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. |
Zásilkovna a Balíkovna vždy z podacího místa
Zásilky dopravců Zásilkovna a Balíkovna import vždy vytvoří s podáním na podacím
místě, protože tito dopravci zásilky na adrese odesílatele nevyzvedávají. Bez
pickup_branch_code můžete zásilku podat na libovolné pobočce dopravce, případně se použije
vaše výchozí podací místo.
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/listvrací všechna místa včetně kódu (code) a příznakůis_collection(lze zde podat zásilku) ais_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 |
Boxy (AlzaBox, PPL Parcelbox, DPD box) slouží u většiny dopravců pouze k doručení a nelze
na nich zásilku podat. V číselníku míst je poznáte podle is_locker: 1 a is_collection: false.
Hotové příklady
Hotové importní soubory pro jednotlivé varianty — zásilku ze svozové adresy, z podacího místa na výdejní místo a zásilku se Zásilkovnou — najdete na stránce Příklady importních souborů.