Aktualizace stavů

Aktualizace stavů zásilek je klíčovým prvkem v Parcelsync. Tato část Vám ukáže, jak přistupovat ke stavům zásilek ve vašem projektu.

Vzhledem k datovému charakteru zásilky v Parcelsync je nutné pochopit, že aktualizujeme stavy pouze balíčků, které jsou zahrnuty v rámci zásilky (více zde).

Stavy, kterých balíčky nabývají jsou:

• DATA_SENT - Data o balíčku byla odeslána přepravci
• ACCEPTED_BY_CARRIER - Balíček byl přijat přepravcemmístě
• IN_TRANSIT - Balíček je v pohybu
• OUT_FOR_DELIVERY - Balíček je na cestě k doručení
• DELIVERED - Balíček byl doručen
• PICKED_UP - Balíček byl vyzvednut
• DELIVERY_FAILED - Doručení se nezdařilo
• RETURNED - Balíček byl vrácen odesílateli
• CANCELED - Balíček byl zrušen
• EXCEPTION - Balíček vyžaduje zvláštní pozornost, došlo k vyjímce

Automatické aktualizace

Automatické aktualizace stavů zásilek jsou prováděny na základě informací, které nám poskytují přepravci. Tyto informace jsou zpracovány a stavy převedeny do jednotného formátu, který je následně dostupný prostřednictvím UI a API. U jednotlivých stavů i ukládáme metadata (metadata), které nám přepravci předávají.

PPL metadata

• services - pole obsahující služby a jejich ceny pro daný balíček (mýto, palivový poplatek, atd.)
• deliveryFeature - informace o doručení (datum delivDate, jméno příjemce delivPerson)
• paymentInfo.invoiceNumber - číslo faktury

Česká Pošta metadata

• postOffice - kód/PSČ pošty, kde došlo ke stavu
• postOfficeName - název pošty, kde došlo ke stavu
• statusDescription - popis stavu zásilky (od ČP)

Packeta

• isReturning
• externalTrackingCode - kód zásilky u externího přepravce
• storedUntil - datum, do kdy je zásilka uložena

Získání stavu zásilek dle sledovacího čísla

Pro vybrané přepravce (PPL) je možné získat stav zásilek dle sledovacího čísla. Tento stav je získáván přímo od přepravce a je dostupný prostřednictvím API viz dokumentace api. Lze tak získat aktuální stav zásilky, která nebyla odeslána přes Parcelsync.