Přeskočit na hlavní obsah
For any questions, feel free to contact our integrations team at integrations@packeta.com

Nedostupná výdejní místa

Výdejní místa a boxy mohou být někdy dočasně nedostupné z důvodu omezené kapacity. Pokud se výdejní místo stane mezi nákupem a zpracováním objednávky nedostupným, vytvoření zásilky může selhat.

Pokus o vytvoření zásilky na takové místo API vrátí chybu:

<response>
<status>fault</status>
<fault>PacketAttributesFault</fault>
<string>Failed to validate attributes. See detail.</string>
<detail>
<attributes>
<fault>
<name>addressId</name>
<fault>Order nr. 1234: Final pick up point is not valid. Pick up point either does not exist or does not accept parcels.</fault>
</fault>
</attributes>
</detail>
</response>

Tato chyba znamená, že zvolené výdejní místo není validní – buď neexistuje, nebo momentálně nepřijímá zásilky.

Proč k tomu dochází?​

Výdejní místa a boxy mají omezenou kapacitu. V období zvýšeného objemu zásilek (např. Vánoce, Black Friday) mohou dočasně přestat přijímat nové zásilky. Taková místa jsou označena jako dočasně nedostupná (temporarily unavailable) a nejsou nabízená ve feedech ani se nezobrazují zákazníkům ve widgetu. Dostupnost je dynamická a může se během dne několikrát změnit podle změn kapacity.

note

Negarantujeme konkrétní čas, kdy bude výdejní místo znovu dostupné.

Jak chybě předcházet​

Vytvářejte zásilky okamžitě​

Zásilku vytvořte co nejdříve po potvrzení objednávky. Odkládání zvyšuje riziko, že zvolené výdejní místo bude nedostupné.

Zkontrolujte váš <createPacket> request​

Při vytváření zásilek pro výdejní místa externích dopravců se ujistěte, že v requestu používáte správné atributy.

  • <addressId> musí obsahovat ID dopravce, nikoli ID výdejního místa
  • <carrierPickupPoint> musí obsahovat ID výdejního místa dopravce

Špatné mapování těchto atributů je častou příčinou chyb při vytváření zásilek.

Pravidelně aktualizujte data feedy​

Používání neaktuálních dat zvyšuje pravděpodobnost, že si zákazník vybere nedostupné výdejní místo.

Jak často aktualizovat​

Pro Packeta feedy:

  • Minimální frekvence: 1× denně
  • Doporučeno: 4× denně mezi 7:00–21:00
  • Sezóna (říjen–prosinec): až každou hodinu mezi 7:00–21:00

Pro feed výdejních míst externích dopravců:

  • Doporučeno: 1× denně po 6:00
Jak feedy volat efektivně

Volání feedů plánujte mimo celé hodiny (např. 14:23, 17:37, 19:56). Častější volání než jednou za hodinu nemá smysl kvůli cachování.

Používejte atributy dostupnosti z feedu​

Při zobrazování výdejních míst vždy respektujte atributy dostupnosti:

  • displayFrontend - určuje, zda se výdejní místo zobrazuje zákazníkovi (0/1)
  • status- aktuální status a jeho popis
"displayFrontend": "1",
"statusId": "1",
"description": "In operation"
note

Atribut displayFrontend je dostupný ve všech feedech, zatímco status je dostupný pouze v Packeta feedech.

Otázky a odpovědi​

Proč si zákazník mohl vybrat výdejní místo v košíku, ale mě teď nejde vytvořit zásilka?

Dostupnost výdejních míst je dynamická a závisí na aktuální kapacitě.

Místo, které bylo dostupné během nákupu, se může krátce po vytvoření objednávky stát dočasně nedostupným, zejména v období zvýšeného objemu zásilek.

Jak často se dostupnost výdejních míst aktualizuje?

Neexistuje pevný interval aktualizace.

Dostupnost odráží reálnou provozní kapacitu a může se průběžně měnit během dne.

Dá se této situaci úplně zabránit?

Ne — dočasná nedostupnost je běžnou součástí provozu a nelze jí zcela zabránit.

Dodržováním doporučení v tomto článku však můžete výrazně snížit počet takových případů.

Kdy je výběr výdejního místa definitivní?

Jakmile úspěšně vytvoříte zásilku, kapacita je rezervovaná na výdejním místě.

KONTAKTUJTE NÁS

Nenašli jste, co hledáte? Obraťte se na náš integrační tým na integrations@packeta.com.