Podatkovne sheme: Izdelki

Podatkovne sheme: Izdelki. Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

Podatkovne sheme

Prikaži seznam — Izdelki — Odgovor

ApiResponse_list_ProductSummaryData__ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

dataPolje elementov <ProductSummaryData > Obvezno: Primer odgovora · ApiResponse_list_ProductSummaryData__.

Primer: [{"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}]
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Dodatna polja: Ne

Pridobi — Izdelki — Odgovor

ApiResponse_ProductDetailData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

dataProductDetailData Obvezno: Primer odgovora · ProductDetailData.

Primer: {"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","description":"example","features":[{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}],"id":"example","identifiers":{},"media":[{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}],"meta_description":"example","meta_keywords":["example"],"meta_title":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Dodatna polja: Ne

Podatki o razpoložljivosti v izbranem kontekstu

AvailabilityData · Shema · Podatkovne sheme: Izdelki

available_fromNiz nullObvezno: Začetek razpoložljivosti.

Niz:format: "date-time"

Primer: null
available_untilNiz nullObvezno: Konec razpoložljivosti.

Niz:format: "date-time"

Primer: null
is_availableLogična vrednostObvezno: Ali je element na voljo v tem kontekstu.

Primer: true

Dodatna polja: Ne

Podatki o ceni v izbranem kontekstu

PriceData · Shema · Podatkovne sheme: Izdelki

amountNizObvezno

Decimalni znesek, kodiran kot niz JSON; null le tam, kjer je dovoljen.

Primer: "0.00"

currencyNizObvezno

Koda valute zneska.

Omejitve

pattern: "^[A-Z]{3}$"

Primer: "PLN"

minor_unitsCelo številoObvezno

Število decimalnih mest valute.

minimum: 0maximum: 4

Primer: 2

tax_includedLogična vrednostObvezno

Ali posredovana cena vključuje davek.

Primer: true

Dodatna polja: Ne

Podatki cenika

PriceListData · Shema · Podatkovne sheme: Izdelki

currencyNizObvezno: Koda valute zneska.
idNizObvezno: Identifikator vira; ohranite ga v vrnjeni obliki. (PriceListData).
tax_includedLogična vrednostObvezno: Ali posredovana cena vključuje davek.
versionCelo številoObvezno: Različica vira za nadzor sočasnosti.

Dodatna polja: Ne

Ustvari — Izdelki — Telo zahteve

ProductCreate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

brand_idNiz nullIzbirno

Identifikator znamke.

Niz:minLength: 1maxLength: 63

conditionNizIzbirno

Stanje izdelka.

Omejitve

enum: ["new", "refurbished", "used", "returned", "display", "damaged"]

Privzeto: "new"

descriptionNiz nullIzbirno

Opis v izbranem jeziku.

Niz:maxLength: 100000

feature_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti lastnosti.

maxItems: 1000

Polje elementov:minLength: 1maxLength: 63

identifiersProductIdentifiers nullIzbirno

Identifikacijske kode izdelka.

market_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih trgov.

maxItems: 1000

Polje elementov:minLength: 1maxLength: 63

media_idsPolje elementov <Niz> Izbirno

Identifikatorji že obstoječih medijskih datotek.

maxItems: 20

Polje elementov:minLength: 1maxLength: 63

meta_descriptionNiz nullIzbirno

Opis za iskalnike v izbranem jeziku.

Niz:maxLength: 160

meta_keywordsPolje elementov <Niz> nullIzbirno

Ključne besede za iskalnike v izbranem jeziku.

Polje elementov:maxItems: 20

Polje elementov / Polje elementov:maxLength: 50

meta_titleNiz nullIzbirno

Naslov za iskalnike v izbranem jeziku.

Niz:maxLength: 70

nameNizObvezno

Ime vira v ustreznem kontekstu.

minLength: 1maxLength: 300

Primer: "Example"

pricingProductPrice Izbirno

Nastavitve cen in njihove različice za nadzor sočasnosti.

primary_category_idNiz nullIzbirno

Identifikator primarne kategorije.

Niz:minLength: 1maxLength: 63

publishedLogična vrednostIzbirno

Ali je vir objavljen.

Privzeto: false

skuNizObvezno

Koda enote za vodenje zaloge.

minLength: 1maxLength: 100

Omejitve

pattern: "^\\S+$"

Primer: "example"

slugNiz nullIzbirno

Del poti URL v izbranem jeziku.

Niz:maxLength: 160

tax_category_idNiz nullIzbirno

Identifikator davčne kategorije.

Niz:minLength: 1maxLength: 63

variant_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti različic.

maxItems: 250

Polje elementov:minLength: 1maxLength: 63

variants_enabledLogična vrednostIzbirno

Ali izdelek uporablja različice.

Privzeto: false

Dodatna polja: Ne

Pridobi — Izdelki — Odgovor

ProductDetailData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

availabilityAvailabilityData Obvezno

Podatki o razpoložljivosti v izbranem kontekstu.

Primer: {"available_from":null,"available_until":null,"is_available":true}

brand_idNiz nullObvezno

Identifikator znamke.

Primer: null

conditionNizObvezno

Stanje izdelka.

Omejitve

enum: ["new", "refurbished", "used", "returned", "display", "damaged"]

Primer: "new"

created_atNizObvezno

Čas nastanka.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

descriptionNiz nullObvezno

Opis v izbranem jeziku.

Primer: "example"

featuresPolje elementov <FeatureSelectionData > Obvezno

Lastnosti izdelka.

Primer: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductDetailData).

Primer: "example"

identifiersObjektDodatna polja: NizObvezno

Identifikacijske kode izdelka.

Primer: {}

mediaPolje elementov <ProductMediaData > Obvezno

Podatki o priloženih medijih.

Primer:

[{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}]

meta_descriptionNiz nullObvezno

Opis za iskalnike v izbranem jeziku.

Primer: "example"

meta_keywordsPolje elementov <Niz> nullObvezno

Ključne besede za iskalnike v izbranem jeziku.

Primer: ["example"]

meta_titleNiz nullObvezno

Naslov za iskalnike v izbranem jeziku.

Primer: "example"

nameNiz nullObvezno

Ime vira v ustreznem kontekstu.

Primer: "Example"

numberNizObvezno

Uporabniku prikazana številka naročila ali zahtevka.

Primer: "example"

pricePriceData nullObvezno

Podatki o ceni v izbranem kontekstu.

Primer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionCelo številoObvezno

Trenutna različica cene za nadzor sočasnosti.

Primer: 1

primary_category_idNiz nullObvezno

Identifikator primarne kategorije.

Primer: "example"

primary_media_idNiz nullObvezno

Identifikator primarne medijske datoteke.

Primer: "example"

publishedLogična vrednostObvezno

Ali je vir objavljen.

Primer: false

skuNizObvezno

Koda enote za vodenje zaloge.

Primer: "example"

slugNiz nullObvezno

Del poti URL v izbranem jeziku.

Primer: "example"

tax_category_idNizObvezno

Identifikator davčne kategorije.

Primer: "example"

updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

variants_enabledLogična vrednostObvezno

Ali izdelek uporablja različice.

Primer: false

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

Dodatna polja: Ne

Identifikacijske kode izdelka

ProductIdentifiers · Shema · Podatkovne sheme: Izdelki

eanNiz nullIzbirno: Identifikator izdelka EAN.

Niz:minLength: 1maxLength: 100
isbnNiz nullIzbirno: Identifikator ISBN.

Niz:minLength: 1maxLength: 100
mpnNiz nullIzbirno: Kataloška številka proizvajalca.

Niz:minLength: 1maxLength: 100
upcNiz nullIzbirno: Identifikator izdelka UPC.

Niz:minLength: 1maxLength: 100

Dodatna polja: Ne

Podatki o priloženih medijih

ProductMediaData · Shema · Podatkovne sheme: Izdelki

alt_textNiz nullObvezno

Nadomestno besedilo slike.

Primer: "example"

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductMediaData).

Primer: "example"

is_primaryLogična vrednostObvezno

Ali je to primarni element.

Primer: true

kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve

enum: ["image", "video", "model_3d"]

Primer: "image"

mime_typeNizObvezno

Vrsta medijske vsebine.

Primer: "image/jpeg"

positionCelo številoObvezno

Položaj v urejeni zbirki.

Primer: 1

urlNiz nullObvezno

URL vira.

Primer: "https://example.invalid/product.jpg"

Dodatna polja: Ne

Nastavitve cen in njihove različice za nadzor sočasnosti

ProductPrice · Shema · Podatkovne sheme: Izdelki

amountNiz nullObvezno

Decimalni znesek, kodiran kot niz JSON; null le tam, kjer je dovoljen.

Niz:maxLength: 19

Omejitve · Niz 1

pattern: "^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"

Primer: "0.00"

currencyNizObvezno

Koda valute zneska.

Omejitve

pattern: "^[A-Z]{3}$"

Primer: "PLN"

expected_price_list_versionCelo številoObvezno

Predhodno prebrana različica cenika, zahtevana za ta zapis.

minimum: 1maximum: 9223372036854775807

Primer: 1

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 0maximum: 9223372036854775807

Primer: 0

kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve

enum: ["base", "market_fixed"]

Primer: "base"

price_list_idNizObvezno

Identifikator cenika.

minLength: 1maxLength: 63

Primer: "example"

tax_includedLogična vrednostObvezno

Ali posredovana cena vključuje davek.

Primer: true

Dodatna polja: Ne

Prikaži seznam — Izdelki — Odgovor

ProductSummaryData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

availabilityAvailabilityData Obvezno

Podatki o razpoložljivosti v izbranem kontekstu.

Primer: {"available_from":null,"available_until":null,"is_available":true}

brand_idNiz nullObvezno

Identifikator znamke.

Primer: null

conditionNizObvezno

Stanje izdelka.

Omejitve

enum: ["new", "refurbished", "used", "returned", "display", "damaged"]

Primer: "new"

created_atNizObvezno

Čas nastanka.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (ProductSummaryData).

Primer: "example"

nameNiz nullObvezno

Ime vira v ustreznem kontekstu.

Primer: "Example"

numberNizObvezno

Uporabniku prikazana številka naročila ali zahtevka.

Primer: "example"

pricePriceData nullObvezno

Podatki o ceni v izbranem kontekstu.

Primer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}

price_versionCelo številoObvezno

Trenutna različica cene za nadzor sočasnosti.

Primer: 1

primary_category_idNiz nullObvezno

Identifikator primarne kategorije.

Primer: "example"

primary_media_idNiz nullObvezno

Identifikator primarne medijske datoteke.

Primer: "example"

publishedLogična vrednostObvezno

Ali je vir objavljen.

Primer: false

skuNizObvezno

Koda enote za vodenje zaloge.

Primer: "example"

slugNiz nullObvezno

Del poti URL v izbranem jeziku.

Primer: "example"

tax_category_idNizObvezno

Identifikator davčne kategorije.

Primer: "example"

updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

variants_enabledLogična vrednostObvezno

Ali izdelek uporablja različice.

Primer: false

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

Dodatna polja: Ne

Posodobi — Izdelki — Telo zahteve

ProductUpdate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

brand_idNiz nullIzbirno

Identifikator znamke.

Niz:minLength: 1maxLength: 63

conditionNizIzbirno

Stanje izdelka.

Omejitve

enum: ["new", "refurbished", "used", "returned", "display", "damaged"]

descriptionNiz nullIzbirno

Opis v izbranem jeziku.

Niz:maxLength: 100000

Primer: null

expected_variant_price_versionsObjektDodatna polja: Celo število

minimum: 0maximum: 9223372036854775807

Izbirno

Predhodno prebrane različice cen, urejene po identifikatorju različice izdelka.

maxProperties: 250

Omejitve

propertyNames: {"maxLength": 63, "minLength": 1}

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 1

feature_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti lastnosti.

maxItems: 1000

Polje elementov:minLength: 1maxLength: 63

identifiersProductIdentifiers nullIzbirno

Identifikacijske kode izdelka.

market_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih trgov.

maxItems: 1000

Polje elementov:minLength: 1maxLength: 63

media_idsPolje elementov <Niz> Izbirno

Identifikatorji že obstoječih medijskih datotek.

maxItems: 20

Polje elementov:minLength: 1maxLength: 63

meta_descriptionNiz nullIzbirno

Opis za iskalnike v izbranem jeziku.

Niz:maxLength: 160

meta_keywordsPolje elementov <Niz> nullIzbirno

Ključne besede za iskalnike v izbranem jeziku.

Polje elementov:maxItems: 20

Polje elementov / Polje elementov:maxLength: 50

meta_titleNiz nullIzbirno

Naslov za iskalnike v izbranem jeziku.

Niz:maxLength: 70

nameNiz nullIzbirno

Ime vira v ustreznem kontekstu.

Niz:maxLength: 300

Primer: null

pricingProductPrice Izbirno

Nastavitve cen in njihove različice za nadzor sočasnosti.

Primer:

{"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}

primary_category_idNiz nullIzbirno

Identifikator primarne kategorije.

Niz:minLength: 1maxLength: 63

publishedLogična vrednostIzbirno

Ali je vir objavljen.

skuNizIzbirno

Koda enote za vodenje zaloge.

minLength: 1maxLength: 100

Omejitve

pattern: "^\\S+$"

Primer: "example"

slugNiz nullIzbirno

Del poti URL v izbranem jeziku.

Niz:maxLength: 160

tax_category_idNiz nullIzbirno

Identifikator davčne kategorije.

Niz:minLength: 1maxLength: 63

variant_value_idsPolje elementov <Niz> Izbirno

Identifikatorji izbranih vrednosti različic.

maxItems: 250

Polje elementov:minLength: 1maxLength: 63

variants_enabledLogična vrednostIzbirno

Ali izdelek uporablja različice.

Dodatna polja: Ne