Preskoči na sadržaj
ShopentlyLearn

Sheme podataka: Proizvodi

Sheme podataka: Proizvodi. Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.

Sheme podataka

Popis — Proizvodi — Odgovor

ApiResponse_list_ProductSummaryData__ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
dataPolje vrijednosti <ProductSummaryData > Obvezno

Primjer odgovora · ApiResponse_list_ProductSummaryData__.

Primjer: [{"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

Metapodaci odgovora.

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

Dodatna polja: Ne

Dohvati — Proizvodi — Odgovor

ApiResponse_ProductDetailData_ · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
dataProductDetailData Obvezno

Primjer odgovora · ProductDetailData.

Primjer: {"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

Metapodaci odgovora.

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

Dodatna polja: Ne

Podaci o dostupnosti za odabrani kontekst

AvailabilityData · Shema · Sheme podataka: Proizvodi
available_fromNiz znakova nullObvezno

Početak dostupnosti.

Niz znakova:format: "date-time"
Primjer: null
available_untilNiz znakova nullObvezno

Kraj dostupnosti.

Niz znakova:format: "date-time"
Primjer: null
is_availableLogička vrijednostObvezno

Je li stavka dostupna u ovom kontekstu.

Primjer: true

Dodatna polja: Ne

Podaci o cijeni u odabranom kontekstu

PriceData · Shema · Sheme podataka: Proizvodi
amountNiz znakovaObvezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gdje je dopušten.

Primjer: "0.00"
currencyNiz znakovaObvezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
Primjer: "PLN"
minor_unitsCijeli brojObvezno

Broj decimalnih znamenki valute.

minimum: 0maximum: 4
Primjer: 2
tax_includedLogička vrijednostObvezno

Uključuje li poslana cijena porez.

Primjer: true

Dodatna polja: Ne

Podaci cjenika

PriceListData · Shema · Sheme podataka: Proizvodi
currencyNiz znakovaObvezno

Kod valute iznosa.

idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (PriceListData).

tax_includedLogička vrijednostObvezno

Uključuje li poslana cijena porez.

versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Dodatna polja: Ne

Stvori — Proizvodi — Tijelo zahtjeva

ProductCreate · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
brand_idNiz znakova nullNeobavezno

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63
conditionNiz znakovaNeobavezno

Stanje proizvoda.

Ograničenja
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Zadano: "new"
descriptionNiz znakova nullNeobavezno

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000
feature_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti svojstva.

maxItems: 1000
Polje vrijednosti:minLength: 1maxLength: 63
identifiersProductIdentifiers nullNeobavezno

Identifikacijski kodovi proizvoda.

market_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih tržišta.

maxItems: 1000
Polje vrijednosti:minLength: 1maxLength: 63
media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 20
Polje vrijednosti:minLength: 1maxLength: 63
meta_descriptionNiz znakova nullNeobavezno

Opis za tražilice na odabranom jeziku.

Niz znakova:maxLength: 160
meta_keywordsPolje vrijednosti <Niz znakova> nullNeobavezno

Ključne riječi za tražilice na odabranom jeziku.

Polje vrijednosti:maxItems: 20
Polje vrijednosti / Polje vrijednosti:maxLength: 50
meta_titleNiz znakova nullNeobavezno

Naslov za tražilice na odabranom jeziku.

Niz znakova:maxLength: 70
nameNiz znakovaObvezno

Naziv resursa u odgovarajućem kontekstu.

minLength: 1maxLength: 300
Primjer: "Example"
pricingProductPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

primary_category_idNiz znakova nullNeobavezno

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63
publishedLogička vrijednostNeobavezno

Je li resurs objavljen.

Zadano: false
skuNiz znakovaObvezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100
Ograničenja
pattern
"^\\S+$"
Primjer: "example"
slugNiz znakova nullNeobavezno

Dio URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160
tax_category_idNiz znakova nullNeobavezno

Identifikator porezne kategorije.

Niz znakova:minLength: 1maxLength: 63
variant_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti varijante.

maxItems: 250
Polje vrijednosti:minLength: 1maxLength: 63
variants_enabledLogička vrijednostNeobavezno

Koristi li proizvod varijante.

Zadano: false

Dodatna polja: Ne

Dohvati — Proizvodi — Odgovor

ProductDetailData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
availabilityAvailabilityData Obvezno

Podaci o dostupnosti za odabrani kontekst.

Primjer: {"available_from":null,"available_until":null,"is_available":true}
brand_idNiz znakova nullObvezno

Identifikator marke.

Primjer: null
conditionNiz znakovaObvezno

Stanje proizvoda.

Ograničenja
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Primjer: "new"
created_atNiz znakovaObvezno

Vrijeme izrade.

format: "date-time"
Primjer: "2026-01-01T12:00:00Z"
descriptionNiz znakova nullObvezno

Opis na odabranom jeziku.

Primjer: "example"
featuresPolje vrijednosti <FeatureSelectionData > Obvezno

Svojstva proizvoda.

Primjer: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]
idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductDetailData).

Primjer: "example"
identifiersObjektDodatna polja: Niz znakovaObvezno

Identifikacijski kodovi proizvoda.

Primjer: {}
mediaPolje vrijednosti <ProductMediaData > Obvezno

Podaci o priloženim medijima.

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

Opis za tražilice na odabranom jeziku.

Primjer: "example"
meta_keywordsPolje vrijednosti <Niz znakova> nullObvezno

Ključne riječi za tražilice na odabranom jeziku.

Primjer: ["example"]
meta_titleNiz znakova nullObvezno

Naslov za tražilice na odabranom jeziku.

Primjer: "example"
nameNiz znakova nullObvezno

Naziv resursa u odgovarajućem kontekstu.

Primjer: "Example"
numberNiz znakovaObvezno

Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"
pricePriceData nullObvezno

Podaci o cijeni u odabranom kontekstu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionCijeli brojObvezno

Trenutačna verzija cijene za kontrolu istodobnih upisa.

Primjer: 1
primary_category_idNiz znakova nullObvezno

Identifikator glavne kategorije.

Primjer: "example"
primary_media_idNiz znakova nullObvezno

Identifikator glavne medijske datoteke.

Primjer: "example"
publishedLogička vrijednostObvezno

Je li resurs objavljen.

Primjer: false
skuNiz znakovaObvezno

Šifra skladišne jedinice.

Primjer: "example"
slugNiz znakova nullObvezno

Dio URL putanje na odabranom jeziku.

Primjer: "example"
tax_category_idNiz znakovaObvezno

Identifikator porezne kategorije.

Primjer: "example"
updated_atNiz znakovaObvezno

Vrijeme posljednjeg ažuriranja.

format: "date-time"
Primjer: "2026-01-01T12:00:00Z"
variants_enabledLogička vrijednostObvezno

Koristi li proizvod varijante.

Primjer: false
versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Identifikacijski kodovi proizvoda

ProductIdentifiers · Shema · Sheme podataka: Proizvodi
eanNiz znakova nullNeobavezno

EAN identifikator proizvoda.

Niz znakova:minLength: 1maxLength: 100
isbnNiz znakova nullNeobavezno

ISBN identifikator.

Niz znakova:minLength: 1maxLength: 100
mpnNiz znakova nullNeobavezno

Kataloški broj proizvođača.

Niz znakova:minLength: 1maxLength: 100
upcNiz znakova nullNeobavezno

UPC identifikator proizvoda.

Niz znakova:minLength: 1maxLength: 100

Dodatna polja: Ne

Podaci o priloženim medijima

ProductMediaData · Shema · Sheme podataka: Proizvodi
alt_textNiz znakova nullObvezno

Zamjenski tekst slike.

Primjer: "example"
idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductMediaData).

Primjer: "example"
is_primaryLogička vrijednostObvezno

Je li ovo glavna stavka.

Primjer: true
kindNiz znakovaObvezno

Varijanta strukture podataka opisana dopuštenim vrijednostima.

Ograničenja
enum
["image", "video", "model_3d"]
Primjer: "image"
mime_typeNiz znakovaObvezno

Vrsta medijskog sadržaja.

Primjer: "image/jpeg"
positionCijeli brojObvezno

Položaj u uređenoj zbirci.

Primjer: 1
urlNiz znakova nullObvezno

URL resursa.

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

Dodatna polja: Ne

Postavke cijena i njihove verzije za kontrolu istodobnih upisa

ProductPrice · Shema · Sheme podataka: Proizvodi
amountNiz znakova nullObvezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gdje je dopušten.

Niz znakova:maxLength: 19
Ograničenja · Niz znakova 1
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"
Primjer: "0.00"
currencyNiz znakovaObvezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
Primjer: "PLN"
expected_price_list_versionCijeli brojObvezno

Prethodno pročitana verzija cjenika potrebna za ovaj upis.

minimum: 1maximum: 9223372036854775807
Primjer: 1
expected_versionCijeli brojObvezno

Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 0maximum: 9223372036854775807
Primjer: 0
kindNiz znakovaObvezno

Varijanta strukture podataka opisana dopuštenim vrijednostima.

Ograničenja
enum
["base", "market_fixed"]
Primjer: "base"
price_list_idNiz znakovaObvezno

Identifikator cjenika.

minLength: 1maxLength: 63
Primjer: "example"
tax_includedLogička vrijednostObvezno

Uključuje li poslana cijena porez.

Primjer: true

Dodatna polja: Ne

Popis — Proizvodi — Odgovor

ProductSummaryData · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
availabilityAvailabilityData Obvezno

Podaci o dostupnosti za odabrani kontekst.

Primjer: {"available_from":null,"available_until":null,"is_available":true}
brand_idNiz znakova nullObvezno

Identifikator marke.

Primjer: null
conditionNiz znakovaObvezno

Stanje proizvoda.

Ograničenja
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Primjer: "new"
created_atNiz znakovaObvezno

Vrijeme izrade.

format: "date-time"
Primjer: "2026-01-01T12:00:00Z"
idNiz znakovaObvezno

Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductSummaryData).

Primjer: "example"
nameNiz znakova nullObvezno

Naziv resursa u odgovarajućem kontekstu.

Primjer: "Example"
numberNiz znakovaObvezno

Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"
pricePriceData nullObvezno

Podaci o cijeni u odabranom kontekstu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionCijeli brojObvezno

Trenutačna verzija cijene za kontrolu istodobnih upisa.

Primjer: 1
primary_category_idNiz znakova nullObvezno

Identifikator glavne kategorije.

Primjer: "example"
primary_media_idNiz znakova nullObvezno

Identifikator glavne medijske datoteke.

Primjer: "example"
publishedLogička vrijednostObvezno

Je li resurs objavljen.

Primjer: false
skuNiz znakovaObvezno

Šifra skladišne jedinice.

Primjer: "example"
slugNiz znakova nullObvezno

Dio URL putanje na odabranom jeziku.

Primjer: "example"
tax_category_idNiz znakovaObvezno

Identifikator porezne kategorije.

Primjer: "example"
updated_atNiz znakovaObvezno

Vrijeme posljednjeg ažuriranja.

format: "date-time"
Primjer: "2026-01-01T12:00:00Z"
variants_enabledLogička vrijednostObvezno

Koristi li proizvod varijante.

Primjer: false
versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Ažuriraj — Proizvodi — Tijelo zahtjeva

ProductUpdate · Polja, vrste i ograničenja podataka koje API prihvaća ili vraća.
brand_idNiz znakova nullNeobavezno

Identifikator marke.

Niz znakova:minLength: 1maxLength: 63
conditionNiz znakovaNeobavezno

Stanje proizvoda.

Ograničenja
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
descriptionNiz znakova nullNeobavezno

Opis na odabranom jeziku.

Niz znakova:maxLength: 100000
Primjer: null
expected_variant_price_versionsObjektDodatna polja: Cijeli broj
minimum: 0maximum: 9223372036854775807
Neobavezno

Prethodno pročitane verzije cijena s identifikatorom varijante kao ključem.

maxProperties: 250
Ograničenja
propertyNames
{"maxLength": 63, "minLength": 1}
expected_versionCijeli brojObvezno

Verzija pročitana prije upisa; nepodudaranje odbija ažuriranje.

minimum: 1maximum: 9223372036854775807
Primjer: 1
feature_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti svojstva.

maxItems: 1000
Polje vrijednosti:minLength: 1maxLength: 63
identifiersProductIdentifiers nullNeobavezno

Identifikacijski kodovi proizvoda.

market_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih tržišta.

maxItems: 1000
Polje vrijednosti:minLength: 1maxLength: 63
media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 20
Polje vrijednosti:minLength: 1maxLength: 63
meta_descriptionNiz znakova nullNeobavezno

Opis za tražilice na odabranom jeziku.

Niz znakova:maxLength: 160
meta_keywordsPolje vrijednosti <Niz znakova> nullNeobavezno

Ključne riječi za tražilice na odabranom jeziku.

Polje vrijednosti:maxItems: 20
Polje vrijednosti / Polje vrijednosti:maxLength: 50
meta_titleNiz znakova nullNeobavezno

Naslov za tražilice na odabranom jeziku.

Niz znakova:maxLength: 70
nameNiz znakova nullNeobavezno

Naziv resursa u odgovarajućem kontekstu.

Niz znakova:maxLength: 300
Primjer: null
pricingProductPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

Primjer: {"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 znakova nullNeobavezno

Identifikator glavne kategorije.

Niz znakova:minLength: 1maxLength: 63
publishedLogička vrijednostNeobavezno

Je li resurs objavljen.

skuNiz znakovaNeobavezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100
Ograničenja
pattern
"^\\S+$"
Primjer: "example"
slugNiz znakova nullNeobavezno

Dio URL putanje na odabranom jeziku.

Niz znakova:maxLength: 160
tax_category_idNiz znakova nullNeobavezno

Identifikator porezne kategorije.

Niz znakova:minLength: 1maxLength: 63
variant_value_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori odabranih vrijednosti varijante.

maxItems: 250
Polje vrijednosti:minLength: 1maxLength: 63
variants_enabledLogička vrijednostNeobavezno

Koristi li proizvod varijante.

Dodatna polja: Ne