Číselníky přepravců a služeb Verze: 1.20; 2020-10-22

Níže naleznete přehled všech identifikátorů využívaných ve Foxdeli.

Identifikátory využijete při práci s API a CSV importem zásilek pro označení přepravce, přepravní služby či doplňkové služby. Více informací o CSV importech naleznete zde.

Jedna API - mnoho přepravců

Naše API metody sjednocují všechny přepravce do jednoho systému. Využití různých přepravců a jejich služeb je řešeno pouze změnou klíčů a čísel, které naleznete na této stránce.

Identifikátory přepravců

Identifikátor se zasílá v požadavcích v poli agent. Konkrétní specifikace služeb je níže.

Identifikátor agentPřepravcePodrobnosti k přepravci
ČPČeská pošta
BAL_GLSBalíkonoš - GLSGLS přes službu Balíkonoš
BAL_ITBalíkonoš - InTimeInTime přes službu Balíkonoš
BAL_MESBalíkonoš - MessengerMessenger přes službu Balíkonoš
BAL_TNTBalíkonoš - TNTTNT přes službu Balíkonoš
DPDDPD
GEISGEIS
GLSGLS
ITInTime
MESMessenger
PBHPošta bez hranic
PPLPPL ČR
TNTTNT
ULOUloženka
ZASZásilkovna

Identifikátory přepravních služeb

Identifikátor se zasílá v požadavcích v poli deliveryType (camel case).

PřepravceIdentifkátor služby deliveryTypeSlužbaInfo
Česká poštaNBBalík do balíkovny
DRBalík do ruky
NPBalík na poštu
BBCenný balík
DEDo ruky + garantovaný čas
BADoporučený balíček
RRObchodní psaní
Balíkonoš - GLSBPBusiness ParcelPoslání na adresu příjemce
GCParcelShop Česká republika
GHParcelShop Maďarsko
GSParcelShop Slovensko
Balíkonoš - InTimeHDHome Delivery
Balíkonoš - MessengerEPExpress (60 min)
ETExtreme (30 min)
OCOvernight Economy
SDSame Day
STStandard (120 min)
DPDDJAir ExpressLetecky
DQClassic
DXExpress 10:00
DZExpress 12:00
DKExpress 18:00
DCPickup Česká Republika
DBPickup Belgie
DEPickup Estonsko
DFPickup Francie
DHPickup Holandsko
DVPickup Litva
DLPickup Lotyšsko
DUPickup Lucembursko
DDPickup Německo
DPPickup Polsko
DOPickup Portugalsko
DAPickup Rakousko
DSPickup Slovensko
DNPickup Španělsko
DYPickup Švýcarsko
DGPickup Velká Británie
DWPrivate
DMPneuPovinná volba pro zasílání pneumatik
GEISPSParcel - na soukromou adresuSoukromé zásilky (B2C) 1]
PFParcelFiremní zásilky
PDParcel - doručení do 12 hodinDoručení do do 12h další den 2]
PGParcel - garantované doručeníDoručení následující pracovní den (pouze ČR)
CZParcel Point - Česká republikaDoručení na odběrné místo v ČR 3]
SKParcel Point - SlovenskoDoručení na odběrné místo na Slovensku 3]
PLParcel Point - PolskoDoručení na odběrné místo v Polsku 3]
CSCargo - na soukromou adresuPosílání palet, apod. 1]
CFCargoCargo Firemní zásilky
1] Soukromé zásilky (B2C) pro fyzické osoby, Je vyžadován telefon příjemce.
2] Pouze pro konkrétní rozsah PSČ.
3] Musí bt vzplněna kontaktní osoba, telefonní číslo příjemce (s +420 nebo +421). Pouze jednobalíkové zásilky do váhy 15kg.
GLSBPBusiness ParcelPoslání na adresu příjemce
GCParcelShop Česká republika
GHParcelShop Maďarsko
GSParcelShop Slovensko
InTimeHDHome Delivery
MessengerEPExpress (60 min)
ETExtreme (30 min)
OCOvernight Economy
SDSame Day
STStandard (120 min)
Pošta Bez HranicBHBelgie - DHL
BRBelgie - DPD
BQBulharsko - DHL
BCBulharsko - eCont
BVBulharsko - Speedy / Automat
BSBulharsko - Speedy / Na adresu
BUBulharsko - Speedy / Parcelshop
CRČeská republika - Česká pošta / Do ruky
CNČeská republika - Česká pošta / Na Poštu
CPČeská republika - PPL
CHChorvatsko - DPD
DHDánsko - DHL
DPDánsko - DPD
EDEstonsko - DPD
FHFinsko - DHL
FIFinsko - DPD
FCFrancie - Colissimo
DFFrancie - DHL
FDFrancie - DPD
IRIrsko - DPD
IHIrsko, Estonsko, Litva, Lotyšsko - DHL
IDItálie - DHL
IPItálie - DPD
LDLitva - DPD
LPLotyšsko - DPD
LULucembursko - DPD
MMMaďarská pošta
MDMaďarsko - DPD
MAMaďarsko - Hungarian Post / Automaty
MPMaďarsko - Hungarian Post / Na poštu
MVMaďarsko - Hungarian Post / Výdejní místa
PTMaďarsko - Transoflex
NQNěmecko - DHL - Packstation
NSNěmecko - DHL - Postfiliale
NDNěmecko - DHL
NPNěmecko - DPD
NTNěmecko - trans-o-flex
NHNizozemí - DHL
NRNizozemí - DPD
PEPolsko - DPD
PKPolsko - InPost Kurier
PCPolsko - Paczkomaty
PRPolsko - Poczta Polska
PGPortugalsko - DHL
PDPortugalsko - DPD
RSRakousko - DPD
PQRakousko - Rakouská pošta
AARakousko - Rakouská pošta / Automaty
APRakousko - Rakouská pošta / Na poštu
RDŘecko - DPD
RCRumunsko - Cargus
RTRumunsko - FAN - CollectPoint
RFRumunsko - FAN - eBox
RZRumunsko - FAN - na adresu
SASlovensko - automaticky
SSSlovensko - Slovenská pošta
SPSlovensko - Slovenská pošta / Balík na poštu
SBSlovensko - Slovenská pošta / Balíkobox
SUSlovensko - SPS (UPS)
SWSlovensko - SPS (UPS) / Parcel Shop
SLSlovinsko - DPD
SCŠpanělsko - Correos
SDŠpanělsko - DHL
SNŠpanělsko - DPD
SHŠvédsko - DHL
SVŠvédsko - DPD
UMUkrajina - Meest
UNUkrajina - Nova Poshta
CDVelká Británie - DHL
VDVelká Brítánie - DPD
VHVelká Británie - Hermes
PPLEBParcel Connest
FBParcel CZ Business
SBParcel CZ Private
TNTECEconomy Express
EPExpress
EDExpress dokumenty
UloženkaUDDPD Pickup
ULUloženka
UPUloženka Partner
Zásilkovna BLBelgie - BE Post
BUBulharsko - Speedy Home
BSBulharsko - Speedy Office
CPČeská pošta
XBČeská republika - Expresní doručení Brno
XOČeská republika - Expresní doručení Ostrava
XPČeská republika - Expresní doručení Praha
CTČeská republika - InTime
CNČeská republika - nejvýhodnější doručení na adresu
CDČeská republika DPD
CAChorvatsko - Chorvatská Pošta - na adresu
HRChorvatsko - Chorvatská pošta VM
CVChorvatsko - DPD Home
DSDánsko - Post Nord Home
DKDánsko - Post Nord PP
EREstonsko - MRW Home
EBEstonsko - Omniva Box
EHEstonsko - Omniva Home
EPEstonsko - Omniva Pickup
FNFinsko - Post Nord Home
FIFinsko - Post Nord PP
FCFrancie - Colissimo Home
NPHolandsko - NL Post
IHIrsko - Hermes
IGItálie - GLS
LTLitva - Omniva Box
LBLotyšsko - Omniva Box
LHLotyšsko - Omniva Home
LDLucembursko - DPD
MPMaďarská pošta
HQMaďarsko - nejvýhodnější doručení
MDMaďarsko DPD
MTMaďarsko Express One (Transoflex)
DPNěmecká pošta
DRNěmecko - Hermes
DONěmecko - Hermes Home
DHNěmecko - Hermes Pickup
PPPolská pošta
POPolská pošta 24h
PIPolsko - InPost
PQPolsko - nejvýhodnější doručení
PAPolsko - Paczkomaty
PDPolsko DPD
PRPortugalsko - MRW Home
RPRakouská pošta
GSRecko - Speedy Home
RCRumunsko - Cargus
RQRumunsko - nejvýhodnější doručení
RDRumunsko DPD
RFRumunsko FAN
RERusko - Post EMS
RARusko - Post Registered Packet
RURusko - Ruská pošta
SPSlovenská pošta
DASlovensko - automaticky
XSSlovensko - Expresné doručenie Bratislava
SKSlovensko GLS
SDSlovinsko - DPD Home
SUSlovinsko - DPD Pickup
SCŠpanělsko - Correos
AHSpojené království - Hermes
AASpojené království - Royal Mail 24
ABSpojené království - Royal Mail 48
RMSpojené království Royal Mail
USSpojené státy americké - USA Post
SNŠvédsko - Post Nord Home
SEŠvédsko - Post Nord PP
SLŠvýcarsko-Lichtejnštejnská Pošta
SVŠvýcarsko-Lichtenštejnská Pošta - prioritní
UNUkrajina - Nova Poshta
URUkrajina - Rosan
VMVýdejní místa Zásilkovny

Identifikátory doplňkových služeb

Identifikátor se zasílá v požadavcích v kontejneru extraServices a poli code.

Některé doplňkové služby vyžadují vyplnění dalších údajů k zásilce nebo jejich doplnění v požadavku do kontejneru extraServices a do pole arguments.

Seznam služeb a povinných argumentů je v následující tabulce. Podpora přepravců pro jednotlivé služby je v další tabulce.

Seznam veškerých služeb nabízených systémem Foxdeli

Identifikátor služby extraServices.codePopis službyPovinné položky u zásilkyVyžadované argumenty extraServices.arguments.*
Služby avízace:
email_advice_unloadEmail avízo PŘED doručením zásilkyemail - Email
email_advice_loadEmail avízo PO vyzvednutí zásilkyemail - Email
sms_advice_unloadSMS avízo PŘED doručením zásilkyphone - Telefon (+420 XXX XXX XXX)
sms_advice_loadSMS avízo PO vyzvednutí zásilky řidičemphone - Telefon (+420 XXX XXX XXX)
call_advice_unloadAvizování PŘÍJEMCE řidičem PŘED příjezdemphone - Telefon příjemce (+420 XXX XXX XXX)
call_advice_loadAvizování ODESÍLATELE řidičem PŘED příjezdemphone - Telefon odesílatele (+420 XXX XXX XXX)
sms_preadviceSMS avizace o DORUČENÍ zásilky v předpokládaném 3-hodinovém časovém intervaluphone - Telefon odesílatele (+420 XXX XXX XXX)
sms_serviceSMS avizace o DORUČENÍ zásilky následující pracovní den.phone - Telefon odesílatele (+420 XXX XXX XXX)
advice_podDoklad o doručení (Proof of Delivery)
advice_deliveredEmail nebo SMS avízo o doručení pro odesílatele
advice_damagedEmail nebo SMS potvrzení pro odesílatele poškození zásilky
advice_undeliveredEmail nebo SMS potvrzení pro odesílatele o problematické zásilce, která nemohla být doručena
Služby pro stanovení termínu doručení:
company_deliveryDodání firmě
saturday_deliverySobotní doručení
sunday_deliveryNedělní doručení
evening_deliveryVečerní doručení
morning_deliveryDopolední doručení
afternoon_deliveryOdpolední doručení
day_definitePřesný den doručenídate - Datum ve formátu YYYY-MM-DD
guaranteed_24Garantované doručení do druhého dne
Služby ověření:
addressee_onlyDoručení pouze do rukou konkrétní osobyperson - Jméno konkrétní osoby
authenticationOvěření totožnosti - Kurýr předá zásilku adresátovi až po předložení OP, ŘP nebo pasunote - Poznámka
full_ageOvěření plnoletosti
signatureDoručení proti podpisu
Ostatní doplňkové služby:
think_greenEkologická přeprava
exchange_deliveryVýměnná zásilka. Současně při doručení zásilky vyzvednutí druhé zásilky a doručení k Vám zpět. Bez vyzvednutí druhé zásilky nebude příjemci první zásilka předána (vhodné např. u reklamací či zapůjčeného zboží).note - Poznámka
documents_backDokumenty zpět. Speciální řešení, je-li třeba nechat adresátem potvrdit dokument, který doprovází zásilku, a doručit ho zpět odesílateli.note - Poznámka
carryDonos
lossOdnos
insurancePřipojištění (nad rámec základu)Hodnota zásilky + měna hodnotyČástka pro výši připojištění se bere z hodnoty zásilky
(Musí být vyplněny pole value + valueCurrency)
priorityPřednostní manipulace
fragilePozor křehké
credit_cardPlatba kartou
previewProhlídka zboží
test_before_paymentVyzkoušení před převzetím
Implicitní doplňkové služby, které se vytvoří automaticky dle parametrů zásilky: Tyto služby se nezadávají v requestech.
codDobírkaDobírková částka + měna dobírky(Musí být vyplněny pole cod + codCurrency)
back_deliveryZpětná zásilka. Každá zásilka, která je posílána z adresy na svozové místo je automaticky označena jako zpětná zásilka.
U tohoto typu zásilek nelze tisknout štítky.
direct_deliveryPřímá zásilka. Každá zásilka, která je posílána z adresy na adresu (mimo Vaše svozové místo) je automaticky označena jako přímá zásilka.

Podpora přepravců pro jednotlivé služby

Každý přepravce má svá specifika a ty se vztahují i na doplňkové služby. Tabulka zobrazuje jaké služby konkrétní přepravce nabízí.

V případě API požadavků, které budou žádat o u daného přepravce o službu, kterou nepodporuje, bude vrácena odpověď s neúspěchem.

Identifikátor službyČeská poštaBalíkonoš - GLSBalíkonoš - InTimeBalíkonoš - MessengerBalíkonoš - TNTDPDGEISGLSInTimeMessengerPošta bez hranicPPL ČRTNTUloženkaZásilkovna
email_advice_unload
email_advice_load
sms_advice_unload
sms_advice_load
call_advice_unload
call_advice_load
sms_preadvice
sms_service
advice_pod
advice_delivered
advice_damaged
advice_undelivered
company_delivery
saturday_delivery
sunday_delivery
evening_delivery
morning_delivery
afternoon_delivery
day_definite
guaranteed_24
addressee_only
authentication
full_age
signature
think_green
exchange_delivery
documents_back
carry
loss
insurance
priority
fragile
credit_card
preview
test_before_payment

Track & Trace

Níže naleznete přehled všech identifikátorů využívaných ve Foxdeli. Identifikátory využijete při práci s API a CSV importem zásilek pro označení přepravce, přepravní služby či doplňkové služby.
Více informací o CSV importech naleznete zde.

Stavy zásilek Track and Trace

Foxdeli sjednocuje stavy přepravců do vlastního číselníků o třech úrovních. Každá úroveň nabízí jinou hloubku detailu podle, které se dá určit v jaké fázi se zásilka nachází.

  • category - Hlavní kategorie stavu. Hodnota reflektuje sekci přehledu zásilek v aplikaci Foxdeli.
  • subCategory - Přesnější detail stavu hlavní kategorie
  • state - Aktuální přesný stav zásilky v největším detailu

categorysubCategorystateNázev kategorieInfo
Stavy (Foxdeli a API V3+V4):
11_01_0_0RozpracovanéNově vytvořená zásilka (manuálně nebo metodou deliveries/POST), která ještě není uzavřená.
22_02_0_0K odesláníUzavřené zásilky (manuálně nebo metodou deliveries/PATCH), které prozatím nebyly předány kurýrovi.
33_03_0_0OdeslanéZásilky převzaté kurýrem. K tomuto stavu dojde automaticky ihned po obdržení informace ze systému přepravce.
33_13_1_0Doručované
33_13_1_1Předáno přepravci
33_13_1_2Na doručení dnesU některých přepravců obsahuje text časové okno doručení zásilky
33_13_1_3Na cestě
33_13_1_4K vyzvednutí
33_13_1_5Poslední den uloženíUpozornění, že zítra je poslední den kdy bude zásilka uložena k vyzvednutí
33_23_2_0S výhradou přepravce
33_23_2_1Odmítnuto do přepravy
33_23_2_2Porucha
33_23_2_3Časové důvody
33_23_2_4Vyšší moc
33_23_2_5Ostatní
33_23_2_6Poškozeno
33_33_3_0S výhradou adresáta
33_33_3_1Odmítnuto převzetí
33_33_3_2Nesprávná adresa
33_23_3_3Nezastižen
33_33_3_4Změna dispozic
33_33_3_5Vracející se
33_33_3_6Ostatní
44_04_0_0Doručené
55_05_0_0Nedoručené
55_15_1_0Vráceno
55_25_2_0Nedoručeno
55_25_3_0Ztraceno
66_06_0_0Zrušené
Flagy 1]:
flagimportantDůležité 2]Zásilky, které vyžadují pozornost jsou označeny příznakem Důležité.
flagdelayedV prodlení 2]
flagnotDelivered2DaysMírně zpožděné doručení
flagnotDelivered3DaysZpožděné doručení
flagnotPickedUp3DaysNevyzvednuto ≥ 3 dny
flagnotPickedUp5DaysNevyzvednuto ≥ 5 dnů

Takto jsou označené stavy, které nemohou nastat

Takto jsou označené hlavní stavy

Takto jsou označené příznaky (Flagy)

1] Flag - jedná se o příznak, který je přiřazen k zásilce na základě kriterií, která jsou specifická pro konkrétního pžřepravce (například doba doručování je delší než je u daného přepravce běžné).
Flagy jsou dodatečnou informací a mohou se prolínat napříč různými stavy zásilky.

2] Flagy Důležité a V prodlení nejsou nabízeny v metodě deliveries/traces/GET, protože se jedná o flagy související přímo se zásilkou. Ostatní flagy se v dané mětodě používají.

Specifikace pro tisk štítků

Z API Foxdeli lze získávat štítky řepravců ve třech formátech:

  1. PDF samostatně - Každý štítek má v PDF vlastní stránku v přesně specifikovaných rozměrech. PDF může mít více štítků.
  2. ZPL samostatně - Každý štítek má vlastní datový soubor.
  3. PDF na arch (A4) - Štítky jsou rozmístěny vedle sebe na arch A4 ve zvoleném pořadí s možností zvolit počáteční pozici (0-4).
Více informací o metodách pro získání štítku k zásilkám získáte v API referenci tickets/GET a zpl/GET

Rozměry štítků

U některých přepravců je možnost volby velikosti a DPI vráceného formátu v datovém souboru.

Přepravci, kteří nejsou uvedení v tabulce nepodporují tisk štítků nebo není integrován ve Foxdeli.

PřepravceFormát1]Rozměr (ZPL)2]DPI3]Arch A4 (PDF)4]Rozměr5]Orientace6]Info
Česká poštaPDF, ZPL10x173004A6 105x148Na šířku
IntimePDF, ZPL8x53008A7 105x74Na šířku
ZásilkovnaPDF, ZPL10x173004A6 105x148Na šířku 7]
UloženkaPDF, ZPL10x173004A6 105x148Na výšku
PPLPDF4A6 105x148Na šířku 8]
Balíkonoš - IntimePDF, ZPL8x53008A7 105x74Na šířku
Pošta bez hranicPDF, ZPL10x143004A6 105x148Na výšku
DPDPDF, ZPL10x53004A6 105x148Na výšku
GEISPDF, ZPL10x153004A6 105x148Na šířku
GLSPDF, ZPL10x5, 10x173004A8 74x52, A6 105x148Na šířku 9]
Balíkonoš - GLSPDF, ZPL10x5, 10x173004A8 74x52, A6 105x148Na šířku 9]

Vysvětlivky

1] Podporované formáty pro tisk přes API a Foxdeli aplikaci.

2] Podporované rozměry pro tisk ZPL šítků. Klíč se použije pro parametr size v GET metodě. První rozměr v pořadí je vždy výchozí hodnota.

3] Rozlišení DPI pro ZPL štítky. Pokud budete tisknout přes tiskárnu na které bude nastaveno DPI 200, tak štítky budou větší.

4] Počet štítků, které se vejdou na arch velikosti A4.

5] Originální rozměr štítku přepravce.

6] Orientace štítku přepravce (na výšku, na šířku)

7] Aktuálně umožňujeme tisk štítků velikosti A6 (4ks na A4 při PDF tisku), přestože rozměr štítku je cca 93mm x 55mm a vejde se do A7. Podporu tisku A7 štítků (8 ks na arch A4) do PDF připravujeme.

8] U přepravce PPL nepodporujeme tisk ZPL štítků. Tisk nových SmartLabel připravujeme.

8] Klíč 10x5 vyvolá ZPL pro rozměry štítku velikosti 74x52mm a klíč 10x17 rozměry 105x148mm (Klíče uplně neodpovídají rozměrům neboť se jedná o zachování kompatibility s dřívější verzí API).

Upozornění

Prosíme berte na vědomí, že u některých typů zásilek nelze tisknout štítky. Jedná se například o přímé zásilky (posílané z adresy na adresu) a zpětné zásilky (posílané z adresy na svozové místo).

Podporované tiskárny - v přípravě

Zde jsou tiskárny našich klientů, kteří využívají online tisk štítků přes aplikaci Foxdeli.

Pokud máte tiskárnu fungující s Foxdeli aplikací, která není na seznamu, budeme rádi, pokud se s námi podělíte o Vaše zkušenosti.

ZnačkaModelInformace
BrotherXXAYTisk 10x15

Sekci o tiskárnách štítků připravujeme