Skip to navigation

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

MomentAkcia
Doklad v stave draftNevolať sync — pri storne v Elall by bol stav v Segat nesúladný
Doklad zaúčtovanýZostaviť riadky a odoslať sync
Chyba HTTP / timeoutRetry s rovnakým request_id (idempotentný absolútny stav)

Výber endpointu

Po zaúčtovaní dokladu
│
├─ 1 riadok (typ. malá výdajka / predaj) ──► PUT /api/v1/elall/products/item
│
└─ N riadkov (typ. príjemka) ──► POST /api/v1/elall/products/sync
│
└─ ak N > 10000: rozdeliť na chunky

Zostavenie payloadu na riadok

Pre každý riadok dokladu, ktorý má ovplyvniť sklad Segat:

  1. 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.
  2. segat_quantity — aktuálne množstvo na sklade segat v Elall po zaúčtovaní (nie prírastok).
  3. status, catalog_price, eshop_price — načítať z Elall pre daný produkt (povinné v API).
  4. Katalógové polia (name, brand, …) — neuvádzať, ak sa pri doklade nemenia.

Príklad jedného riadku v dávke:

{
"ean": "5452000792440",
"stock_code": "ELALL-SKU-001",
"status": "active",
"segat_quantity": 48,
"catalog_price": 129.9,
"eshop_price": 119.0
}

Dávkový request

{
"request_id": "PR-2026-00123",
"sync_context": {
"source_type": "stock_receipt",
"source_ref": "PR-2026-00123",
"note": "Chunk 1/2"
},
"products": [{
"stock_code": "ELALL-SKU-001",
"status": "active",
"segat_quantity": 48,
"catalog_price": 129.9,
"eshop_price": 119.0
}]
}
  • request_id: číslo dokladu (rovnaké pre všetky chunky jednej príjemky).
  • sync_context: stock_receipt / stock_issue / customer_sale podľa typu dokladu — umožní priradiť prenos k pôvodnému dokladu.
  • Po každom chunku spracovať potvrdenie success a batch_id; products_updated=0 označ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

on_document_posted(document):
lines = affected_stock_lines(document)
rows = []
for line in lines:
p = load_product_from_elall(line)
rows.append({
ean: p.ean,
stock_code: p.stock_code,
status: p.status,
segat_quantity: p.segat_quantity_after_document,
catalog_price: p.catalog_price,
eshop_price: p.eshop_price,
})
if not rows:
return
request_id = document.number
parts = chunks(rows, max_size=10000)
for index, chunk in enumerate(parts, start=1):
context = {
source_type: document.sync_source_type,
source_ref: document.number,
note: "Chunk " + index + "/" + len(parts),
}
if len(chunk) == 1 and is_single_line_issue(document):
request = merge(chunk[0], { request_id, sync_context: context })
PUT /api/v1/elall/products/item with request
else:
request = { request_id, sync_context: context, products: chunk }
POST /api/v1/elall/products/sync with request
# Pri timeoute alebo 5xx opakovať presne uložené request, nie nový snapshot.
if not response.success:
mark_document_delivery_failed(document)
return
save_receipt(document, response.request_id, response.batch_id)
mark_document_delivered(document)

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.