logo
Pro příjemce
icon-pro-příjemce
Pro příjemce
Informace pro příjemce zásilek
icon-sledovat-zásilku
Sledovat zásilku
Zjisti, kde se tvoje zásilka nachází
icon-one-courier
One Courier
Informace o službě doručení kurýrem
icon-one-box
One Box
Informace o metodě doručení do výdejního boxu
icon-one-point
One Point
Informace o metodě doručení na výdejní místo
icon-mobilní-aplikace
Mobilní aplikace
Všechny tvé zásilky na jednom místě
Pro firmy
icon-pro-firmy
Pro firmy
Seznamte se s naší nábídkou služeb
icon-pro-e-shopy
Pro e-shopy
Nabídka služeb pro provozovatele e-shopu
icon-další-spolupráce
Další spolupráce
Jak se stát výdejním místem, provozovat One Box či doručovat naše zásilky
icon-ceník
Ceník
Základní cenová nabídka pro neregistrované zákazníky
icon-instrukce-pro-odeslání-zásilky
Instrukce pro odeslání zásilky
Jak odeslat zásilku s One by Allegro
icon-napojení
Napojení
Informace o možnostech napojení
icon-ke-stažení
Ke stažení
Stáhni si loga, dokumenty a podpůrné materiály
icon-doručení-do-druhého-dne
Doručení do druhého dne
Produkt D+1 doručení s kompenzací
O nás
icon-o-nás
O nás
Seznam se s One by Allegro
icon-aktuality
Aktuality
Zjisti co je u nás nového
icon-faq
FAQ
Najdi odpovědi na často kladené otázky
Vyhledat výdejní místaKontaktSoutěž pro e-shopy
Přihlásit se
Portál Zásilky
Portál One by Allegro
Začátek naší spolupráce
REGISTRACE E-SHOPU
Portál ZásilkyPortál One by Allegro
Začátek naší spolupráce
REGISTRACE E-SHOPU

Upozornění!

🚚 Stěhujeme ostravské depo: od 30. 3. 2026 nás nově najdete na adrese: CTPark Ostrava Hrušov, Bohumínská 710/198, 711 00, Ostrava - Hrušov

  1. Onedelivery
  2. Pro Firmy
  3. Instrukce pro odeslání zásilky

Intergrace API 3.0

 

REST API v3 je naše nejmodernější rozhraní pro správu logistiky. Nahrazuje starší verze a přináší stabilní, rychlé a škálovatelné řešení pro propojení vašeho systému s ekosystémem One by Allegro.

 


Nezbytností spolupráce s e-shopem je výběr
vhodného rozhraní napojení. 

One by Allegro ti nabízí hned několik možností,
dle potřeb tvého e-shopu.

 

  • awating package 800 x305


Proč přejít na API 3.0?

 


Proč přejít na API 3.0?

 

Plná automatizace

Spravujte celý životní cyklus zásilky – od vytvoření štítku až po objednání svozu – přímo z vašeho rozhraní.

Moderní standard

Postaveno na principech REST pro snadnou implementaci a vysokou kompatibilitu.

Budoucí funkce

Všechna nová vylepšení a logistické funkce jsou dostupné prioritně pouze ve verzi 3.0.

Zde najdete informace o změnách v API 3.0

  • 460x255

Zde najdete informace o změnách v API 3.0

DOKUMENTACE WIDGETU
  • 460x255

Odpovědi na jednom místě

Najděte odpovědi na nejčastější otázky týkající se integrace API 3, které vám pomohou lépe pochopit její fungování, možnosti využití a proces implementace.

 

  • awaiting for package one delivery

Odpovědi na jednom místě

Najděte odpovědi na nejčastější otázky týkající se integrace API 3, které vám pomohou lépe pochopit její fungování, možnosti využití a proces implementace.

  • awaiting for package one delivery

Obecné informace a přístup k API

Kde najdu dokumentaci k testovacímu API?
toggle visibility

Dokumentaci naleznete na této stránce.


Jaká je URL pro testovací prostředí API?
toggle visibility

https://api.onedelivery.tech.allegrosandbox.pl


Kde najdu dokumentaci k produkčnímu API?
toggle visibility

Dokumentaci naleznete zde.


Jaká je URL pro produkční prostředí API?
toggle visibility

https://api.onedelivery.tech/


Jak získám testovací přihlašovací údaje?
toggle visibility

Pro testovací přihlašovací údaje se prosím obraťte na podporu pro e‑shopy na adrese eshop‑onecz@allegro.com


Máte webové rozhraní pro vytváření zásilek?
toggle visibility

Ne, ale pracujeme na tom, tak nás sledujte!

Autorizace a technická integrace

Chyba 400 – Bad Request při vytváření zásilky
toggle visibility

Použili jste produkční přístupy, úspěšně získali token přes /auth/token, ale při vytváření zásilky dostáváte chybu 400 - Bad Request se zprávou: "Authorization information is invalid"?

Zkontrolujte instrukce pro autorizaci API 3.0.


Je možné stáhnout více štítků v rámci jednoho API požadavku?
toggle visibility

Ano, stačí uvést všechna ID zásilek v požadavku zde.


Jak vypadá ukázkový požadavek na POST /parcels?
toggle visibility

Ukázkový požadavek naleznete zde.

Zásilky, štítky a sledování

Mohu stahovat štítky v různých formátech?
toggle visibility

Ano, podporovány jsou PDF a ZPL.


Jsou rozměry balení povinné?
toggle visibility

Ano.


Je implementována metoda pro smazání/zrušení zásilky?
toggle visibility

Ne.


Existuje odkaz pro sledování (LP) zásilky?
toggle visibility

Ano, odkaz naleznete zde.


Jaké jsou možné hodnoty stavu zásilky?
toggle visibility

Seznam naleznete v souboru statuses.csv

Svozy a výdejní místa

Je shipmentsId v metodě svozu (pickups) skutečně volitelné?
toggle visibility

Ano.


Je možné získat výdejní místa z jiné země než CZ?
toggle visibility

 V současné době je možné získat výdejní místa pro CZ a SK.

 


Mohu vyhledat výdejní místo podle jeho ID?
toggle visibility

Ne, pouze celý seznam najednou.

Validace a řešení chyb

Validace telefonních čísel
toggle visibility

Dostáváte chybu: "Invalid receiver phone number for country", ale čísla odesílatele i příjemce jsou platná slovenská čísla (předvolba +421 + 9 číslic)? Máme pokročilejší validaci telefonních čísel. Číslo v logu není pro Slovensko platné – po kódu země musí následovat platná předvolba operátora. Například: +421 950 112 345.

 


Můžete nám poslat všechny zprávy VALIDATION_ERROR? Potřebujeme je pro zobrazení uživatelům.
toggle visibility

VALIDATION_ERRORS (Validační chyby):

Chybí povinný parametr: {0}
Neplatná hodnota {0} pro parametr {1}
Nelze zpracovat zadaný vstup
Musí obsahovat pouze znaky Unicode, mezery, pomlčky a apostrofy
Musí obsahovat pouze alfanumerické znaky, mezery, čárky nebo tečky
Musí být platné české nebo slovenské telefonní číslo
Musí být platná e-mailová adresa
Musí obsahovat 1 až 3 číslice, volitelně následované malým písmenem
Musí obsahovat pouze číslice
Musí obsahovat přesně tři písmena
Pole musí být ve formátu data RRRR-MM-DD
Poštovní směrovací číslo v dané zemi neexistuje
Musí být uvedeno jméno a příjmení nebo název společnosti
Kombinace města, ulice, čísla popisného a čísla bytu musí být platná. Maximální délka je 105 znaků.
Může být vyplněno pouze jedno z polí: {fields}
Neplatné telefonní číslo příjemce pro danou zemi
Velikost musí být mezi 0 a {0}

Konkrétní chybové kódy:

SHIPMENT_NOT_FOUND: Zásilka s {0}: {1} nebyla nalezena
PICKUP_NOT_FOUND: Svoz s ID {0} nebyl nalezen
UNSUPPORTED_DELIVERY_METHOD: Nepodporovaná metoda doručení: {0} pro zásilku z {1} do {2}
INVALID_DATE_RANGE: Rozsah dat musí být mezi 1 a {0} dny
PICKUP_DATE_IS_TOO_EARLY: Minimální datum svozu je {0}
PICKUP_DATE_IS_A_HOLIDAY: Zadané datum svozu připadá na svátek
INVALID_SENDER_ADDRESS: Zadaná adresa odesílatele neodpovídá žádnému z registrovaných míst svozu pro tohoto zákazníka. Ujistěte se, že adresa je jedna z následujících: {0}
INVALID_RECEIVER_ADDRESS: Zadaná adresa příjemce neodpovídá žádnému z registrovaných míst svozu pro tohoto zákazníka.
INVALID_PICKUP_POINT_ID: Neplatné ID výdejního místa
INVALID_COD_CURRENCY: Neplatná měna dobírky pro zemi příjemce
INVALID_COD_AMOUNT: Neplatná částka dobírky
INVALID_INSURANCE_CURRENCY: Neplatná měna pojištění pro zemi příjemce
INVALID_INSURANCE_AMOUNT: Neplatná částka pojištění
INVALID_PACKAGE_WEIGHT: Hmotnost balíku {0} musí být mezi 0 a {1}
INVALID_PACKAGE_VOLUMETRIC_WEIGHT: Volumetrická hmotnost balíku {0} musí být mezi 0 a {1}
INVALID_PACKAGE_LONGEST_DIMENSION: Nejdelší rozměr balíku {0} nesmí být větší než {1}
INVALID_PACKAGE_DIMENSIONS: Balík {0} se musí vejít do rozměrů {1} x {2} x {3}
ADDITIONAL_SERVICE_NOT_ALLOWED: Doplňková služba {0} není povolena pro metodu doručení: {1}
INVALID_PACKAGES_COUNT: Počet balíků nemůže být větší než {0} pro metodu doručení: {1}
INVALID_DECIMAL_FORMAT: Neplatný formát desetinného čísla
COD_NOT_AVAILABLE_IN_COUNTRY: Dobírka není dostupná pro zemi {0} a metodu doručení: {1}

 

  • 160x160

Chcete s integrací poradit?

Ozvěte se nám.

 

Napiš nám
Napiš nám
  • 4986 x224
One by Allegro
Sledujte násFacebookLinkedInInstagram
Kontaktujte násNejčastější dotazy
AppStorePlayStore

  • Ochrana osobních údajů zákazníků
  • Všeobecné obchodní podmínky
  • Zásady používaní cookie souborů
Copyrights © 2026 Všechna práva vyhrazena Allegro Retail a.s.