Synchronizácia jedného produktu
Rovnaké prijatie a spracovanie ako dávkový endpoint. Identitu tvorí ean + stock_code; doplnenie prázdneho EAN zachová produkt. request_id a sync_context sú voliteľné v tele.
Authentication
API kľúč pre prístup Elallu k Synchronizácii. Poskytnutý samostatne zabezpečeným spôsobom.
Request
Telo pre PUT …/products/item — voliteľné request_id a sync_context.
Skladové číslo Elall, povinná časť identity ean + stock_code. Pre jedno stock_code používajte vždy rovnaký neprázdny EAN.
active publikuje produkt aj pri nulovom sklade (objednávka na objednávku); passive skryje neukončený produkt.
Absolútny fyzický stav skladu Elallu, nie delta; čerstvá aktualizácia prepíše stav v Administrácii.
Cenníková cena; prenášaná pre kompatibilitu, nepoužitá pre predaj ani pôvodnú cenu
E-shop cena v EUR bez DPH; Administrácia uplatní DPH 23 %
EAN je súčasť identity so stock_code. Prázdny EAN sa prijme s upozornením; jeho neskoršie doplnenie pri rovnakom stock_code aktualizuje ten istý produkt. Vynechanie/null zachová už známy EAN. Iný neprázdny EAN pri tom istom stock_code sa odmietne ako konflikt.
Názov; nový produkt potrebuje neprázdny názov. Vynechanie / null zachová názov existujúceho produktu.
Šírka (mm) — číslo alebo ľubovoľný reťazec z exportu (napr. 215, P245, 30X9.5).
Profil — číslo alebo ľubovoľný reťazec z exportu (napr. 55, 50Z, 31X10.5).
Priemer ráfika v palcoch (ETRTO). Môže byť číslo (napr. 16), s prefixom R (napr. R21) alebo záporná hodnota (napr. -16).
Názov dezénu
Doplnok k názvu (variant, ročník, marketingový text).
Index nosnosti, napr. 91 alebo 104/102.
Index rýchlosti, napr. V.
Špeciálne označenie
Výrobca / značka
Typ použitia pneumatiky (napr. osobné, SUV, ľahký úžitkový), potrebný pre presné zaradenie. V API zostáva voliteľný pre kompatibilitu; vynechanie/null zachová hodnotu. Hodnoty dohodnite so Segatom.
Sezónnosť plášťa — ľubovoľný reťazec (max 32 znakov), bez validácie enumu. Bežné hodnoty napr. summer / winter / all_season, ale aj kódy dodávateľa, lokalizované texty (letná, zimná) alebo skratky podľa vášho katalógu.
Výpredaj / clearance. Nový produkt predvolene false; vynechanie/null zachová existujúcu hodnotu. false príznak vypne.
Hmotnosť plášťa v kg (technický list, EU štítok).
true ukončí nákup, ale zachová publikovanú stránku aj pri passive; vynechanie / null zachová stav.
EU štítok
Dôvod / kontext syncu na úrovni requestu (príjemka, výdajka, …).
Response
Bezpečné prijatie dávky; nepotvrdzuje dokončenie importu ani správnosť všetkých riadkov.
ID requestu z konektora; pri chýbajúcom ID ho vytvorí server.
Počet všetkých prijatých riadkov vrátane odmietnutých a vylúčených.
Trvanlivé číslo prijatej dávky; presná retry vráti rovnaké číslo.
Aktuálny stav dávky: accepted, processing, completed alebo partial. Presná retry môže vrátiť neskorší stav.
V potvrdení príjmu vždy 0; výsledky aktualizácie sú v Administrácii.
Kompatibilné pole, vždy 0; nové stock_code sa vytvárajú ako nové produkty.
Odmietnuté riadky známe v okamihu odpovede; konečný výsledok spracovania je v Administrácii.
Počet vylúčených diskov, ktoré sa podľa dohody neimportujú.