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
Podpora pro vývojáře
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.
# 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 }'
{
"number": "ICE-2619-4471",
"status": "planned",
"mode": "chilled",
"label_url": "…/label.pdf",
"tracking_url": "…/tracking/ICE-2619-4471"
}
Kudy do toho
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ě.
Zásilky, štítky, teplotní protokol i stavy přes jedno JSON API. Autentizace tokenem, idempotentní požadavky a webhooky.
Vyzkoušejte celé napojení bez dopadu na ostrý provoz. Fiktivní zásilky, vlastní klíč a reset dat kdykoli během vývoje.
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.
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.
Manuály k implementacím
U každého nástroje najdete postup krok za krokem, povinná pole a co se stane, když něco nesedí. Nezačínáte na zelené louce.
Kompletní reference endpointů, autentizace, odpovědí a chybových stavů.
Otevřít referenciUdálosti, ověření podpisu, opakování doručení a ruční přehrání v portálu.
Pravidla doručeníDoplněk ICECOLD v administraci e-shopu. Doprava v košíku, cena z váhy a PSČ.
Manuál ShoptetModul dopravy s napojením na API, dopravní pravidla a vlastní zóny.
Manuál UpgatesPlugin pro WordPress včetně teplotních režimů a časových oken v dopravě.
Manuál WooCommerceDávkový import objednávek z libovolného systému a zpětný export stavů.
Manuál importuREST API v1
Zásilku založíte jedním POSTem, štítek stáhnete jako PDF a stavy dostanete webhookem. Všechno ostatní je v referenci.
/shipments
Založí zásilku a vrátí číslo ICE-XXXX-XXXX
/shipments
Seznam zásilek s filtry stavu a data
/shipments/{number}
Detail zásilky včetně časové osy
/shipments/{number}/label
Štítek 100 × 150 mm v PDF
/shipments/{number}/temperatures
Teplotní protokol z přepravy
/tracking/{number}
Veřejné sledování zásilky bez klíče
/webhooks
Registrace odběru událostí
https://it.icecoldtrans.cz/sandbox/v1
curl -X POST https://it.icecoldtrans.cz/api/v1/shipments \
-H "Authorization: Bearer $ICECOLD_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: obj-2026-1184" \
-d '{
"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"
}
}'
<?php
$payload = [
'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',
],
];
$ch = curl_init('https://it.icecoldtrans.cz/api/v1/shipments');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('ICECOLD_TOKEN'),
'Content-Type: application/json',
'Idempotency-Key: obj-2026-1184',
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);
$response = json_decode((string) curl_exec($ch), true, 512, JSON_THROW_ON_ERROR);
echo $response['number']; // ICE-2619-4471
echo $response['label_url']; // PDF štítek 100 × 150 mm
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
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.
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 endpointObjedná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 WooCommerceOd 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 podpisPodpora pro vývojáře
Žá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ě.
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.
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.
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.
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.
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.
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
Napište nám, co potřebujete napojit. Do konce pracovního dne dostanete přístup do sandboxu a první ukázkové volání.