Přehled změn v API 3

Co se mění?

1. Veřejný přístup k výdejním místům

Endpoint /parcels/points je nyní dostupný bez nutnosti přihlášení.

• Popis změny: Seznam výdejních míst lze nyní volat bez autorizačního tokenu v hlavičce (header) požadavku.
• Hlavní výhoda: Výrazně jednodušší implementace mapových podkladů a výběru míst (point pickers) na vašem frontendu. Odpadá nutnost řešit bezpečnostní tokeny pro veřejně dostupná data.

2. Validace adres pro doručení kurýrem (Door-to-Door)

Zpřísnili jsme kontrolu adres u zásilek typu „2_door“ v endpointu POST /parcels/shipments.

• Popis změny: Pokud zadaná adresa příjemce neexistuje nebo je neplatná, systém požadavek automaticky zamítne a zásilku nevytvoří.
• Chybový kód: WRONG_RECEIVER_ADDRESS
• Hlavní výhoda: Prevence chyb hned v zárodku. Vyhnete se tisku štítků s nesprávnými údaji, čímž eliminujete riziko neúspěšných doručení a zbytečné náklady spojené s vratkami.

3. Sjednocení kódu země odesílatele na CZ

Změnili jsme pravidla pro kódy zemí v našem API. Od nynějška můžete odesílat zásilky pouze z České republiky (CZ). Odesílání zásilek ze Slovenska (SK) již není možné.

V endpointu pro zásilky (/parcels/shipments) přijímá pole sender.countryCode nově pouze hodnotu CZ. Dříve bylo možné použít CZ i SK.

Stejné pravidlo platí pro endpoint pro svozy (/parcels/pickup). Pole pickupAddress.countryCode nyní také přijímá pouze kód CZ.

Co to pro vás znamená?

Aktualizujte své nastavení: Ujistěte se prosím, že váš systém odesílá kód země CZ u všech nových zásilek a svozů.
Chybová hlášení: Pokud se pokusíte použít kód SK, API vrátí chybu a váš požadavek nebude zpracován.
Doručení zůstává stejné: Tato změna se týká pouze adresy odesílatele. Své zásilky můžete i nadále posílat zákazníkům do ostatních zemí jako obvykle.
Správný příklad:
Ve vašem kódu by kód země měl vypadat takto: "countryCode": "CZ"