Manuály k implementacím

Napojení krok za krokem

Shoptet, Upgates, WooCommerce i vlastní systém. Vždy stejným výsledkem: objednávka, štítek, teplota a stav doručení na jednom místě.

Společný postup

Čtyři kroky
a jste v provozu.

Nemusíte nic programovat ani měnit šablonu e-shopu. Projdeme spolu autorizaci, mapování dopravy a testovací objednávku — pak se jede naostro.

  1. 01

    Získáte klíč

    Sandboxový token dostanete obratem, produkční po krátkém ověření firmy. Klíč patří na server, nikdy do prohlížeče.

  2. 02

    Namapujete dopravu

    Určíte, která doprava znamená chlazený a která mražený režim, a jak se počítá cena podle váhy a PSČ.

  3. 03

    Projdete testovací objednávku

    Zkušební nákup včetně štítku, sledování a e-mailů. Uvidíte přesně, co dostane zákazník i vy v portálu.

  4. 04

    Přepnete na produkci

    Vyměníte sandboxový token za produkční. Objednávky se importují samy, štítky tisknete jedním klikem.

Platformy

Vyberte svůj systém.

U každé platformy najdete, co instalace obnáší, jak se předávají stavy a kde se dá nejčastěji zaseknout.

01

Shoptet

Nejrychlejší cesta. Doplněk ICECOLD zapnete v administraci a doprava se objeví v košíku.

Instalace
15 minut
Import objednávek
každých 15 minut
Tisk štítků
z detailu objednávky
Vracení stavů
zpět do Shoptetu

Postup

  1. V administraci Shoptetu otevřete Doprava a platby → Dopravci a zapněte doplněk ICECOLD.
  2. Autorizujte doplněk svým účtem u ICECOLD. Do šablony e-shopu se nesahá.
  3. Určete, která doprava znamená chlazený (1–5 °C) a která mražený (−18 °C) režim, a jak se počítá cena podle váhy a PSČ.
  4. Prožeňte testovací objednávku — zkontrolujte štítek, e-mail zákazníkovi i stav v portálu.

02

Upgates

Modul dopravy s napojením na naše API. Vhodné pro e-shopy s vlastními dopravními pravidly a zónami.

Instalace
1 pracovní den
Import
API + XML feed
Tisk štítků
z detailu objednávky
Vracení stavů
webhook do Upgatesu

Postup

  1. V Upgatesu zapněte modul dopravy ICECOLD a vložte API klíč, který vám vystavíme.
  2. Namapujte dopravní metody na teplotní režimy a přiřaďte jim náš způsob dopravy.
  3. Nastavte, jak se mají párovat stavy — přiřazením stavů Upgatesu k událostem shipment.loaded a shipment.delivered.
  4. Otestujte objednávku v sandboxu a potom přepněte produkční klíč.

03

WooCommerce

Plugin pro WordPress. Teplotní režimy a časová okna nastavíte přímo v metodě dopravy.

Instalace
do hodiny
Import
REST API + webhooky
Tisk štítků
dávkově i jednotlivě
Vracení stavů
automaticky

Postup

  1. Nahrajte plugin icecold-shipping do wp-content/plugins a aktivujte ho.
  2. V nastavení dopravy vložte token a zvolte sandbox, dokud vše neotestujete.
  3. Přidejte metody „ICECOLD – chlazená 1–5 °C“ a „ICECOLD – mražená −18 °C“ a nastavte časová okna.
  4. V objednávce ověřte vytvořený štítek a příjem webhooků — stav se do WooCommerce vrací sám.

04

CSV / XML import

Pro vlastní systémy a dávkové zpracování. Soubory posíláte na SFTP, my je zpracujeme a stav vrátíme exportem.

Přenos
SFTP nebo HTTPS
Frekvence
každých 15 minut
Kódování
UTF-8, středník
Export stavů
CSV + XML

Postup

  1. Pošlete nám vzorek exportu a my připravíme mapování na naše pole.
  2. Dostanete SFTP přístup do složky in/ a výstupní složku out/ pro stavy.
  3. Nahrajte soubor ve formátu CSV nebo XML. Prázdné povinné pole znamená, že řádek přeskočíme a zapíšeme do chybového logu.
  4. Stavy si stáhnete z out/ nebo si necháte zapnout webhook — podle toho, co váš systém umí.

Formáty

Co poslat
v importu.

CSV posíláte na SFTP v UTF-8 se středníkem, XML podle naší XSD. Povinná pole jsou stejná pro oba formáty.

SloupecPovinnéFormátPoznámka
cislo_objednavkyanostringVaše reference, vrací se ve stavu.
rezimanochilled / frozenChlazený 1–5 °C nebo mražený −18 °C.
jmenoanostringPříjemce zásilky.
uliceanostringUlice a číslo.
mestoanostringMěsto doručení.
pscano123 45Ověření doručovací oblasti.
datumanoYYYY-MM-DDPožadované datum doručení.
telefonne+420…Pro avizaci příjemci.
oknone08:00-12:00Bez hodnoty přidělíme podle trasy.
kusune1–99Výchozí 1.
vaha_kgne12.4Desetinná tečka.
dobirkane0Částka v Kč, 0 znamená bez dobírky.
Řádek s chybou

Zpracujeme ostatní řádky a chybný zapíšeme do chyby.csv s důvodem. Nic se neztratí.

Zpětný export

Stavy a teploty najdete ve složce out/ každých 15 minut, nebo je dostanete webhookem.

Zabezpečení

SFTP účet je jen pro vaši firmu, přístup kdykoli zrušíme. Soubory mažeme po 14 dnech.

Technické napojení

Projdeme to spolu.

Pošlete adresu e-shopu nebo vzorek exportu. Do 24 hodin dostanete návrh napojení i odhad, kolik času zabere.