# Příklady importních souborů
Tato stránka doplňuje návod [Hromadný import objednávek](/integrations/hromadny-import-objednavek)
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](/integrations/hromadny-import-objednavek#nastavení-importu-v-manažeru-zásilek).
## 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
```csv
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
```
:::tip[Kde najdete ID svozové adresy]
V Manažeru zásilek otevřete **Svozy → Svozové adresy** a klikněte na adresu, ze které kurýr
zásilky vyzvedává. V záhlaví detailu je vedle adresy uvedeno její ID, například
**(ID 12345)**. Toto číslo vložte do sloupce `from_address_id`. Ve staženém souboru
nahraďte hodnotu `12345` svým ID. Postup založení svozové adresy popisuje stránka
[Svozy](/mz/svozy#nová-svozová-adresa).
:::
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
```csv
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
```csv
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](/integrations/hromadny-import-objednavek/podaci-a-vydejni-misto#kde-získat-kód-místa);
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.