Skip to navigation

Ú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:

X-API-Key: <váš-api-kľúč>

API kľúč vám bude poskytnutý samostatne zabezpečeným spôsobom.

Base URL

ProstredieURL
Test vývojhttps://segat-test.webland.sk/
ProdukciaURL bude dodaná po schválení testu

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)

MetódaCestaÚčel
POST/api/v1/elall/products/syncDávková synchronizácia produktov
PUT/api/v1/elall/products/itemJeden produkt (stock_code v tele, voliteľne ean)
GET/api/v1/elall/ordersNepotvrdené a nezrušené objednávky od najnovšej
POST/api/v1/elall/orders/{order_number}/acknowledgePotvrdenie prevzatia podľa deväťmiestneho čísla objednávky

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 413 zmenšite dávku; aj dávka do 10000 položiek musí splniť limit veľkosti HTTP tela.
  • Potvrdenie: HTTP 200 a success=true znamenajú 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_context pre históriu a monitoring.
  • Neaplikuje delty na segat_quantity — vždy pošlite aktuálne množstvo na sklade Segat po doklade.