Pro korektní nastavení doprav na MALL.CZ jsou potřeba následující kroky:
- Správné a kompletní spektrum poboček Uloženky, které si pravidelně aktualizujete (pokud zásilky nezadáváte ručně přímo v systému Uloženka) – pro API napojení a aktualizaci využijte dokumentaci Uloženky ovdje, pro CSV export aktuálních poboček navštivte v portále sekci Implementace.
- Správné nastavení package_size u svých produtků na MALL.CZ (pro možnosti Uloženky nyní zatím pouze smallbox = součet tří stran 170 cm max. délka jedné strany 100 cm; max. 20 kg).
Pokud zásilky nebudou nastaveny korektně a budou nad výše uvedený rozměr, může dojít k jejich odmítnutí ze strany kurýra či výdejny a zákazníkovi nebude objednávka doručena.
- Korektní namapování transport_id vzhledem k Vašim přepravám (napojujete-li přímo svůj informační systém) z endpointu Get Transports ovdje.
- Správné vytvoření doprav:
- pro API napojení využijte Marketplace API dokumentaci pro založení dopravy
- pro napojení pomocí MALL XML, Heureka XML čiji MANUAL input využijte přístupu v MALL PORTAL v sekci Prijevoz
- transport_id pro namapování jsouv CZ 20 a 21, v SK 49 a 119
- Správné chování Vámi nastavených přeprav můžete otestovat vložením zboží do košíku a kontrolou, že se zákazníkům nabídnou výdejní místa pro Osobní odběr – viz:
- Po jejich výběru, se zákazník dostane na volbu pro nejvhodnější odběrné místo pro vyzvednutí své objednávky.
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 čárkou. 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)
UKÁZKOVÝ .CSV SOUBOR KE STAŽENÍ
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 uve- dené 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 im- portu 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í.
| Hlavička | Povinný | Typ dat | Popis |
| transport_service | Ano | STR | Služba, pomocí které bude zásilka odeslána. Zadá- vá se alias služby. Momentálně přípustné hodnoty jsou: „ulozenka“, „ulozenka_parcelshop“, „ulozen- ka_partner“, „skpost_default“, „dpd_private“, „dpd_ classic“, „cpost_dr“, „cpost_np“, „uloženka_b2c“. |
| address_state | Pro služby: ČP Balík do ruky, DPD Classic, DPD Pri- vate, SK Pošta smluvní balík s pojištěním, Uloženka do- ručení na adresu | ISO 3166-1 | Třímístný kód státu, do kterého má být zásilka doru- čena. Např. „CZE“, „SVK“. Pokud stát není vyplněn, vezme se automaticky stát, ve kterém se nachází zvolená pobočka pro vyzvednutí zásilky. |
| register_branch | Volitelný | STR | Pobočka, na které bude zásilka podána. Zadává se zkratka pobočky. Např. „pha4“, „brno2“. Zkratky po- boček lze zjistit v sekci „Implementace“. Pokud není podatelna vyplněna, bere se automaticky výchozí podatelna, kterou máte nastavenou v nastavení svého obchodu. |
| destination_branch | Pro služby: Uloženka Premium, Uloženka Partner, Uloženka Partner, DPD Pic- kup CZ a SK, ČP balík na poštu | STR | Pobočka, na které bude zásilka vyzvednuta. Za- dává se zkratka pobočky. Např.: „pha4“, „brno2“. Zkratky poboček lze zjistit v sekci „Implementace“. |
| order_number | Ano | STR | Vaše číslo objednávky. Např. číslo objednávky ge- nerované Vaším systémem. |
| partner_consignment_id | Volitelný | INT | Číslo z Vaší individuální číselné řady. Řada má formát XXXXXYYZZZZZ kde XXXXX = Id Vašeho ob- chodu v našem systému (např. 00101), YY = vzrůsta- jící číselná řada pro různá rozlišení zásilek (od 01), ZZZZZ = pořadové číslo zásilky (od 00001) |
| parcel_count | Ano | INT | Počet balíků v zásilce. Možné u služeb Uloženka Premium, Uloženka Partner, DPD Pickup CZ, DPD Private, DPD Classic, Uloženka doručení na adresu |
| cash_on_delivery | Volitelný | Number | Výše dobírky. |
| currency | Povinné, pokud je zasílán parametr cash_on_delivery, stated_price nebo insu- rance | ISO – 4217 | Měna ostatních zasílaných parametrů ve formátu ISO – 4217 (např. CZK nebo EUR). |
| password | Ne | STR | Heslo, které má být vyžadováno pro vydání zásilky. Tento parametr není třeba vyplňovat, heslo pro vy- zvednutí nastavujeme zásilkám automaticky. |
| variable | Volitelný | INT | Variabilní symbol, pod kterým bude zaslána platba, pokud se jedná o zásilku s dobírkou. |
| customer_name | Ano | STR | Jméno příjemce. |
| customer_surname | Ano | STR | Příjmení příjemce. |
| company_name | Volitelný | STR | Název společnosti příjemce. |
| customer_phone | Ano | STR | Telefonní číslo příjemce. |
| customer_email | Pro služby: Uloženka Premium, Uloženka Partner, Uloženka Partner PNS, DPD Pickup CZ a SK, ČP balík na poštu, Uloženka doručení na adresu | STR | E-mailová adresa příjemce. |
| address_street | Pro služby: ČP
Balík do ruky, DPD Classic, DPD Pri- vate, SK Pošta smluvní ba- lík s pojištěním, Uloženka doručení na adresu | STR | Ulice příjemce. Pro doručení na soukromou adresu. |
| address_town | Pro služby: ČP
Balík do ruky, DPD Classic, DPD Pri- vate, SK Pošta smluvní ba- lík s pojištěním, Uloženka doručení na adresu | STR | Město příjemce. Pro doručení na soukromou adre- su. |
| address_zip | Pro služby: ČP
Balík do ruky, DPD Classic, DPD Pri- vate, SK Pošta smluvní ba- lík s pojištěním, Uloženka doručení na adresu | STR | PSČ příjemce. Pro doručení na soukromou adresu. |
| insurance | Pro služby: SK pošta | Number | Výše pojištění zásilky. |
| weight | Pro služby: ČP
balík do ruky, ČP balík na poštu, SK pošta, Uloženka doručení na adresu | Number | Váha zásilky. |
| allow_card_payment | Volitelný pro
služby: Uloženka Premium a Uložen- ka Partner (u ostatních pře- pravců tato možnost v tuto chvíli není) | INT | Povolení platbu kartou při převzetí zásilky na pobočce. |
| require_full_age | Volitelný pro
služby: Uloženka Premium a Uložen- ka Partner (ověřit) | INT | Ověření plnoletosti před vydáním zásilky. |
| note | Volitelný | STR | Poznámka pro účely partnera. |
| allow_preview | Volitelný pro služby: Uloženka Premium | INT | Povolení prohlídky zásilky při převzetí zásilky na pobočce. |
| sender_name | Volitelný pro
služby: Uloženka Premium a Uložen- ka Partner | STR | Název odesilatele použitý v notifikacích místo ná- zvu obchodu. |