> 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.

# Úvod

> Segat Sync API pre Elall konektor — autentifikácia, base URL a limity.

Segat Sync je integračný server medzi **Elall** (účtovníctvo / sklad) a **Segat eshopom**. Namespace `/api/v1/elall` slúži výhradne pre implementáciu konektora v Elall.

## Autentifikácia

Každý request musí obsahovať hlavičku:

```
X-API-Key: <ELALL_API_KEY>
```

Hodnotu `ELALL_API_KEY` vám bola poskytnutá zabezpečeným oddeleným spôsobom.

## Base URL

| Prostredie | URL                                |
| ---------- | ---------------------------------- |
| Test vývoj | `https://segat-test.webland.sk/`   |
| Produkcia  | URL bude dodaná po schváleni testu |

V sekcii **Elall API** (code snippety) vyber server v hornom rohu — predvolene **Test vývoj** (`https://segat-test.webland.sk`). Po spustení produkcie pribudne server **Produkcia** (nastaví sa v `OPENAPI_SERVER_URL_PRODUCTION` na strane Segat Sync).

## Endpointy (prehľad)

| Metóda | Cesta                                         | Účel                                                 |
| ------ | --------------------------------------------- | ---------------------------------------------------- |
| `POST` | `/api/v1/elall/products/sync`                 | Dávková synchronizácia produktov                     |
| `PUT`  | `/api/v1/elall/products/item`                 | Jeden produkt (`stock_code` v tele, voliteľne `ean`) |
| `GET`  | `/api/v1/elall/orders`                        | Poll objednávok                                      |
| `POST` | `/api/v1/elall/orders/{order_id}/acknowledge` | Potvrdenie evidencie v Elall                         |

Detailné schémy a interaktívne príklady sú v sekcii **Elall API** v bočnom menu.

## Limity

* **Dávka produktov:** max `min(MAX_SYNC_PRODUCTS, MAX_CATALOG_SYNC_PRODUCTS)` — typicky **5000** položiek na jeden `POST …/products/sync`
* **Veľkosť tela:** `REQUEST_BODY_MAX_MB` (default 50 MB)
* **Timeout:** odporúčaný proxy timeout **300 s** pre veľké sync

Pri veľkých prenosoch rozdeľte dáta na chunky so **rovnakým** `request_id` (číslo prenosu).

## Čo API nerobí

* Neprijíma typ skladového dokladu ani číslo riadka — len absolútny stav produktu po zaúčtovaní.
* Neaplikuje delty na `segat_quantity` — vždy pošlite **aktuálne množstvo** na sklade Segat po doklade.
* Audit a timeline zmien sú len pre interný admin (`/api/v1/admin/elall/…`), nie pre konektor.