Číselníky přepravců a služeb Verze: 1.71; 2022-04-21
Níže naleznete přehled všech identifikátorů využívaných ve Štíteknabalík.cz.
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.
Automatizované číselníky
Potřebujete automatizovaně aktualizovat Vaše číselníky? Není problém. K dispozici máme metody pro získání podporovaných přepravců, přepravních služeb, doplňkových služeb a dalších. Viz metody list.
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 agent | Přepravce | Štítky | Protokoly | Podrobnosti k přepravci |
|---|---|---|---|---|
| ČP | Česká pošta, s.p. | |||
| IT | WEIDO CZ s.r.o. | |||
| PPL | PPL CZ s.r.o. | |||
| GLS | General Logistics Systems Czech Republic s.r.o. | |||
| MES | MESSENGER a.s. | |||
| TNT | TNT Express Worldwide spol. s r.o. | |||
| ULO | WEIDO CZ s.r.o. | |||
| ZAS | Zásilkovna s.r.o. | |||
| PBH | Pošta Bez Hranic | |||
| BAL_GLS | Balíkonoš - General Logistics Systems Czech Republic s.r.o. | |||
| BAL_IT | Balíkonoš - WEIDO CZ s.r.o. | |||
| BAL_MES | Balíkonoš - MESSENGER a.s. | |||
| BAL_TNT | Balíkonoš - TNT Express Worldwide spol. s r.o. | |||
| DPD | Direct Parcel Distribution CZ s. r. o. | |||
| GEIS | GEIS | |||
| SLOVAKIA_POST | Slovenská pošta, a. s. | |||
| CZECH_POST | Česká pošta, s.p. | |||
| JAPO | JAPO - transport s.r.o. | |||
| PPL_SMART | PPL CZ s.r.o. | |||
| POCZTA_POLSKA | Polská pošta (Poczta Polska) | |||
| DEUTSCHE_POST | Německá pošta (Deutsche post) | |||
| HUNGARY_POST | Maďarská pošta | |||
| AUSTRIA_POST | Rakouská pošta | |||
| SWITZERLAND_POST | Švýcarská pošta | |||
| NOVA_POSHTA | Nova Poshta (Ukraina) | |||
| NETHERLANDS_POST | Nizozemská pošta | |||
| CROATIA_POST | Chorvatská pošta | |||
| RUSSIA_POST | Ruská pošta | |||
| BELGIUM_POST | Belgická pošta | |||
| LUXEMBOURG_POST | Lucemburská pošta | |||
| US_POST | US Post | |||
| SLOVENIA_POST | Slovinská pošta | |||
| FEDEX | FedEx | |||
| MEEST | Meest | |||
| UPS | UPS | |||
| DHL | DHL | |||
| SPEEDY | Speedy | |||
| HERMES | Hermes | |||
| CORREOS | Correos | |||
| MRW | MRW | |||
| FAN_COURIER | FAN Courier | |||
| ROYAL_MAIL | Royal Mail | |||
| INPOST_KURIER | InPost Kurier | |||
| POST_NORD | Post Nord | |||
| OMNIVA | Omniva | |||
| COLISSIMO | Colissimo | |||
| ROSAN | Rosan | |||
| TRANS_O_FLEX | Trans-o-flex | |||
| EXPRESS_ONE | Express One | |||
| CARGUS | Cargus | |||
| MONDIAL | Mondial | |||
| ECONT | Econt | |||
| ACS | ACS | |||
| BARTOLINI | Bartolini | |||
| DAO | DAO | |||
| FASTWAY | Fastway | |||
| OVERSEAS | Overseas | |||
| ARAMEX | Aramex | |||
| KURIER_123 | 123 Kuriér |
Identifikátory přepravních služeb
Identifikátor se zasílá v požadavcích v poli deliveryType (camel case).
| Přepravce | Identifkátor služby deliveryType | Služba | ParcelShop | Pouze Cargo | Info |
|---|---|---|---|---|---|
| Česká pošta (Starší verze) (ČP) | DR | Balík Do ruky | |||
| NP | Balík Na poštu | ||||
| RR | Obchodní psaní | ||||
| BB | Cenný balík | ||||
| BA | Doporučený balíček | ||||
| DE | Do ruky + garantovaný čas | ||||
| NB | Balík Do balíkovny | ||||
| WE|DO (InTime) (IT) | HD | WE|DO Home | |||
| PPL (Starší verze) (PPL) | SB | PPL Parcel CZ Private | |||
| FB | PPL Parcel CZ Business | ||||
| EB | PPL Parcel Connect | ||||
| GLS (GLS) | BP | Business Parcel | Poslání na adresu příjemce | ||
| GC | GLS - ParcelShop Česká republika | ||||
| GS | GLS - ParcelShop Slovensko | ||||
| GH | GLS - ParcelShop Maďarsko | ||||
| Messenger (MES) | ST | Standard (120 min.) | |||
| ET | Extreme (30 min.) | ||||
| EP | Express (60 min.) | ||||
| SD | Same Day | ||||
| OC | Overnight Economy | ||||
| TNT (TNT) | EP | Express | |||
| EC | Economy Express | ||||
| ED | Express dokumenty | ||||
| WE|DO (Uloženka) (ULO) | UL | WE|DO Uloženka | |||
| UP | WE|DO Uloženka Partner | ||||
| UD | DPD Pickup | ||||
| SKPOST_DEFAULT | Slovenská pošta - Zmluvný balík s poistením | ||||
| DPD_PRIVATE | DPD Private | ||||
| CPOST_DR | Česká pošta - balík do ruky | ||||
| CPOST_NP | Česká pošta - balík na poštu | ||||
| INTIME_B2C | INTIME - Na soukromou adresu | ||||
| DHL | DHL | ||||
| ULOZENKA_B2C | Uloženka Přeprava | ||||
| MALLBOX | Mallbox | ||||
| SKPOST_ECA | Expres kurýr na adresu SK | ||||
| SKPOST_ECP | Expres kurýr na poštu SK | ||||
| SKPOST_ECB | Expres kurýr na BalíkoBOX SK | ||||
| DEPO | Depo | ||||
| DEPO_SK_SK | Depo SK-SK | ||||
| WEDO_PUP_SK_CZ | WEDO PUP SK-CZ | ||||
| WEDO_HOME_SK_CZ | WEDO Home SK-CZ | ||||
| Zásilkovna (ZAS) | VM | Výdejní místa | Česká republika a vybrané státy s výdejnímy místy Zásilkovny | ||
| RP | AT Rakouská pošta HD | Rakousko | |||
| MP | HU Maďarská pošta HD | Maďarsko | |||
| RF | RO FAN Courier HD | Rumunsko | |||
| RD | RO DPD HD | Rumunsko | |||
| DA | SK Doručení na adresu HD | Slovensko | |||
| SP | SK Slovenská pošta HD | Slovensko | |||
| PA | PL InPost Paczkomaty Box | Polsko | |||
| UN | UA Nova Poshta | Ukrajina | |||
| BS | BG Speedy Office | Bulharsko | |||
| HR | HR Chorvatská pošta VM | chorvatsko | |||
| SE | SE Post Nord PP | Švédsko | |||
| FI | FI Post Nord PP | Finsko | |||
| SU | SI DPD Pickup | Slovinsko | |||
| DK | DK Post Nord PP | Dánsko | |||
| EP | EE Omniva Pickup | Estonsko | |||
| EB | EE Omniva Box | Estonsko | |||
| LB | LV Omniva Box | Lotyšsko | |||
| LT | LT Omniva Box | Litva | |||
| DH | DE Hermes Pickup | Německo | |||
| CN | CZ Zásilkovna domů | Česká republika | |||
| XS | SK Zásielkovňa večerní doručení Bratislava HD | Slovensko | |||
| XO | CZ Zásilkovna večerní doručení Ostrava HD | Česká republika | |||
| XB | CZ Zásilkovna večerní doručení Brno HD | Česká republika | |||
| XP | CZ Zásilkovna večerní doručení Praha HD | Česká republika | |||
| RC | RO Urgent Cargus HD | Rumunsko | |||
| UR | UA Rosan HD | Ukrajina | |||
| IG | IT GLS HD | Itálie | |||
| SL | CH LI Švýcarská pošta HD | Švýcarsko | |||
| SV | CH LI Švýcarská pošta prioritní HD | Švýcarsko | |||
| BU | BG Speedy HD | Bulharsko | |||
| HQ | HU Doručení na adresu HD | Maďarsko | |||
| RQ | RO Doručení na adresu HD | Rumunsko | |||
| PQ | PL Doručení na adresu HD | Polsko | |||
| FC | FR Colissimo HD | Francie | |||
| NP | NL Nizozemská pošta HD | Nizozemí | |||
| RU | RU Ruská pošta PP | Rumunsko | |||
| CA | HR Chorvatská pošta HD | Chorvatsko | |||
| SC | ES Correos HD | Španělsko | |||
| CV | HR DPD HD | Chorvatsko | |||
| ER | ES MRW HD | Španělsko | |||
| PR | PT MRW HD | Portugalsko | |||
| SN | SE Post Nord HD | Švédsko | |||
| FN | FI Post Nord HD | Finsko | |||
| BL | NL Nizozemská pošta HD | Nizozemí | |||
| LD | LU DPD HD | Lucembursko | |||
| AA | GB Royal Mail 24 HD | Velká Británie | |||
| AB | GB Royal Mail 48 HD | Velká Británie | |||
| SD | SI DPD HD | Slovinsko | |||
| DS | DK Post Nord HD | Dánsko | |||
| EH | EE Omniva HD | Estonsko | |||
| LH | LV Omniva HD | Lotyšsko | |||
| RE | RU Ruská pošta EMS HD | Rusko | |||
| RA | RU Ruská pošta doporučený balík PP | Rusko | |||
| DO | DE Hermes HD | Německo | |||
| AD | FR Colissimo PP | Francie | |||
| AF | ES MRW PP | Španělsko | |||
| AG | PT MRW PP | Portugalsko | |||
| AI | FR Mondial PP | Francie | |||
| AM | BG Econt PP | Bulharsko | |||
| AO | BG Econt Box | Bulharsko | |||
| AR | GR ACS PP | Řecko | |||
| AT | BE Belgická pošta PP | Belgie | |||
| AV | NL DHL PP | Nizozemí | |||
| AC | FR Colis Privé HD | Francie | |||
| AJ | LT Omniva HD | Litva | |||
| AK | BG Econt HD | Bulharsko | |||
| AL | AT DPD HD | Rakousko | |||
| AP | RO Sameday HD | Rumunsko | |||
| AQ | GR ACS HD | Řecko | |||
| AS | BE Belgická pošta HD | Beglie | |||
| AU | NL DHL HD | Nizozemí | |||
| AW | LU Lucemburská pošta | Lucembursko | |||
| AX | US FedEx HD Economy | Spojené státy americké | |||
| AY | US FedEx HD Priority | Spojené státy americké | |||
| AZ | GR Taxydromiki HD | Řecko | |||
| RO_SAMEDAY_BOX | RO Sameday Box | Rumunsko Same Day | |||
| IT_BARTOLINI_HD | IT Bartolini HD | Itálie | |||
| DK_DAO_HD | DK DAO HD | Dánsko DAO HD | |||
| DK_DAO_PP | DK DAO PP | Dánsko DAO PP | |||
| IE_FASTWAY_HD | IE Fastway HD | Irsko Fastway HD | |||
| HR_OVERSEAS_HD | HR Overseas HD | Chorvatsko Overseas HD | |||
| HR_OVERSEAS_PP | HR Overseas PP | Chorvatsko Overseas PP | |||
| AE_ARAMEX_HD | AE Aramex HD | Spojene Arabské Emiráty Aramex HD | |||
| SI_POST_HD | SI Post HD | Slovinsko Pošta PP | |||
| SI_POST_PP | SI Post PP | Slovinsko Pošta HD | |||
| SI_POST_BOX | SI Post Box | Slovinsko Post Box | |||
| DE_HOME_DELIVERY | DE Německo Home Delivery HD | Německo Home Delivery HD | |||
| CAR_DELIVERY | CZ doručení do vozu | Zásilkovna doručení do vozu, pouze ČR | |||
| EE_OMNIVA_PP | EE Omniva PP | Estonsko Omniva PP | |||
| EE_OMNIVA_HD | EE Omniva HD | Estonsko Omniva HD | |||
| LT_LITHUANIAN_POST_HD | LT Lithuanian Post HD | ||||
| LT_LITHUANIAN_POST_BOX_PP | LT Lithuanian Post Box PP | ||||
| GR_ELTA_HD | GR Elta Courier HD | ||||
| GR_ELTA_PP | GR Elta Courier PP | ||||
| SI_EXPRESS_ONE_HD | SI Express one HD | ||||
| SI_EXPRESS_ONE_PP | SI Express One PP | ||||
| EE_LITHUANIAN_POST_HD | EE Lithuanian Post HD | ||||
| BG_SAMEDAY_HD | BG Sameday HD | ||||
| FI_MATKAHUOLTO_HD | FI Matkahuolto HD | ||||
| IT_HR_PARCEL_HD | IT HR Parcel HD | ||||
| LV_LITHUANIAN_POST_HD | LV Lithuanian Post HD | Lotyšsko | |||
| HU_FOXPOST_PP | HU FoxPost Box PP | Maďarsko | |||
| Pošta Bez Hranic (PBH) | SU | Slovensko - SPS (UPS) | |||
| PBH_BE_DHL | Belgie - DHL | ||||
| PBH_BG_DHL | Bulharsko - DHL | ||||
| BR | Belgie - DPD | ||||
| BS | Bulharsko - Speedy / Na adresu | ||||
| CN | Česká republika - Česká pošta / Na Poštu | ||||
| CP | Česká republika - PPL | ||||
| CR | Česká republika - Česká pošta / Do ruky | ||||
| PBH_DK_DHL | Dánsko - DHL | ||||
| DP | Dánsko - DPD | ||||
| ED | Estonsko - DPD | ||||
| FC | Francie - Colissimo | ||||
| PBH_FR_DHL | Francie - DHL | ||||
| PBH_FI_DHL | Finsko - DHL | ||||
| PBH_IT_DHL | Itálie - DHL | ||||
| LD | Litva - DPD | ||||
| LP | Lotyšsko - DPD | ||||
| MD | Maďarsko - DPD | ||||
| MM | Maďarská pošta | ||||
| ND | Německo - DHL | ||||
| PBH_NL_DHL | Nizozemí - DHL | ||||
| NP | Německo - DPD | ||||
| NR | Nizozemí - DPD | ||||
| NT | Německo - trans-o-flex | ||||
| PC | Polsko - Paczkomaty | ||||
| PE | Polsko - DPD | ||||
| PBH_PT_DHL | Portugalsko - DHL | ||||
| PQ | Rakousko - Rakouská pošta | ||||
| PR | Polsko - Poczta Polska | ||||
| PT | Maďarsko - Transoflex | ||||
| RC | Rumunsko - Cargus | ||||
| RZ | Rumunsko - FAN - na adresu | ||||
| RS | Rakousko - DPD | ||||
| PBH_ES_DHL | Španělsko - DHL | ||||
| PBH_SE_DHL | Švédsko - DHL | ||||
| SS | Slovensko - Slovenská pošta | ||||
| UM | Ukrajina - Meest | ||||
| UN | Ukrajina - Nova Poshta | ||||
| PBH_GB_DHL | Velká Británie - DHL | ||||
| VH | Velká Británie - Hermes | ||||
| RF | Rumunsko - FAN - eBox | ||||
| RT | Rumunsko - FAN - CollectPoint | ||||
| SB | Slovensko - Slovenská pošta / Balíkobox | ||||
| SP | Slovensko - Slovenská pošta / Balík na poštu | ||||
| SW | Slovensko - SPS (UPS) / Parcel Shop | ||||
| AP | Rakousko - Rakouská pošta / Na poštu | ||||
| AA | Rakousko - Rakouská pošta / Automaty | ||||
| MV | Maďarsko - Hungarian Post / Výdejní místa | ||||
| MA | Maďarsko - Hungarian Post / Automaty | ||||
| MP | Maďarsko - Hungarian Post / Na poštu | ||||
| NS | Německo - DHL - Postfiliale | ||||
| NQ | Německo - DHL - Packstation | ||||
| BU | Bulharsko - Speedy / Parcelshop | ||||
| BV | Bulharsko - Speedy / Automat | ||||
| PK | Polsko - InPost Kurier | ||||
| IP | Itálie - DPD | ||||
| FD | Francie - DPD | ||||
| VD | Velká Brítánie - DPD | ||||
| SL | Slovinsko - DPD | ||||
| CH | Chorvatsko - DPD | ||||
| SN | Španělsko - DPD | ||||
| SC | Španělsko - Correos | ||||
| PD | Portugalsko - DPD | ||||
| FI | Finsko - DPD | ||||
| RD | Řecko - DPD | ||||
| SV | Švédsko - DPD | ||||
| IR | Irsko - DPD | ||||
| LU | Lucembursko - DPD | ||||
| BC | Bulharsko - eCont | ||||
| PBH_BG_ECONT_PS | Bulharsko - eCont Parcelshop | ||||
| PBH_CZ_CP_BAL | Česká republika - Česká pošta / Balíkovna | Využívá seznam Balíkoven České pošty. Identifikátorem odběrného místa je PSČ. | |||
| PBH_IT_GLS | Itálie - GLS | ||||
| PBH_GB_R24 | Velká Británie - RoyalMail 24h | ||||
| PBH_GB_R48 | Velká Británie - RoyalMail 48h | ||||
| PBH_SK_123 | Slovensko - 123 Kuriér | ||||
| PBH_IR_DHL | Irsko - DHL | ||||
| PBH_LV_DHL | Lotyšsko - DHL | ||||
| PBH_LT_DHL | Litva - DHL | ||||
| PBH_EE_DHL | Estonsko - DHL | ||||
| Balíkonoš - GLS (BAL_GLS) | BP | Business Parcel | |||
| GC | GLS - ParcelShop Česká republika | ||||
| GS | GLS - ParcelShop Slovensko | ||||
| GH | GLS - ParcelShop Maďarsko | ||||
| Balíkonoš - WE|DO (InTime) (BAL_IT) | HD | WE|DO Home | |||
| Balíkonoš - Messenger (BAL_MES) | OC | Overnight Economy | |||
| SD | Same Day | ||||
| EP | Express (60 min.) | ||||
| ET | Extreme (30 min.) | ||||
| ST | Standard (120 min.) | ||||
| Balíkonoš - TNT (BAL_TNT) | ED | Express dokumenty | |||
| EC | Economy Express | ||||
| EP | Express | ||||
| DPD (DPD) | DQ | DPD Classic | Standardní balíková přeprava bez notifikací | ||
| DJ | DPD AirExpress | Letecká přeprava | |||
| DW | DPD Private | Standardní balíková přeprava s notifikacemi. SMS a email avíza se nepředávají jako extra služby. | |||
| DZ | DPD Express 12:00 | ||||
| DK | DPD Express 18:00 | ||||
| DM | DPD Pneu | Přeprava určena výhradně pro pneumatiky. | |||
| DC | DPD Pickup - Česká republika | ||||
| DS | DPD Pickup - Slovensko | ||||
| DP | DPD Pickup - Polsko | ||||
| DD | DPD Pickup - Německo | ||||
| DA | DPD Pickup - Rakousko | ||||
| DH | DPD Pickup - Holandsko | ||||
| DN | DPD Pickup - Španělsko | ||||
| DY | DPD Pickup - Švýcarsko | ||||
| DO | DPD Pickup - Portugalsko | ||||
| DU | DPD Pickup - Lucembursko | ||||
| DL | DPD Pickup - Lotyšsko | ||||
| DF | DPD Pickup - Francie | ||||
| DE | DPD Pickup - Estonsko | ||||
| DB | DPD Pickup - Belgie | ||||
| DV | DPD Pickup - Litva | ||||
| DHR | DPD Pickup - Chorvatsko | ||||
| DIT | DPD Pickup - Itálie | ||||
| DHU | DPD Pickup - Maďarsko | ||||
| DRO | DPD Pickup - Rumunsko | ||||
| DSI | DPD Pickup - Slovinsko | ||||
| DSE | DPD Pickup - Švédsko | ||||
| GEIS (GEIS) | CS | GEIS Cargo - na soukromou adresu | Soukromé cargo zásilky (B2C) pro fyzické osoby, Je vyžadován telefon příjemce. | ||
| CF | GEIS Cargo | B2B Cargo zásilky. | |||
| Slovenská pošta (SLOVAKIA_POST) | SLOVAKIA_POST_TRACKING | Slovenská pošta - Pouze pro tracking zásilek | |||
| Česká pošta (CZECH_POST) | CZECH_POST_ORDINARY | Obyčejný balík | |||
| CZECH_POST_NA_POSTU | Balík Na poštu | ||||
| CZECH_POST_DO_BALIKOVNY | Balíkovna | ||||
| CZECH_POST_DO_RUKY | Balík Do ruky | Doporučujeme použít novější službu Balíkovna plus (CZECH_POST_BALIKOVNA_PLUS), která je obdobou Balíku do ruky. | |||
| CZECH_POST_COMPLETE | Balík Komplet | ||||
| CZECH_POST_OVERSIZE | Balík Nadrozměr | ||||
| CZECH_POST_EXPRES | Balík Expres | ||||
| CZECH_POST_INSURED | Cenný balík | ||||
| CZECH_POST_REGISTERED_PACKET | Doporučený balíček | ||||
| CZECH_POST_REGISTERED_LETTER | Doporučené psaní | ||||
| CZECH_POST_EMS | EMS vnitrostátní | ||||
| CZECH_POST_STANDARD_INT | Standardní balík do zahraničí | ||||
| CZECH_POST_INSURED_INT | Cenný balík do zahraničí | ||||
| CZECH_POST_EMS_INT | EMS do zahraničí | ||||
| CZECH_POST_COMMERCIAL_INT | Obchodní balík do zahraničí | ||||
| CZECH_POST_BALIKOVNA_PLUS | Balíkovna plus | Dříve Balík do ruky (DR) | |||
| CZECH_POST_BALIKOVNA_NA_ADRESU | Balíkovna na adresu | ||||
| JAPO (JAPO) | JAPO_STANDARD | Standard | |||
| JAPO_RETURN | Return (Vrácená zásilka) | ||||
| PPL (PPL_SMART) | PPL_BUSINESS | PPL Parcel Business | PPL Parcel Business - automaticky rozliší CZ a EU | ||
| PPL_DOPOLEDNI | PPL Parcel Dopolední balík | PPL Parcel Dopolední balík - jen vybraná města v ČR | |||
| PPL_PRIVATE | PPL Parcel Private | PPL Parcel Private - Vnitrostátní přeprava; Pouze ČR | |||
| PPL_CONNECT | PPL Parcel Connect | PPL Parcel Connect - do povolených zemí | |||
| PPL_RETURN | PPL Parcel Return | PPL Parcel Return - pouze ČR | |||
| PPL_SMART_PP | PPL Parcel Smart PP | PPL Parcel Smart ParcelShop - automaticky rozliší CZ a EU | |||
| Polská pošta (Poczta Polska) (POCZTA_POLSKA) | POCZTA_POLSKA_TRACKING | Polská pošta (Poczta Polska) - Pouze pro tracking zásilek | |||
| Německá pošta (Deutsche post) (DEUTSCHE_POST) | DEUTSCHE_POST_TRACKING | Německá pošta (Deutsche post) - Pouze pro tracking zásilek | |||
| Maďarská pošta (HUNGARY_POST) | HUNGARY_POST_TRACKING | Maďarská pošta - Pouze pro tracking zásilek | |||
| Rakouská pošta (AUSTRIA_POST) | AUSTRIA_POST_TRACKING | Rakouská pošta - Pouze pro tracking zásilek | |||
| Švýcarská pošta (SWITZERLAND_POST) | SWITZERLAND_POST_TRACKING | Švýcarská pošta - Pouze pro tracking zásilek | |||
| Nova Poshta (Ukraina) (NOVA_POSHTA) | NOVA_POSHTA_TRACKING | Nova Poshta (Ukraina) - Pouze pro tracking zásilek | |||
| Nizozemská pošta (NETHERLANDS_POST) | NETHERLANDS_POST_TRACKING | Nizozemská pošta - Pouze pro tracking zásilek | |||
| Chorvatská pošta (CROATIA_POST) | CROATIA_POST_TRACKING | Chorvatská pošta - Pouze pro tracking zásilek | |||
| Ruská pošta (RUSSIA_POST) | RUSSIA_POST_TRACKING | Ruská pošta - Pouze pro tracking zásilek | |||
| Belgická pošta (BELGIUM_POST) | BELGIUM_POST_TRACKING | Belgická pošta - Pouze pro tracking zásilek | |||
| Lucemburská pošta (LUXEMBOURG_POST) | LUXEMBOURG_POST_TRACKING | Lucemburská pošta - Pouze pro tracking zásilek | |||
| US Post (US_POST) | US_POST_TRACKING | US Post - Pouze pro tracking zásilek | |||
| Slovinská pošta (SLOVENIA_POST) | SLOVENIA_POST_TRACKING | Slovinská pošta - Pouze pro tracking zásilek | |||
| FedEx (FEDEX) | FEDEX_TRACKING | FedEx - Pouze pro tracking zásilek | |||
| Meest (MEEST) | MEEST_TRACKING | Meest - Pouze pro tracking zásilek | |||
| UPS (UPS) | UPS_TRACKING | UPS - Pouze pro tracking zásilek | |||
| DHL (DHL) | DHL_TRACKING | DHL - Pouze pro tracking zásilek | |||
| Speedy (SPEEDY) | SPEEDY_TRACKING | Speedy - Pouze pro tracking zásilek | |||
| Hermes (HERMES) | HERMES_TRACKING | Hermes - Pouze pro tracking zásilek | |||
| Correos (CORREOS) | CORREOS_TRACKING | Correos - Pouze pro tracking zásilek | |||
| MRW (MRW) | MRW_TRACKING | MRW - Pouze pro tracking zásilek | |||
| FAN Courier (FAN_COURIER) | FAN_COURIER_TRACKING | FAN Courier - Pouze pro tracking zásilek | |||
| Royal Mail (ROYAL_MAIL) | ROYAL_MAIL_TRACKING | Royal Mail - Pouze pro tracking zásilek | |||
| InPost Kurier (INPOST_KURIER) | INPOST_KURIER_TRACKING | InPost Kurier - Pouze pro tracking zásilek | |||
| Post Nord (POST_NORD) | POST_NORD_TRACKING | Post Nord - Pouze pro tracking zásilek | |||
| Omniva (OMNIVA) | OMNIVA_TRACKING | Omniva - Pouze pro tracking zásilek | |||
| Colissimo (COLISSIMO) | COLISSIMO_TRACKING | Colissimo - Pouze pro tracking zásilek | |||
| Rosan (ROSAN) | ROSAN_TRACKING | Rosan - Pouze pro tracking zásilek | |||
| Trans-o-flex (TRANS_O_FLEX) | TRANS_O_FLEX_TRACKING | Trans-o-flex - Pouze pro tracking zásilek | |||
| Express One (EXPRESS_ONE) | EXPRESS_ONE_TRACKING | Express One - Pouze pro tracking zásilek | |||
| Cargus (CARGUS) | CARGUS_TRACKING | Cargus - Pouze pro tracking zásilek | |||
| Mondial (MONDIAL) | MONDIAL_TRACKING | Mondial - Pouze pro tracking zásilek | |||
| Econt (ECONT) | ECONT_TRACKING | Econt - Pouze pro tracking zásilek | |||
| ACS (ACS) | ACS_TRACKING | ACS - Pouze pro tracking zásilek | |||
| Bartolini (BARTOLINI) | BARTOLINI_TRACKING | Bartolini - Pouze pro tracking zásilek | |||
| DAO (DAO) | DAO_TRACKING | DAO - Pouze pro tracking zásilek | |||
| Fastway (FASTWAY) | FASTWAY_TRACKING | Fastway - Pouze pro tracking zásilek | |||
| Overseas (OVERSEAS) | OVERSEAS_TRACKING | Overseas - Pouze pro tracking zásilek | |||
| Aramex (ARAMEX) | ARAMEX_TRACKING | Aramex - Pouze pro tracking zásilek | |||
| 123 Kuriér (KURIER_123) | KURIER_123_TRACKING | 123 Kuriér - Pouze pro tracking zásilek |
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 Štíteknabalík.cz
Identifikátor služby extraServices.code | Název služby | Popis | Argumenty pro přepravce extraServices.arguments.* |
|---|---|---|---|
| Služby avízace: | |||
| authentication | Ověření totožnosti | Při doručení kurýr předá zásilku příjemci až po předložení originálu dokladu totožnosti – OP, ŘP nebo cestovní pas. | IT
BAL_IT
CZECH_POST |
| call_advice_unload | Telefonní avizace před doručením | Avízo pro odesílatele, že kurýr bude vykládat zboží. | IT
BAL_IT
GEIS |
| call_advice_load | Telefonní avizace vyzvednutí | Avízo pro odesílatele, že přijede kurýr pro naložení zboží. | IT
BAL_IT
|
| back_delivery | Zpětná zásilka | Vyzvednutí balíku na vybrané adrese a doručení zpět objednavateli. 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. | IT GLS BAL_IT BAL_GLS DPD GEIS ČP PPL MES TNT ULO ZAS PBH BAL_MES BAL_TNT SLOVAKIA_POST PPL_SMART |
| cod | Dobírka | Výběr hotovosti za zboží při převzetí zásilky. | IT PPL ČP GLS MES ULO ZAS PBH BAL_IT BAL_GLS BAL_MES DPD GEIS CZECH_POST TNT BAL_TNT SLOVAKIA_POST PPL_SMART |
| carry | Donos | Při nutnosti roznášet zboží po kancelářích (nebo stěhovaní nadrozměrných zásilek). | IT BAL_IT |
| documents_back | Dokumenty zpět | Speciální řešení, je-li třeba nechat adresátem potvrdit dokument, který doprovází balík, a doručit ho zpět odesílateli. | IT
BAL_IT
GEIS CZECH_POST
|
| direct_delivery | Přímá zásilka | Vyzvednutí balíku na vybrané adrese a doručení na libovolnou adresu. | IT GLS PBH BAL_IT BAL_GLS DPD GEIS ČP PPL MES TNT ULO ZAS BAL_MES BAL_TNT SLOVAKIA_POST PPL_SMART |
| exchange_delivery | Výměnná zásilka | Vý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ží). | IT
BAL_IT
DPD CZECH_POST |
| company_delivery | Dodání firmě | Doručení zásilky právnické osobě. | ČP CZECH_POST |
| sms_service | SMS service | SMS avizace o doručení zásilky následující pracovní den. | GLS
BAL_GLS
|
| guaranteed_24 | Garantované doručení | Garantované doručení následující pracovní den od převzetí kurýrem. | GLS BAL_GLS DPD CZECH_POST |
| hydraulic_lift | Hydraulické čelo | Příplatek za dodání s hydraulickým čelem | |
| insurance | Připojištění | Dodatečné jednorázové připojištění nad rámec základu k jednotlivým balíkům. | IT GLS TNT PBH BAL_IT BAL_GLS BAL_TNT DPD GEIS CZECH_POST PPL_SMART |
| take_away | Odnos | Vybalení zboží na místě u adresáta a odvozu prázdných obalů. | IT BAL_IT CZECH_POST |
| sms_advice_unload | SMS avízo před doručením | SMS avízo před doručením zásilky. | GLS
ČP
IT
PPL
BAL_IT
BAL_GLS
GEIS DPD
|
| sms_preadvice | SMS Preadvice | SMS avízo o doručení zásilky. Standardně v předpokládaném 3-hodinovém časovém intervalu. | GLS
BAL_GLS
|
| evening_delivery | Večerní doručení | Večerní doručení | PPL DPD PPL_SMART |
| addressee_only | Pouze příjemce | Doručení pouze do rukou konkrétní osoby. | GLS
BAL_GLS
GEIS CZECH_POST |
| sunday_delivery | Nedělení doručení | Nedělní doručení zásilky.' | ČP CZECH_POST |
| think_green | Ekologická přeprava | CO2 neutrální přeprava balíků. | GLS BAL_GLS |
| day_definite | Přesný den doručení | Přesně definovaný den doručení. | GLS
BAL_GLS
|
| email_advice_unload | Email avízo před doručením | Email avízo před doručením zásilky. | ČP
IT
PPL
GLS
BAL_IT
BAL_GLS
GEIS
|
| sms_advice_load | SMS avízo vyzvednutí | SMS avízo po vyzvednutí zásilky. | IT
BAL_IT
|
| email_advice_load | Email avízo vyzvednutí | Email avízo po vyzvednutí zásilky. | IT
BAL_IT
|
| saturday_delivery | Sobotní doručení | Sobotní doručení zásilky. | ČP CZECH_POST |
| fragile | Křehce | Zacházení s cenným balíkem se zvláštní opatrností, aby bylo omezeno nebezpečí poškození. | ČP CZECH_POST |
| priority | Přednostní manipulace | Přednostní manipulace se zásilkou od vyzvednutí až po její doručení. | TNT BAL_TNT CZECH_POST |
| morning_delivery | Doručit dopoledne | Dopolední doručovací pochůzka. | ČP CZECH_POST |
| afternoon_delivery | Doručit odpoledne | Odpolední doručení. | ČP CZECH_POST |
| credit_card | Platba kartou | Při výdeji je povolena platba kartou. Při platbě kartou jsou účtovány dodatečné poplatky. | ULO DPD |
| full_age | Ověření plnoletosti (18+) | Při výdeji zásilky je požadováno ověření plnoletosti (18+) | ULO ZAS PPL_SMART DPD |
| preview | Prohlídka zboží | Povolení prohlídky zboží při výdeji zásilky. | ULO PBH |
| signature | Doručení proti podpisu | Doručení proti podpisu | PBH |
| test_before_payment | Vyzkoušení před převzetím | Zákazník si může vyzkoušet zboží před jeho převzetím | PBH |
| advice_delivered | Avízo o doručení (nebo také eDodejka) | Email nebo SMS potvrzení pro odesílatele o doručení zásilky | CZECH_POST |
| advice_damaged | Avízo poškození zásilky | Email nebo SMS potvrzení pro odesílatele poškození zásilky | |
| advice_undelivered | Avízo problematické zásilky | Email nebo SMS potvrzení pro odesílatele o problematické zásilce, která nemohla být doručena | |
| advice_pod | Doklad o doručení (P.O.D) | Doklad o doručení zásilek na email odesílatele (Proof od Delivery) | CZECH_POST |
| advice_recipient | SMS a email avízace příjemci | Email nebo SMS avízace pro příjemce zásilky od převzetí přepravcem až po předání | CZECH_POST |
| sms_advice_recipient | SMS avízace příjemci | SMS avízace pro příjemce zásilky od převzetí přepravcem až po předání | CZECH_POST |
| email_advice_recipient | Email avízace příjemci | Emailová avízace pro příjemce zásilky od převzetí přepravcem až po předání | CZECH_POST |
| sms_advice_delivered | SMS avízo o doručení | SMS potvrzení pro odesílatele o doručení zásilky (nebo také eDodejka) | CZECH_POST |
| email_advice_delivered | Email avízo o doručení | Emailové potvrzení pro odesílatele o doručení zásilky (nebo také eDodejka) | CZECH_POST |
| non_standard | Nestandardní balík | Zásilka nemá pravidelný tvar krychle nebo kvádru nebo není zabalen ve standardizovaném obalu | CZECH_POST ČP |
| store_3_days | Úložní doba 3 dny | Vyžádání změny úložní doby z původní na 3 dny | CZECH_POST |
| store_7_days | Úložní doba 7 dnů | Vyžádání změny úložní doby z původní na 7 dnů | CZECH_POST |
| store_10_days | Úložní doba 10 dnů | Vyžádání změny úložní doby z původní na 10 dnů | CZECH_POST |
| store_90_days | Úložní doba 90 dnů | Vyžádání změny úložní doby z původní na 90 dnů | CZECH_POST |
| store_10_working_days | Úložní doba 10 pracovních dnů | Vyžádání změny úložní doby z původní na 10 pracovních dnů | CZECH_POST |
| cumbersome | Neskladné | Zásilku nelze skladovat, protože je nadrozměrná nebo má nepravidelné tvary | CZECH_POST |
| do_not_store | Neukládat | Pokud nebyl adresát zastižen a nelze zásilku vložit do schránky, bude zásilka vrácena zpět odesíteli. | CZECH_POST |
| do_not_extend | Neprodlužovat úložní dobu | Adresát si nemůže vyžádat prodloužení úložní doby. | CZECH_POST |
| valuable_package | Cenný obsah | Cenný obsah - zásilka obsahuje cennosti (například šperky, cenné papíry, šeky, směnky, drahé kovy a kameny, apod.) | CZECH_POST |
| diligently | Pilně | Pilně (Česká pošta) | CZECH_POST |
| hand_delivery | Předání do ruky | Předání zásilky od kurýra přímo do ruky příjemci na adrese příjemce. Zásilku může převzít kdokoliv na uvedené adrese. | CZECH_POST |
| size_s | Velikost S | Velikost S | CZECH_POST |
| size_m | Velikost M | Velikost M | CZECH_POST |
| size_l | Velikost L | Velikost L | CZECH_POST |
| size_xl | Velikost XL | Velikost XL | CZECH_POST |
| size_xxl | Velikost XXL | Velikost XXL | |
| pallete | Paleta | Zásilka je na palětě | CZECH_POST
|
| do_not_tilt | Neklopit | Zásilka se nesmí naklánět a obracet dnem vzhůru | CZECH_POST |
| take_away_old | Odvoz starého spotřebiče | Odvoz starého spotřebiče nebo vybavení. | CZECH_POST |
| delivery_report | Informace o předání | Po předání zásilky přijemci budou odesílateli sděleny dodatečné informace o předání. | CZECH_POST |
| do_not_resend | Nepřeposílat | Zamezit přeposílání zásilky na jinou adresu než původní. | CZECH_POST |
| third_person_pickup | Vyzvednutí třetí osobou | Umožní vyzvednutí zásilky třetí osobou. | CZECH_POST |
| gift | Zboží / dárek | Zásilka je přepravována jako dárek. | CZECH_POST |
| customs_documents | Vývozní doklady | Zásilka je přepravována s celními doklady. | CZECH_POST
|
| recommended_delivery | Doporučeně | Doporučená zásilka. | CZECH_POST |
| blind_delivery | Slepecká zásilka | Slepecká zásilka. | CZECH_POST |
| poste_restante | Poste restante | Poste restante - zásilka nebude doručena na adresátovu adresu, ale zůstane na cílové poště | CZECH_POST |
| multipackage | Vícekusá zásilka | Vícekusá zásilka | ČP IT PPL GLS MES TNT ULO ZAS PBH BAL_GLS BAL_IT BAL_MES BAL_TNT DPD GEIS SLOVAKIA_POST PPL_SMART |
| extended_storing | Prodloužení odběrní lhůty | Základní prodloužení odběrní lhůty pro danou přepravní službu. | CZECH_POST |
| exw | Platba v hotovosti příjemcem EXW | Platba za pomocí doložky EXW (Ex-Works) | GEIS PPL_SMART |
| age15 | Ověření let (15+) | Při výdeji zásilky je požadováno ověření věku (15+) | PPL_SMART |
| delivery_attempt | Opakovaný pokus doručení | Další pokus o doručení | PPL_SMART |
| delivery_standard | Standardní doručení | Standardní doručení (pokud takové doručení přepravce nabízí) | GEIS |
| delivery_premium | Prémiové doručení | Prémiové doručení (pokud takové doručení přepravce nabízí) | GEIS |
| digital_documents | Elektronické dokumenty | Předání elektronických dokumentů přepravci (např. přes FTP) a pro doručení nebo potvrzení příjemcem. | GEIS |
| delivery_protocol_signature | Potvrzené dodací listy | Potvrzení dodacích listů příjemcem | GEIS |
| cod_explicit | Dobírka explicitní | Explicitně vyžádaná dobírka k zásilce | |
| return_label | Zpáteční štítek | Vytvoření štítku pro zpáteční zásilku | JAPO |
| recommended_delivery_standard | Doporučeně standard | Doporučená zásilka standard | CZECH_POST |
| company_letter | Firemní psaní | Firemní psaní | CZECH_POST |
| formal_letter | Úřední psaní | Úřední psaní | CZECH_POST |
| formal_letter_standard | Úřední psaní standard | Úřední psaní standard | CZECH_POST |
| multipackage_explicit | Vícekusá zásilka | Vícekusá zásilka (explicitní - doobjednaná uživatelem) | CZECH_POST |
| car_delivery | Doručení do vozu | Doručení do vozu | ZAS
|
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šta (Starší verze) | WE|DO (InTime) | PPL (Starší verze) | GLS | Messenger | TNT | WE|DO (Uloženka) | Zásilkovna | Pošta Bez Hranic | Balíkonoš - GLS | Balíkonoš - WE|DO (InTime) | Balíkonoš - Messenger | Balíkonoš - TNT | DPD | GEIS | Slovenská pošta | Česká pošta | JAPO | PPL | Polská pošta (Poczta Polska) | Německá pošta (Deutsche post) | Maďarská pošta | Rakouská pošta | Švýcarská pošta | Nova Poshta (Ukraina) | Nizozemská pošta | Chorvatská pošta | Ruská pošta | Belgická pošta | Lucemburská pošta | US Post | Slovinská pošta | FedEx | Meest | UPS | DHL | Speedy | Hermes | Correos | MRW | FAN Courier | Royal Mail | InPost Kurier | Post Nord | Omniva | Colissimo | Rosan | Trans-o-flex | Express One | Cargus | Mondial | Econt | ACS | Bartolini | DAO | Fastway | Overseas | Aramex | 123 Kuriér |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| authentication | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| call_advice_unload | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| call_advice_load | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| back_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cod | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| carry | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| documents_back | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| direct_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| exchange_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| company_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_service | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| guaranteed_24 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hydraulic_lift | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| insurance | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| take_away | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_advice_unload | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_preadvice | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| evening_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| addressee_only | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sunday_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| think_green | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| day_definite | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| email_advice_unload | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_advice_load | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| email_advice_load | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| saturday_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| fragile | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| priority | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| morning_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| afternoon_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| credit_card | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| full_age | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| preview | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| signature | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| test_before_payment | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| advice_delivered | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| advice_damaged | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| advice_undelivered | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| advice_pod | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| advice_recipient | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_advice_recipient | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| email_advice_recipient | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sms_advice_delivered | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| email_advice_delivered | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| non_standard | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| store_3_days | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| store_7_days | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| store_10_days | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| store_90_days | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| store_10_working_days | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cumbersome | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| do_not_store | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| do_not_extend | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| valuable_package | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| diligently | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hand_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size_s | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size_m | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size_l | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size_xl | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size_xxl | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pallete | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| do_not_tilt | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| take_away_old | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| delivery_report | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| do_not_resend | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| third_person_pickup | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| gift | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| customs_documents | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recommended_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| blind_delivery | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| poste_restante | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| multipackage | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extended_storing | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| exw | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| age15 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| delivery_attempt | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| delivery_standard | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| delivery_premium | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| digital_documents | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| delivery_protocol_signature | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cod_explicit | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| return_label | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| recommended_delivery_standard | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| company_letter | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| formal_letter | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| formal_letter_standard | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| multipackage_explicit | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| car_delivery |
Cargo přeprava
Identifikátory cargo jednotek
Identifikátor přepravní jednotky se zasílá v požadavcích v parametru packages.containerCode. Počet stejných přepravních jendotek se určuje parametrem packages.containerItems. Minimální počet jednotek je 1.
Maximální počet jednotek je pak dán konkrétním přepravcem.
Tabulka obsahuje zároveň podporu kontejnerů pro cargo přepravce.
Seznam přepravních cargo jednotek
Identifikátor packages.containerCode | Název jednotky | GEIS Cargo | GEIS ID |
|---|---|---|---|
| CAR | Karton | KT | |
| EUP | Europaleta | FP | |
| OWP | Jednocestná paleta | EP | |
| HPA | Polopaleta | HP | |
| QPA | Čtvrtpaleta | VP | |
| BRL | Sud | FA | |
| GTB | Gitterbox | GP | |
| TIN | Plechovka | DO | |
| STA | Stojan | GS | |
| BUN | Svazek | BU | |
| CAN | Kanystr | KN | |
| CRT | Přepravka | KS | |
| ROL | Role | RO | |
| SCK | Pytel | SA | |
| TNK | Cisterna | TC | |
| ENV | Obálka | VG | |
| BAG | Sáček | BE | |
| BCK | Kbelík | EI | |
| COL | Colli | CC | |
| BSK | Koš | KO | |
| BTL | Lahev | FL | |
| PKG | Balík | BL | |
| UNW | Nezabaleno | UV | |
| NPA | Nepaletizované | NEP | |
| OTB | Na prkně | AB | |
| MCT | Mini kontejner A | AD | |
| AMP | Americká paleta | AM | |
| AMF | Americká lednička | AMF | |
| BBS | Big Box S | BBS | |
| BBL | Big Box L | BBL | |
| BBX | Big Box XL | BBX | |
| MCB | Mini kontejner B | BD | |
| MCC | Mini kontejner C | CD | |
| DBP | Dvojpaleta | DP | |
| OWW | Jednocestný obal | EB | |
| BU2 | Svazek | GE | |
| CNN | Konev | KA | |
| CUW | Zákaznické balení | KB | |
| HP2 | Polopaleta | KH | |
| CSB | Zákaznická specifikace B | KP | |
| PKS | Packet S | PKS | |
| PKL | Packet L | PKL | |
| PKX | Packet XL | PKX | |
| RST | Stojan role | RC | |
| RLS | Role S | ROS | |
| RLL | Role L | ROL | |
| RLX | Role XL | ROX | |
| STP | Standard paleta | SP | |
| PIE | Kus | ST | |
| DRU | Buben | TR | |
| TVX | TV XL | TXL | |
| XLP | XL paleta | XLP | |
| LNM | Long M | LM | |
| LNL | Long L | LL | |
| LNX | Long XL | LXL |
Omezení
Přepravce GEIS má počet cargo jednotek omezený na 99 ks v rámci zásilky. V jedné zásilce můžete objednávat například 3 europalety (EUP), 10 kanystrů (CAN), 2 role (ROL) a součet jednotek bude 15. Taková zásilka bude platná, protože se vejde do 99 kusů.
Doporučení pro cargo svozy
Pokud exportujete cargo a běžné zásilky pro stejné svozové místo, doporučujeme pro cargo ve Štíteknabalík.cz vytvořit kopii svozového místa a exportovat tyto cargo zásilky s touto kopií svozového místa.
Systém Štíteknabalík.cz totiž objednává svoz pro dané svozové místo jen jednou za den.
Tento fakt může být na škodu u některých přepravců, kteří požadují objednávku svozu pro každý druh přepravy (a defakto objednání dvou a více svozů pro jedno svozové místo).
Vytvoření a využívání kopie svozového místa pro cargo zásilky Vám umožní exportovat současně cargo i běžné zásilky v rámci dne a pro jedno svozové místo.
Přestože se bude jednat o kopii záznamu svozového místa, Štíteknabalík.cz díky tomu pro každý druh přepravy odešle objednávku samostatného svozu.
Track & Trace
Níže naleznete přehled všech identifikátorů využívaných ve Štíteknabalík.cz. 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
Štíteknabalík.cz sjednocuje stavy přepravců do vlastního číselníku 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 Štíteknabalík.cz.
- subCategory - Přesnější detail stavu hlavní kategorie
- state - Aktuální přesný stav zásilky v největším detailu
| category | subCategory | state | Název kategorie | Info |
|---|---|---|---|---|
| Stavy (Štíteknabalík.cz a API V3+V4): | ||||
| 1 | 1_0 | 1_0_0 | Rozpracované | Nově vytvořená zásilka (manuálně nebo metodou deliveries/POST), která ještě není uzavřená. |
| 2 | 2_0 | 2_0_0 | K odeslání | Uzavřené zásilky (manuálně nebo metodou deliveries/PATCH), které prozatím nebyly předány kurýrovi. |
| 3 | 3_0 | 3_0_0 | Odeslané | Zásilky převzaté kurýrem. K tomuto stavu dojde automaticky ihned po obdržení informace ze systému přepravce. |
| 3 | 3_1 | 3_1_0 | Doručované | |
| 3 | 3_1 | 3_1_1 | Předáno přepravci | |
| 3 | 3_1 | 3_1_2 | Na doručení dnes | U některých přepravců obsahuje text časové okno doručení zásilky |
| 3 | 3_1 | 3_1_3 | Na cestě | |
| 3 | 3_1 | 3_1_4 | K vyzvednutí | |
| 3 | 3_1 | 3_1_5 | Poslední den uložení | Upozornění, že zítra je poslední den kdy bude zásilka uložena k vyzvednutí |
| 3 | 3_2 | 3_2_0 | S výhradou přepravce | |
| 3 | 3_2 | 3_2_1 | Odmítnuto do přepravy | |
| 3 | 3_2 | 3_2_2 | Porucha | |
| 3 | 3_2 | 3_2_3 | Časové důvody | |
| 3 | 3_2 | 3_2_4 | Vyšší moc | |
| 3 | 3_2 | 3_2_5 | Ostatní | |
| 3 | 3_2 | 3_2_6 | Poškozeno | |
| 3 | 3_3 | 3_3_0 | S výhradou adresáta | |
| 3 | 3_3 | 3_3_1 | Odmítnuto převzetí | |
| 3 | 3_3 | 3_3_2 | Nesprávná adresa | |
| 3 | 3_2 | 3_3_3 | Nezastižen | |
| 3 | 3_3 | 3_3_4 | Změna dispozic | |
| 3 | 3_3 | 3_3_5 | Vracející se | |
| 3 | 3_3 | 3_3_6 | Ostatní | |
| 4 | 4_0 | 4_0_0 | Doručené | |
| 5 | 5_0 | 5_0_0 | Nedoručené | |
| 5 | 5_1 | 5_1_0 | Vráceno | |
| 5 | 5_2 | 5_2_0 | Nedoručeno | |
| 5 | 5_2 | 5_3_0 | Ztraceno | |
| 6 | 6_0 | 6_0_0 | Zrušené | |
| Flagy 1]: | ||||
| flag | important | Důležité 2] | Zásilky, které vyžadují pozornost jsou označeny příznakem Důležité. | |
| flag | delayed | V prodlení 2] | ||
| flag | notDelivered2Days | Mírně zpožděné doručení | ||
| flag | notDelivered3Days | Zpožděné doručení | ||
| flag | notPickedUp3Days | Nevyzvednuto ≥ 3 dny | ||
| flag | notPickedUp5Days | Nevyzvednuto ≥ 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í jsou dostupné pouze v aplikaci Štíteknabalík.cz. Ostatní flagy jsou dostupné v metodě deliveries/traces/GET.
Specifikace pro tisk štítků
Z API Štíteknabalík.cz lze získávat štítky řepravců ve třech formátech:
- 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ů.
- ZPL samostatně - Každý štítek má vlastní datový soubor.
- 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).
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 Štíteknabalík.cz.
| Přepravce | Formát1] | Rozměr (ZPL)2] | DPI3] | Arch A4 (PDF)4] | Rozměr5] | Orientace6] | Info |
|---|---|---|---|---|---|---|---|
| Česká pošta | PDF, ZPL | 10x17 | 300 | 4 | A6 105x148 | Na šířku | |
| WE|DO (InTime) | PDF, ZPL | 8x5 | 300 | 8 | A7 105x74 | Na šířku | |
| Zásilkovna | PDF, ZPL | 10x17 | 300 | 4 | A6 105x148 | Na šířku | 7] |
| WE|DO (Uloženka) | PDF, ZPL | 10x17 | 300 | 4 | A6 105x148 | Na výšku | |
| PPL | 4 | A6 105x148 | Na šířku | 8] | |||
| Balíkonoš - WE|DO (Intime) | PDF, ZPL | 8x5 | 300 | 8 | A7 105x74 | Na šířku | |
| Pošta bez hranic | PDF, ZPL | 10x14 | 300 | 4 | A6 105x148 | Na výšku | |
| DPD | PDF, ZPL | 10x15 | 300 | 4 | A6 105x148 | Na výšku | |
| GEIS | PDF, ZPL | 10x15 | 300 | 4 | A6 105x148 | Na šířku | |
| GLS | PDF, ZPL | 10x5, 10x17 | 300 | 4 | A8 74x52, A6 105x148 | Na šířku | 9] |
| Balíkonoš - GLS | PDF, ZPL | 10x5, 10x17 | 300 | 4 | A8 74x52, A6 105x148 | Na šířku | 9] |
| PPL (PPL Smart) | PDF, ZPL | 10x15 | 300 | 4 | A6 105x148 | Na šířku |
Vysvětlivky
1] Podporované formáty pro tisk přes API a Štíteknabalík.cz 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ů. Nově došlo k úprave pro požadavky SmartLabel.
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
Zde jsou tiskárny našich klientů, kteří využívají online tisk štítků přes aplikaci Štíteknabalík.cz.
Pokud máte tiskárnu fungující s Štíteknabalík.cz aplikací, která není na seznamu, budeme rádi, pokud se s námi podělíte o Vaše zkušenosti.
| Značka | Model | Formáty | DPI | Šíře role (formát)1 |
|---|---|---|---|---|
| Zebra | GK420D | PDF, ZPL | 203 | 108 mm (A6) |
| Zebra | ZD220 | PDF2, ZPL | 203 | 104 mm |
| Zebra | ZT411 | PDF2, ZPL | 203, 300, 600 | 114 mm |
| Zebra | ZT421 | PDF2, ZPL | 203, 300, 600 | 178 mm |
| Brother | DCP-7030 | arch | ||
| Brother | MFC-T910DW | arch | ||
| Brother | DCP-9020cdw | arch | ||
| HP | Pro MFP M477 | arch | ||
| HP | Laser Jet Pro MFP M26nw | arch | ||
| Canon | MF8350Cdn | arch | ||
| Xerox | Phaser 3020 | arch |
Vysvětlivky
1] Uvedené rozměry nesjou definitivní. Jedná se o nejčastěji používaný rozměr s daným zařízením.
2] Podpora formátu nebyla prozatím ověřena.
Upozornění
Tento seznam byl sestaven pro informativní účely. Ve většině případů Vám bude s Štíteknabalík.cz fungovat jakákoliv standardní tiskárna.