Vlastní dopravce umožňuje sledovat v Retino Tracking i zásilky, které nedoručuje žádný z podporovaných dopravců – typicky vlastní rozvoz e-shopu nebo lokální kurýr bez sledovacího API. Zásilka pak funguje jako každá jiná: vidíte ji v seznamu zásilek, v Track & Trace, v transakčních e-mailech i v analytice a můžete na ni navázat automatizace.

Pro osobní odběr na vlastních prodejnách nebo skladech použijte Vlastní pobočky; vlastní dopravce je určený pro doručování.

Poznámka: Vlastní dopravce nemá odkud stahovat stav zásilky. Stav zůstane Nová zásilka, dokud ho neaktualizujete přes API. Bez toho se nespustí automatizace navázané na doručení.

Jak to funguje

V nastavení založíte vlastního dopravce a zadáte hodnotu pro automatické párování – přesný název nebo kód dopravy, který posílá váš e-shop v objednávce.
Retino při synchronizaci objednávek porovná tuto hodnotu s položkou typu shipping v objednávce. Při shodě vytvoří zásilku pod vlastním dopravcem. Objednávka nemusí obsahovat číslo zásilky.
Stav zásilky (na cestě, doručeno, vráceno…) posílá váš systém přes Tracking API. Každý přijatý stav projde stejným zpracováním jako u ostatních dopravců, včetně e-mailů a automatizací.

Vlastních dopravců můžete mít libovolný počet, například zvlášť pro vlastní auta a zvlášť pro smluvního kurýra. Každý má vlastní název, logo, statistiky a lze podle něj filtrovat i podmínit automatizace.

Přidání vlastního dopravce

Vlastní dopravce je jednou z dlaždic při přidávání dopravce:

Dlaždice dopravců se zvýrazněnou dlaždicí Vlastní dopravce

Otevřete Nastavení → Tracking → Integrace s dopravci a klikněte na Přidat přihlašovací údaje.
Vyberte dlaždici Vlastní dopravce.
Vyplňte Název. Zobrazí se zákazníkům v Track & Trace a v e-mailech, proto použijte srozumitelné označení, například Rozvoz Praha.
Volitelně nahrajte Logo (PNG, JPG, GIF nebo WebP). Bez loga se použije obecná ikona.
Do pole Automatické párování zadejte hodnotu, kterou váš e-shop posílá u dopravy v objednávce – název, kód nebo ID položky.
Klikněte na Test. Retino prohledá objednávky za posledních 30 dní a ukáže, zda hodnota odpovídá některé objednávce.
Uložte.

Formulář Přidat vlastního dopravce s vyplněným názvem, hodnotou párování a úspěšným výsledkem testu

Dopravce se zobrazí v seznamu aktivních dopravců. Odtud ho můžete kdykoli upravit nebo smazat; u smazaného dopravce zůstávají existující zásilky zachované.

Pravidla párování

Přesná shoda. Hodnota se porovnává celá, včetně velikosti písmen a diakritiky. Rozvoz Praha nenajde položku rozvoz praha.
Kde se hledá. V názvu, kódu a ID položky typu shipping v objednávce. Stačí shoda v jednom z těchto polí.
Přednost před číslem zásilky. Když objednávka odpovídá vlastnímu dopravci, vytvoří se zásilka pod ním i v případě, že objednávka obsahuje číslo zásilky.
Jedna hodnota = jeden dopravce. Stejnou párovací hodnotu nelze použít u dvou vlastních dopravců.
Nové a změněné objednávky. Párování probíhá při synchronizaci objednávek. Objednávky zpracované před založením dopravce se napárují až při další změně v e-shopu.

Jak Retino načítá objednávky a jejich položky, popisuje článek Objednávková integrace.

Aktualizace stavu zásilky přes API

Stav zásilky vlastního dopravce posílá váš systém (WMS, dispečink, ERP) na endpoint POST /api/v2/tracking-shipping/{id}/status/. Autorizace je stejná jako u ostatních volání Tracking API.

1. Najděte ID zásilky

Zásilku vyhledejte podle čísla objednávky a dopravce CUSTOM:

GET /api/v2/tracking-shipping/?order_code=OBJ-2025-001&carrier=CUSTOM

Odpověď obsahuje id zásilky a pole custom_carrier s ID a názvem vlastního dopravce. Číslo zásilky (tracking_number) Retino generuje samo a zákazníkům ho nezobrazuje.

2. Odešlete stav

POST /api/v2/tracking-shipping/550e8400-e29b-41d4-a716-446655440000/status/Authorization: váš_api_tokenContent-Type: application/json{  "status": "DELIVERED",  "status_at": "2026-03-12T14:05:00+01:00",  "external_status_description": "Předáno zákazníkovi na pobočce"}

Pole	Význam
`status` (povinné)	Nový stav zásilky, například `IN_TRANSIT`, `OUT_FOR_DELIVERY`, `AVAILABLE_FOR_PICKUP`, `DELIVERED`, `FAILED_ATTEMPT`, `RETURNED_TO_SENDER`. Interní stavy `PENDING__*` nelze poslat.
`status_at`	Kdy ke změně došlo. Nesmí být v budoucnosti ani starší než poslední stav zásilky. Bez hodnoty se použije čas přijetí.
`external_status_code`	Kód stavu z vašeho systému. Uloží se do historie zásilky.
`external_status_description`	Popis pro historii zásilky.

Úplný seznam stavů a jejich význam najdete v článku Stavy zásilek. Aby fungovaly e-maily o doručení a hodnocení doručení, posílejte alespoň DELIVERED.

Endpoint vrátí aktualizovanou zásilku. Stejný stav se stejným popisem a časem se podruhé neuloží, opakované odeslání je tedy bezpečné. Stavy posílejte v pořadí, v jakém nastaly – stav starší než poslední stav zásilky endpoint odmítne chybou 400. Chybu 400 vrátí také u zásilky, která nepatří vlastnímu dopravci; stavy u podporovaných dopravců spravuje Retino samo.

Omezení

Zásilka vlastního dopravce nemá odkaz na sledování u dopravce ani číslo zásilky pro zákazníka. V Track & Trace se zobrazí název, logo a historie stavů.
U stavu Připraveno k vyzvednutí Retino nepočítá lhůtu úložní doby; není z čeho ji odvodit.
Dopravce zásilky nelze ručně změnit na vlastního dopravce ani z něj na jiného. Zásilka vzniká jen párováním při synchronizaci objednávek.
Zásilky vlastního dopravce se u dopravce nesynchronizují: v detailu zásilky chybí tlačítko Synchronizovat a hromadná akce Synchronizovat je vynechá s upozorněním. Stav se mění jen přes API.
Vlastní dopravce nemá nastavení přepravní doby ani analýzu nákladů.

Související články