Skladové doklady
Skladové doklady sa účtujú v Elalle. Po zaúčtovaní konektor odošle do Synchronizácie aktuálny stav skladu Segat, ceny a stav dotknutých produktov. Tieto údaje slúžia na aktualizáciu produktov v Administrácii.
Kedy volať API
Výber endpointu
Zostavenie payloadu na riadok
Pre každý riadok dokladu, ktorý má ovplyvniť sklad Segat:
stock_code(povinné) a voliteľnýean— spolu tvoria identitu. Neskoršie doplnenie pôvodne prázdneho EAN aktualizuje ten istý produkt. Už známy EAN pri tom istom stock_code nemeňte.segat_quantity— aktuálne množstvo na skladesegatv Elall po zaúčtovaní (nie prírastok).status,catalog_price,eshop_price— načítať z Elall pre daný produkt (povinné v API).- Katalógové polia (
name,brand, …) — neuvádzať, ak sa pri doklade nemenia.
Príklad jedného riadku v dávke:
Dávkový request
request_id: číslo dokladu (rovnaké pre všetky chunky jednej príjemky).sync_context:stock_receipt/stock_issue/customer_salepodľa typu dokladu — umožní priradiť prenos k pôvodnému dokladu.- Po každom chunku spracovať potvrdenie
successabatch_id;products_updated=0označuje príjem pred spracovaním. - V Elall uložiť stav doručenia dokladu podľa prijatia; výsledok aktualizácie produktov sleduje Administrácia.
products musí obsahovať aspoň jeden riadok. Ak doklad nemá dotknuté produkty, produktový request neodosielajte. Ceny sú v EUR bez DPH; catalog_price sa zachováva pre kompatibilitu, predaj používa eshop_price a DPH 23 %. Medzi prijatými aktualizáciami sklad znižujú objednávky e-shopu; ďalší čerstvý sync nastaví absolútny fyzický stav z Elallu.
Skladové zmeny odosielajte aj počas doručovania denného katalógu. Konektor musí zachovať poradie zmien každého skladového čísla; pri retry zopakujte pôvodné uložené telo, nie nový snapshot produktu.
Jednotlivý request
PUT /api/v1/elall/products/item — stock_code je v tele povinný; ean voliteľný.
Do toho istého tela pridajte request_id a sync_context; pri retry ich zachovajte spolu s pôvodnými produktovými hodnotami. Pravidlá bezpečného prijatia sú rovnaké ako pri POST.
Pseudokód konektora
Hodnoty source_type v sync_context: stock_receipt, stock_issue, customer_sale, catalog_sync, stock_adjustment, manual, scheduled, other.
Odmietnuté produktové riadky a následné opravy sa sledujú v Monitoring a opravy. Úspešné doručenie dokladu neoznačujte ako úspešné dokončenie aktualizácie všetkých produktov.