Skip to navigation

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

X-API-Keystring

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.

stock_codestringRequired1-64 characters

Skladové číslo Elall, povinná časť identity ean + stock_code. Pre jedno stock_code používajte vždy rovnaký neprázdny EAN.

statusstringRequiredformat: "^(active|passive)$"

active publikuje produkt aj pri nulovom sklade (objednávka na objednávku); passive skryje neukončený produkt.

segat_quantityintegerRequired>=0

Absolútny fyzický stav skladu Elallu, nie delta; čerstvá aktualizácia prepíše stav v Administrácii.

catalog_pricedoubleRequired>=0

Cenníková cena; prenášaná pre kompatibilitu, nepoužitá pre predaj ani pôvodnú cenu

eshop_pricedoubleRequired>=0

E-shop cena v EUR bez DPH; Administrácia uplatní DPH 23 %

eanstring or nullOptional<=32 characters

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.

namestring or nullOptional<=512 characters

Názov; nový produkt potrebuje neprázdny názov. Vynechanie / null zachová názov existujúceho produktu.

section_width_mmstring or nullOptional

Šírka (mm) — číslo alebo ľubovoľný reťazec z exportu (napr. 215, P245, 30X9.5).

aspect_ratiostring or nullOptional

Profil — číslo alebo ľubovoľný reťazec z exportu (napr. 55, 50Z, 31X10.5).

rim_inchstring or nullOptional<=16 characters

Priemer ráfika v palcoch (ETRTO). Môže byť číslo (napr. 16), s prefixom R (napr. R21) alebo záporná hodnota (napr. -16).

tread_namestring or nullOptional<=256 characters

Názov dezénu

name_suffixstring or nullOptional<=512 characters

Doplnok k názvu (variant, ročník, marketingový text).

load_indexstring or nullOptional<=16 characters

Index nosnosti, napr. 91 alebo 104/102.

speed_indexstring or nullOptional<=16 characters

Index rýchlosti, napr. V.

special_markingstring or nullOptional<=128 characters

Špeciálne označenie

run_on_flatboolean or nullOptional
ROF
brandstring or nullOptional<=128 characters

Výrobca / značka

usagestring or nullOptional<=64 characters

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.

seasonstring or nullOptional<=32 characters

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.

on_promotionboolean or nullOptional
Akcia
on_clearanceboolean or nullOptional

Výpredaj / clearance. Nový produkt predvolene false; vynechanie/null zachová existujúcu hodnotu. false príznak vypne.

dot_codestring or nullOptional<=32 characters
DOT
weight_kgdouble or string or nullOptional

Hmotnosť plášťa v kg (technický list, EU štítok).

discontinuedboolean or nullOptional

true ukončí nákup, ale zachová publikovanú stránku aj pri passive; vynechanie / null zachová stav.

eu_labelstring or nullOptional<=1024 characters

EU štítok

request_idstring or nullOptional<=64 characters
sync_contextobject or nullOptional

Dôvod / kontext syncu na úrovni requestu (príjemka, výdajka, …).

Response

Successful Response
successboolean

Bezpečné prijatie dávky; nepotvrdzuje dokončenie importu ani správnosť všetkých riadkov.

request_idstring

ID requestu z konektora; pri chýbajúcom ID ho vytvorí server.

products_receivedinteger

Počet všetkých prijatých riadkov vrátane odmietnutých a vylúčených.

batch_idinteger

Trvanlivé číslo prijatej dávky; presná retry vráti rovnaké číslo.

processing_statusstring

Aktuálny stav dávky: accepted, processing, completed alebo partial. Presná retry môže vrátiť neskorší stav.

products_updatedintegerOptionalDefaults to 0

V potvrdení príjmu vždy 0; výsledky aktualizácie sú v Administrácii.

unknown_productsintegerOptionalDefaults to 0

Kompatibilné pole, vždy 0; nové stock_code sa vytvárajú ako nové produkty.

products_rejectedintegerOptionalDefaults to 0

Odmietnuté riadky známe v okamihu odpovede; konečný výsledok spracovania je v Administrácii.

products_excludedintegerOptionalDefaults to 0

Počet vylúčených diskov, ktoré sa podľa dohody neimportujú.

Errors

400
Bad Request Error
401
Unauthorized Error
413
Content Too Large Error
422
Unprocessable Entity Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error