# Hromadný import objednávek

Díky hromadnému importu ze souboru **CSV, XLS, XLSX a ODS** nemusíte jednotlivé objednávky
do Manažeru zásilek zadávat ručně. Stačí si na pár kliknutí nastavit hromadný import
a objednávky z vašeho e-shopu importovat do [Zaslat.cz](https://www.zaslat.cz) jedním tahem.

:::tip[Video návod]

Celý postup si můžete projít i ve videu níže.

:::

<iframe
  src="https://www.youtube.com/embed/kG6xUY78RUo"
  title="Hromadný import objednávek do Manažeru zásilek"
  style={{ aspectRatio: "16 / 9", width: "100%", border: 0, borderRadius: "8px" }}
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

## Nastavení importu v Manažeru zásilek

V Manažeru zásilek klikněte v levém menu na položku **Nastavení** a zvolte možnost
**Integrace** (Obrázek 1, krok 1).

Pokud jste v Manažeru zásilek poprvé, vytvořili jsme pro vás možnost hromadného importu
ze souboru automaticky (Obrázek 1, krok 2). Možnost tedy můžete používat okamžitě bez
dalšího nastavení.

Pokud si však chcete hromadný import přizpůsobit podle sebe, klikněte na modré tlačítko
**Nastavit hromadný import** (Obrázek 1, krok 3).

![Obrázek 1: Nastavení hromadného importu v Manažeru zásilek](./assets/hromadny-import-objednavek/obr-01-nastaveni-importu.png)

<span className="text-muted-foreground">_Obrázek 1: Nastavení hromadného importu v Manažeru zásilek_</span>

Do pole **Název** (Obrázek 2, krok 1) vepište libovolný název vaší integrace. Vyberte si
**formát importního souboru** (Obrázek 2, krok 2) — buď Zaslat.cz, nebo Shoptet. Pokud váš
e-shop provozujete na platformě Shoptet, můžete si jej propojit s Manažerem zásilek napřímo;
více zjistíte v sekci [Shoptet](/integrations/shoptet).

Jestliže zásilky odesíláte pokaždé ze stejné adresy, zvolte si nyní **Výchozí adresu
odesílatele** (Obrázek 2, krok 3). Všechny objednávky importované ze souboru budeme
vyzvedávat právě na této adrese. Stejně tak si můžete zvolit **výchozí rozměr a váhu balíku**,
pokud například posíláte své produkty zabalené stále do stejného balení (Obrázek 2, krok 3).
Tyto informace si můžete libovolně měnit i po importu souboru. Nakonec klikněte na modré
tlačítko **Vytvořit novou integraci** (Obrázek 2, krok 4).

![Obrázek 2: Nastavení importu zásilek pomocí souborů](./assets/hromadny-import-objednavek/obr-02-nastaveni-importu-souboru.png)

<span className="text-muted-foreground">_Obrázek 2: Nastavení importu zásilek pomocí souborů_</span>

## Příprava importního souboru

Nyní je potřeba připravit soubor ve formátu **CSV, XLS, XLSX nebo ODS** (nejčastěji v Excelu
či jiném tabulkovém editoru) s informacemi o příjemcích, který poté nahrajete do administrace
[Zaslat.cz](https://www.zaslat.cz). Soubor si připravíte následovně:

- Do prvního řádku tabulky zadejte jednotlivá pole (viz [Seznam možných polí](#seznam-možných-polí)
  níže). Do každé buňky zadejte jedno pole.
- **Povinná pole** (v seznamu označená ✓) musíte vyplnit vždy, ostatní záleží na typu zásilky.
- Takto připravenou tabulku uložte ve formátu **CSV, XLS, XLSX nebo ODS** — konkrétně v Excelu
  soubor uložíte jako **„CSV (textový soubor s oddělovači)“**.

## Nahrání importního souboru do Zaslat.cz

Integraci máte nastavenou a nyní můžete do Manažeru zásilek nahrávat soubory se zásilkami ve
formátu .xls, .xlsx, .csv a .ods. V levém menu navštivte položku **Zásilky** (Obrázek 3, krok 1)
a poté klikněte na tlačítko **Nahrát zásilky** (Obrázek 3, krok 2).

![Obrázek 3: Import souboru do Manažeru zásilek Zaslat](./assets/hromadny-import-objednavek/obr-03-import-souboru.png)

<span className="text-muted-foreground">_Obrázek 3: Import souboru do Manažeru zásilek_</span>

V dialogu si můžete stáhnout **Zdrojový soubor Zaslat.cz** (Obrázek 4, krok 1), podle kterého
si upravíte soubor s vašimi objednávkami tak, aby import proběhl úspěšně. Nyní nahrajte váš
soubor a klikněte na modré tlačítko **Nahrát zásilky** (Obrázek 4, krok 2).

![Obrázek 4: Nahrání zdrojového souboru se zásilkami](./assets/hromadny-import-objednavek/obr-04-nahrani-souboru.png)

<span className="text-muted-foreground">_Obrázek 4: Nahrání souboru se zásilkami_</span>

Všechny zásilky z vašeho souboru se nyní zobrazí v uceleném přehledu zásilek. V objednávkách
můžete cokoliv měnit kliknutím na řádek objednávky. Jakmile si vše zkontrolujete, můžete
zásilky **Objednat** (Obrázek 5). Importujte objednávky do Zaslat.cz hromadně i vy a šetřete
si čas.

![Obrázek 5: Objednávka přepravy](./assets/hromadny-import-objednavek/obr-05-objednavka-prepravy.png)

<span className="text-muted-foreground">_Obrázek 5: Objednávka přepravy_</span>

## Vzorové importní soubory

Vzorový importní soubor si můžete stáhnout přímo v aplikaci — v dialogu **Nahrát zásilky**
(viz Obrázek 4) odkazem **Zdrojový soubor Zaslat.cz**. Je k dispozici ve formátech CSV, XLS,
XLSX i ODS a obsahuje správné názvy polí i ukázková data, podle kterých si svůj soubor snadno
připravíte.

## Seznam možných polí

V tabulce najdete všechna pole, která lze v importním souboru použít. **Povinná pole** jsou
označena ✓ ve sloupci Povinné; ostatní jsou volitelná podle typu zásilky.

| Povinné | Pole | Datový typ | Popis | Poznámka |
| :---: | --- | --- | --- | --- |
| ✓ | `reference` | String | Váš identifikátor zásilky | Informace bude na štítku |
|  | `carrier` | Enum [gls\|dpd] | Preference přepravce | Pokud nezadáno, systém vybere nejvhodnějšího |
| ✓ | `packages` | String | Hmotnosti balíků v zásilce oddělené lomítkem (v kg) | Například 3 balíky v zásilce: 1,5/3/3,5 |
|  | `cod` | Float | Dobírka |  |
|  | `cod_currency` | Enum [CZK\|EUR] | Měna dobírky | Vyžadováno, pokud je vyplněna dobírka |
|  | `cod_variable` | Integer | Variabilní symbol pro dobírkovou platbu |  |
|  | `ins` | Float | Připojištění |  |
|  | `ins_currency` | Enum [CZK\|EUR] | Měna připojištění | Vyžadováno, pokud je vyplněno připojištění |
|  | `note` | String (255) | Poznámka pro řidiče | Informace bude na štítku |
|  | `from_date` | Date [yyyy-mm-dd] | Datum vyzvednutí | U pravidelného svozu irelevantní |
|  | `from_address_id` | Integer | ID adresy odesílatele z adresáře Zaslat.cz | Při zadání budou ignorována pole odesílatele |
|  | `from_company` | String (64) | Firma | Při nezadání se převezme svozová adresa \* |
|  | `from_firstname` | String (32) | Jméno | Při nezadání se převezme svozová adresa \* |
|  | `from_surname` | String (32) | Příjmení | Při nezadání se převezme svozová adresa \* |
|  | `from_country` | Enum [CZ\|SK\|…] | ISO kód státu (2 znaky) | Při nezadání se převezme svozová adresa \* |
|  | `from_zip` | String (7) | PSČ | Při nezadání se převezme svozová adresa \* |
|  | `from_city` | String (32) | Město | Při nezadání se převezme svozová adresa \* |
|  | `from_street` | String (32) | Ulice s číslem popisným | Při nezadání se převezme svozová adresa \* |
|  | `from_email` | String (64) | E-mail pro oznámení | E-mail pro oznámení o stavu přepravy zásilky |
|  | `from_phone` | String (32) | Telefonní číslo s předvolbou (+420xxxxxxxxx) | Při nezadání se převezme svozová adresa \* |
|  | `to_address_id` | Integer | ID adresy příjemce z adresáře Zaslat.cz | Při zadání budou ignorována pole příjemce |
|  | `to_company` | String (64) | Firma | Název firmy příjemce |
| ✓ | `to_firstname` | String (32) | Jméno příjemce |  |
| ✓ | `to_surname` | String (32) | Příjmení příjemce |  |
| ✓ | `to_country` | Enum [CZ\|SK\|…] | Kód státu příjemce | ISO kód státu (2 znaky) |
| ✓ | `to_zip` | String (7) | PSČ příjemce |  |
| ✓ | `to_city` | String (32) | Město příjemce |  |
| ✓ | `to_street` | String (32) | Ulice příjemce vč. čísla popisného |  |
| ✓ | `to_email` | String (64) | E-mail příjemce | E-mail pro oznámení o stavu přepravy zásilky |
| ✓ | `to_phone` | String (32) | Tel. číslo příjemce s předvolbou (+420xxxxxxxxx) | Pro zahraničí vždy lokální telefonní číslo |
|  | `pickup_branch_code` | String (64) | Kód podacího místa konkrétního dopravce | Při zadání se doplní jako podací místo |
|  | `delivery_branch_code` | String (64) | Kód výdejního místa konkrétního dopravce | Při zadání se doplní jako výdejní místo |

<span className="text-muted-foreground">_\* V případě nastavení výchozí adresy v administraci Zaslat.cz není pole povinné — údaje se převezmou z výchozí svozové adresy._</span>

- Kódování souboru: **UTF-8**.
- Oddělovač: **středník**.
- Povinná pole jsou v tabulce výše označena ✓ ve sloupci Povinné.
