Úvod
Synchronizácia zabezpečuje prenos údajov medzi Administráciou e-shopu Segat a Elallom (účtovníctvo / sklad). Elall cez API odosiela produkty, ceny a skladové zásoby. Opačným smerom preberá objednávky a potvrdzuje ich zaevidovanie.
Autentifikácia
Každý request musí obsahovať hlavičku:
API kľúč vám bude poskytnutý samostatne zabezpečeným spôsobom.
Base URL
V sekcii Elall API vyberte prostredie pre príklady požiadaviek — predvolene Test vývoj (https://segat-test.webland.sk). Po spustení produkcie pribudne prostredie Produkcia.
Endpointy (prehľad)
Detailné schémy a interaktívne príklady sú v sekcii Elall API v bočnom menu.
Objednávkový tok a mapovanie typov, dopravy, poplatkov a adries opisuje návod Objednávky. Referencie endpointov: Poll a Acknowledge.
Limity
- Kódovanie: celé JSON telo UTF-8,
Content-Type: application/json. Podporované staršie kódovania sa kvôli kompatibilite konvertujú s upozornením; pravidlá sú v návode Produkty a polia. - Dávka produktov: 1–10000 položiek na jeden
POST …/products/sync. - Veľkosť požiadavky: pri
413zmenšite dávku; aj dávka do 10000 položiek musí splniť limit veľkosti HTTP tela. - Potvrdenie: HTTP 200 a
success=trueznamenajú bezpečné prijatie. Aktualizácia produktov pokračuje na pozadí; konektor nečaká na dokončenie celého importu. - Chybný produkt: odloží sa na opravu, ostatné platné riadky pokračujú. Chybná obálka requestu sa odmietne celá.
Pri veľkých prenosoch rozdeľte dáta na chunky so rovnakým request_id (číslo prenosu, najviac 64 znakov). Pri dennom kompletnom katalógu doplňte spoločný sync_context.source_ref a note: "Chunk N/M"; podrobnosti sú v Produkty a polia.
Pri hlásení problému uveďte stock_code, request_id a batch_id. Podklady k oprave dodaných údajov opisuje Monitoring a opravy.
Čo API nerobí
- Neúčtuje skladové doklady. Ich typ a referenciu možno preniesť v existujúcom
sync_contextpre históriu a monitoring. - Neaplikuje delty na
segat_quantity— vždy pošlite aktuálne množstvo na sklade Segat po doklade.