Úvod | Segat Sync — Elall integrácia

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_id}`	Jeden produkt
`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.