Skip to navigation

Chybové stavy

HTTP kódy

KódKedy
200Pri produktoch bezpečné prijatie dávky, vrátane uložených odmietnutých riadkov; pri objednávkach úspešné načítanie alebo potvrdenie
400Neplatný since alebo nepodporovaný elall_status pri objednávkach; pri produktoch NaN alebo nekonečno v číselnej hodnote
401Neplatná hodnota hlavičky X-API-Key
404Objednávka neexistuje alebo je zrušená (acknowledge)
409Objednávka už acknowledge s iným elall_reference
413Príliš veľké telo požiadavky; zmenšite dávku. Limit 10000 položiek nezaručuje splnenie limitu veľkosti HTTP tela.
422Neplatné JSON telo alebo obálka produktového requestu (napr. prázdne products, viac ako 10000 riadkov, neplatný request_id / sync_context); chýbajúca povinná hlavička; pri objednávkach neplatné deväťmiestne order_number, prázdny elall_reference alebo príliš dlhá poznámka
500Interná chyba Synchronizácie alebo nenastavený prístupový kľúč
502Administrácia je nedostupná alebo neposkytla platné údaje pre Synchronizáciu
503Prepojenie Administrácie so Synchronizáciou nie je nastavené alebo zapnuté

Sync produktov

  • success: true potvrdzuje prijatie, nie správnosť všetkých údajov ani dokončenie importu. Uložte request_id a batch_id.
  • products_received zahŕňa všetky riadky. products_rejected uvádza odmietnuté riadky známe v okamihu odpovede; neskoršie výsledky spracovania sú v Administrácii. products_excluded uvádza vylúčené disky.
  • products_updated=0 je očakávané potvrdenie príjmu. unknown_products=0 zostáva pre kompatibilitu; nové skladové číslo sa vytvorí ako nový produkt, ak má platné údaje vrátane názvu.
  • Duplicitné stock_code, chýbajúce povinné pole produktu alebo záporná cena či zásoba sa odložia ako chybné riadky. Neodmietnu celú inak platnú dávku. Platné produkty pokračujú.
  • Neplatná obálka requestu vráti 422; nič sa týmto requestom neprijme. Pri chybe spojenia / timeoute nemusí konektor vedieť, či bolo prijatie dokončené, preto zopakuje pôvodný request.

Podrobné pravidlá sú v Produkty a polia; dôkaz, dopad a postup opravy v Monitoring a opravy.

Retry

OperáciaOdporúčanie
Sync po chybe siete / timeoute / 5xxPresne rovnaké telo vrátane request_id a sync_context; uložiť vrátené batch_id
413 alebo 422Opraviť veľkosť alebo obálku requestu; neopakovať bez zmeny rovnakú neplatnú požiadavku. Pri rozdelení denného exportu zachovať konzistentné číslovanie všetkých častí.
Oprava chybných produktových údajovOpraviť v Elalle a poslať nový obsah; pri oprave denného chunku zachovať jeho exportový kontext
AcknowledgeRovnaké elall_reference je idempotentné
PollBezpečné kedykoľvek; vracia automaticky len nepotvrdené a nezrušené objednávky. Deduplikujte podľa order_number.

Pri timeoute alebo 5xx opakujte operáciu. Ak už doklad v Elalle vznikol, opakujte acknowledge s rovnakým elall_reference; nevytvárajte nový doklad. Pri 409 overte existujúce prepojenie objednávky s dokladom v Administrácii.

Pri produktovej retry nevytvárajte nové ID a nenahrádzajte pôvodný obsah novšími hodnotami. Rovnaké ID s iným obsahom je nová prijatá aktualizácia. Aktualizácie toho istého stock_code sa aplikujú v poradí prijatia; API bez zdrojového času/verzie nevie rozpoznať oneskorene doručený starý dokument.