> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.elall.webland.sk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.elall.webland.sk/_mcp/server.

# Chybové stavy

> HTTP kódy, validácia a správanie pri chybách Elall API.

## 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 `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](/docs/produkty-polozky#neznáme-produkty).
* 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.