Import CSV

Podoba importovaného souboru

CSV je jednoduchý souborový formát určený pro výměnu tabulkových dat. Soubor ve formátu CSV sestává z řádků, ve kterých jsou jednotlivé položky odděleny středníkem tj. znakem ";". Je vhodné, ne však nutné, hodnoty jednotlivých sloupců uzavírat do uvozovek. To umožňuje, aby text položky obsahoval středník. Importovaný soubor nesmí začínat prázdným řádkem ani jinými bílými znaky.
Je potřeba ukládat soubor ve znakové sadě Windows-1250 nebo UTF-8. (Ukázkový soubor je Windows-1250 aby se správně zobrazoval v Excelu)

Nastavení pořadí sloupců

Pro import lze použít dva různé způsoby pro určení pořadí sloupců. Buďto jsou v souboru explicitně uvedené hlavičky tj. první řádek v souboru obsahuje hlavičky jednotlivých sloupců uvedené v prvním sloupci níže uvedené tabulky. Druhou možností je pak individuální nastavení pořadí sloupců. V tomto případě není nutné, aby soubor obsahoval názvy jednotlivých sloupců. Stačí si v nastavení obchodu v menu "Nastavení CSV" vytvořit a uložit vlastní pořadí sloupců. Podle tohoto pořadí se pak data ze souboru načítají. Dále je možné zvolit při importu vynechání prvního řádku souboru. Toto se může hodit, pokud Váš systém generuje CSV soubor s hlavičkami, které neodpovídají hlavičkám používaným v našem systému. Stačí pak zvolit možnost vynechání prvního řádku, nastavit správné pořadí sloupců a data budou načtena správně.

Kontrola před uložením

Není nutné, aby v importovaném souboru byla kompletní data o zásilce. Je možné načíst jen částečná data, ta potom doplnit ve formuláři a zásilku uložit. Naopak pokud jsou Vaše data v importovaném souboru kompletní a správná, je možné zásilky uložit bez potvrzování.


Ukázkový .csv soubor ke stažení

Přehled možných sloupců a jejich hlaviček

Hlavička Název Popis
transport_service Přepravní služba Služba, pomocí které bude zásilka odeslána. Zadává se alias služby. Momentálně přípustné hodnoty jsou: "ulozenka", "ulozenka_parcelshop", "ulozenka_partner", "skpost_default", "dpd_private", "dpd_classic", "cpost_dr", "cpost_np", "ulozenka_b2c", "depo".
address_state Stát Třímístný kód státu, do kterého má být zásilka doručena. Např. "CZE", "SVK". Povinná hodnota u služby "doručení na adresu".Není povinnou hodnotou, pokud je vyplněn sloupček "destination_branch". Automaticky se vezme stát, ve kterém se nachází zvolená pobočka pro vyzvednutí zásilky.
register_branch Podatelna Pobočka, na které bude zásilka podána. Zadává se zkratka pobočky. Např. "pha4", "brno2". Zkratky poboček lze zjistit v nastavení e-shopu v sekci "Využívané pobočky". Pokud není podatelna vyplněna, bere se automaticky výchozí podatelna, kterou máte nastavenou v nastavení svého obchodu.
destination_branch Pobočka pro vyzvednutí Pobočka, na které bude zásilka vyzvednuta. Zadává se zkratka pobočky. Např.: "pha4", "brno2". Zkratky poboček lze zjistit v nastavení e-shopu v sekci "Využívané pobočky".
order_number Číslo objednávky Vaše číslo objednávky. Např. číslo objednávky generované Vaším systémem.
parcel_count Počet balíků Počet balíků zásilky.
cash_on_delivery Dobírka Výše dobírky.
currency Měna Měna dobírky nebo pojištění.
password Heslo Heslo, které má být vyžadováno pro vydání zásilky.
variable Variabilní symbol Variabilní symbol, pod kterým bude zaslána platba, pokud se jedná o zásilku s dobírkou.
customer_name Jméno Jméno příjemce.
customer_surname Příjmení Příjmení příjemce.
company_name Název společnosti Název společnosti příjemce.
customer_phone Telefon Telefonní číslo příjemce.
customer_email Email E-mailová adresa příjemce.
address_street Ulice Ulice příjemce. Pro doručení na soukromou adresu.
address_town Město Město příjemce. Pro doručení na soukromou adresu.
address_zip PSČ PSČ příjemce. Pro doručení na soukromou adresu.
insurance Pojištění Výše pojištění zásilky.
weight Váha Váha zásilky.
allow_card_payment Povolit platbu kartou Povolení platbu kartou při převzetí zásilky na pobočce.
require_full_age Ověřit plnoletost Ověření plnoletosti před vydáním zásilky.
note Poznámka Poznámka pro účely partnera.
allow_preview Povolit prohlídku zásilky Povolení prohlídky zásilky při převzetí zásilky na pobočce.
sender_name Název odesilatele Název odesilatele použitý v notifikacích místo názvu obchodu.
parcels Číselné řady Číselné řady jednotlivých balíků v zásilce oddělené čárkou, počet musí být roven s parcels_count. Číselná řada musí být předem smluvená, jinak hodnotu nezadávejte.