Chybové stavy

HTTP kódy

Kód	Kedy
200	Úspech (sync aj acknowledge); môže obsahovať `unknown_products > 0`
400	Neplatný request — validácia, príliš veľa položiek v dávke, duplicitný `(ean, stock_code)` v batchi, ambiguous kľúč v DB
401	Chýbajúca alebo neplatná hlavička `X-API-Key`
404	Objednávka neexistuje (acknowledge)
409	Objednávka už acknowledge s iným `elall_reference`
422	Chyba validácie tela — chýba alebo je prázdny `ean` / `stock_code`
500	Interná chyba servera alebo nenakonfigurovaný `ELALL_API_KEY` na strane Segat

Sync produktov

Odpoveď pri úspechu vždy obsahuje success: true, products_received, products_updated, unknown_products.
unknown_products > 0 — časť kľúčov (ean, stock_code) nie je v product_catalog; pozri Produkty a polia.
Pri 400 v detail je text chyby (napr. prekročený limit 5000 položiek, duplicitný kľúč v batchi).

Retry

Operácia	Odporúčanie
Sync po doklade	Rovnaké `request_id` a rovnaké absolútne hodnoty
Acknowledge	Rovnaké `elall_reference` je idempotentné
Poll	Bezpečné kedykoľvek; filtrujte `pending_elall`

Pri timeoute alebo 5xx opakujte sync; nepublikujte doklad v Elall ako synced, kým nedostanete úspešnú odpoveď alebo nevyrátate manuálny postup.