Podpora pro vývojáře

Napojte ICECOLD
na svůj systém.

Chlazená přeprava, kterou zvládnete programovat. REST API, webhooky a doplňky pro e-shopy — s dokumentací, sandboxem zdarma a člověkem na druhé straně e-mailu.

  • RESTJSON + webhooky
  • Sandboxzdarma k testování
  • 4 hreakce podpory
POST /api/v1/shipments
# založení chlazené zásilky
curl -X POST https://it.icecoldtrans.cz/api/v1/shipments \
  -H "Authorization: Bearer $ICECOLD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "reference": "OBJ-2026-1184",
        "mode": "chilled",
        "date": "2026-11-24",
        "window": "08:00-12:00",
        "pieces": 3 }'
201 Created application/json
{
  "number": "ICE-2619-4471",
  "status": "planned",
  "mode": "chilled",
  "label_url": "…/label.pdf",
  "tracking_url": "…/tracking/ICE-2619-4471"
}
1 pracovní den typická doba napojení e-shopu
15 minut interval importu objednávek
60 sekund doručení webhooku
100 × 150 mm štítek přímo z objednávky

Kudy do toho

Vyberte si,
jak se napojíte.

Ať máte vlastní systém, e-shop na Shoptetu nebo WordPress, jde to stejnou cestou: objednávka, štítek, teplota a stav doručení na jednom místě.

REST API 01

ICECOLD API v1

Zásilky, štítky, teplotní protokol i stavy přes jedno JSON API. Autentizace tokenem, idempotentní požadavky a webhooky.

  • Zásilky a štítky
  • Teploty 1–5 °C a −18 °C
  • Sandbox zdarma
Dokumentace API
SANDBOX 02

Testovací prostředí

Vyzkoušejte celé napojení bez dopadu na ostrý provoz. Fiktivní zásilky, vlastní klíč a reset dat kdykoli během vývoje.

  • Data se mažou po 30 dnech
  • Stejné endpointy jako produkce
  • Bez poplatku
Jak začít v sandboxu
DOPLŇKY 03

Doplňky pro e-shopy

Shoptet, Upgates a WooCommerce. Doprava se nabídne v košíku, štítek vytisknete z detailu objednávky a stav se vrátí zpět.

  • Instalace do 1 dne
  • Import každých 15 minut
  • Bez zásahu do šablony
Manuály k doplňkům
WEBHOOKY 04

Události v reálném čase

Naloženo, doručeno, zpožděno nebo teplotní odchylka. Podepsané požadavky s opakováním doručení a přehledem v portálu.

  • HMAC-SHA256 podpis
  • Opakování 5× s odstupem
  • Doručení do 60 sekund
Seznam událostí

REST API v1

Pár endpointů
a jede se.

Zásilku založíte jedním POSTem, štítek stáhnete jako PDF a stavy dostanete webhookem. Všechno ostatní je v referenci.

const res = await fetch('https://it.icecoldtrans.cz/api/v1/shipments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ICECOLD_TOKEN}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'obj-2026-1184',
  },
  body: JSON.stringify({
    reference: 'OBJ-2026-1184',
    mode: 'chilled',
    date: '2026-11-24',
    window: '08:00-12:00',
    pieces: 3,
    weight: 12.4,
    delivery: {
      name: 'Petra Dvořáková',
      street: 'Vršovická 1184/32',
      city: 'Praha 10',
      zip: '100 00',
      phone: '+420604118972',
    },
  }),
});

if (!res.ok) throw new Error(`ICECOLD API: ${res.status}`);
const shipment = await res.json();
console.log(shipment.number, shipment.tracking_url);

Kompletní ukázky včetně odpovědí a hlaviček najdete v rychlém startu.

Novinky z IT

Co se změnilo
v API a doplňcích.

Nové endpointy, verze doplňků a změny, které je potřeba stihnout. Nic důležitého neprojde bez e-mailu na adresu u vašeho klíče.

API

Nový endpoint pro teplotní protokol

GET /shipments/{number}/temperatures vrací celý záznam z přepravy — jednotlivá měření, odchylky i čas doručení. Hodí se pro automatické párování s HACCP deníkem.

Přejít na endpoint
Doplňky

Doplněk pro WooCommerce 1.4

Objednávka teď unese chlazené i mražené zboží v jedné zásilce díky dvěma teplotním zónám. Přibyl také dávkový tisk štítků z přehledu objednávek.

Manuál WooCommerce
Webhooky

Podpisy webhooků budou povinné

Od 1. prosince 2026 musí každý požadavek projít ověřením hlavičky X-ICECOLD-Signature. Integrace bez ověření přestanou události dostávat. Ukázka ověření je v dokumentaci.

Jak ověřit podpis

Podpora pro vývojáře

Když se to zasekne,
ozve se člověk.

Žádný ticket na týden. Napíšete, co se děje, přiložíte číslo zásilky a ozveme se do čtyř hodin v pracovní době.

Jak získám API klíč?

Napište na it@icecoldtrans.cz nebo zavolejte. Do sandboxu dostanete klíč obratem a zdarma, produkční klíč vystavíme po krátkém ověření firmy a účelu integrace — obvykle tentýž pracovní den.

Je sandbox zdarma a jak dlouho v něm data vydrží?

Ano, sandbox je bez poplatku a bez omezení počtu zásilek. Testovací data mažeme po 30 dnech nečinnosti, klíč zůstává platný. Prostředí se nikdy nepropisuje do ostrého provozu.

Jaké formáty podporujete?

JSON přes REST API, PDF pro štítky a teplotní protokoly, CSV a XML pro dávkový import i export stavů. Štítek má rozměr 100 × 150 mm a je připravený pro termotisk.

Jak rychle se změna stavu projeví v mém systému?

Webhook dorazí do 60 sekund od události. Pokud webhooky neodebíráte, je tu polling — seznam zásilek vrací aktuální stav kdykoli a doplňky e-shopů importují každých 15 minut.

Mám vlastní systém, ne e-shop. Půjde to napojit?

Ano. REST API je navržené obecně — potřebujete jen odesílat zásilky a přijímat stavy. Pro dávkové zpracování nabízíme CSV/XML přes SFTP a při mapování stavů vám pomůžeme.

Kde zjistím plánovanou odstávku nebo výpadek?

Plánované odstávky hlásíme e-mailem na adresy uvedené u API klíče nejméně 3 dny předem. Neplánovaný výpadek potvrdíme na it@icecoldtrans.cz, případně telefonicky na +420 778 112 340.

Sandbox je zdarma

Vyzkoušejte to ještě dnes.

Napište nám, co potřebujete napojit. Do konce pracovního dne dostanete přístup do sandboxu a první ukázkové volání.