Sheme podataka: Varijante i opcije

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

Sheme podataka

Popis · Varijante proizvoda — Varijante i opcije — Odgovor

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

dataPolje vrijednosti <ProductVariantData > Obvezno: Primjer odgovora · ApiResponse_list_ProductVariantData__.

Primjer: [{"active":true,"created_at":"2026-01-01T12:00:00Z","id":"example","is_default":true,"media_ids":["example"],"position":1,"pricing":{"base_adjustment":{"amount":"0.00","currency":"PLN","minor_units":2},"market_price":null,"price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"product_version":1,"version":1},"primary_media_id":"example","product_id":"example","sku":"example","updated_at":"2026-01-01T12:00:00Z","values":[{"option_id":"example","option_name":"example","value":"example","value_id":"example"}],"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

Popis · Opcije — Varijante i opcije — Odgovor

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

dataPolje vrijednosti <shopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData > Obvezno: Primjer odgovora · ApiResponse_list_VariantOptionData__.

Primjer: [{"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"selection_type":"button","updated_at":"2026-01-01T12:00:00Z","value_presentation_type":"text","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

Popis · Vrijednosti opcija — Varijante i opcije — Odgovor

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

dataPolje vrijednosti <VariantValueData > Obvezno: Primjer odgovora · ApiResponse_list_VariantValueData__.

Primjer: [{"color_hex":"#008855","created_at":"2026-01-01T12:00:00Z","id":"example","image_media_id":null,"number":"example","option_id":"example","position":1,"sku_code":"example","updated_at":"2026-01-01T12:00:00Z","value":"example","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 · Varijante proizvoda — Varijante i opcije — Odgovor

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

dataProductVariantData Obvezno: Primjer odgovora · ProductVariantData.

Primjer: {"active":true,"created_at":"2026-01-01T12:00:00Z","id":"example","is_default":true,"media_ids":["example"],"position":1,"pricing":{"base_adjustment":{"amount":"0.00","currency":"PLN","minor_units":2},"market_price":null,"price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"product_version":1,"version":1},"primary_media_id":"example","product_id":"example","sku":"example","updated_at":"2026-01-01T12:00:00Z","values":[{"option_id":"example","option_name":"example","value":"example","value_id":"example"}],"version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Dohvati · Opcije — Varijante i opcije — Odgovor

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

datashopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData Obvezno: Primjer odgovora · shopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData.

Primjer: {"created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","position":1,"selection_type":"button","updated_at":"2026-01-01T12:00:00Z","value_presentation_type":"text","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Dohvati · Vrijednosti opcija — Varijante i opcije — Odgovor

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

dataVariantValueData Obvezno: Primjer odgovora · VariantValueData.

Primjer: {"color_hex":"#008855","created_at":"2026-01-01T12:00:00Z","id":"example","image_media_id":null,"number":"example","option_id":"example","position":1,"sku_code":"example","updated_at":"2026-01-01T12:00:00Z","value":"example","version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Dohvati · Opcije — Varijante i opcije — Odgovor

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

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. (shopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData).

Primjer: "example"

nameNiz znakova nullObvezno

Naziv resursa u odgovarajućem kontekstu.

Primjer: "Example"

numberNiz znakovaObvezno

Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"

positionCijeli brojObvezno

Položaj u uređenoj zbirci.

Primjer: 1

selection_typeNiz znakovaObvezno

Dopušten način odabira vrijednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

Primjer: "button"

updated_atNiz znakovaObvezno

Vrijeme posljednjeg ažuriranja.

format: "date-time"

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

value_presentation_typeNiz znakovaObvezno

Način prikaza vrijednosti šifrarnika.

Ograničenja

enum: ["text", "color", "image"]

Primjer: "text"

versionCijeli brojObvezno

Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Dohvati · Varijante proizvoda — Varijante i opcije — Odgovor

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

activeLogička vrijednostObvezno: Je li resurs aktivan.

Primjer: true
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. (ProductVariantData).

Primjer: "example"
is_defaultLogička vrijednostObvezno: Je li ovo zadani odabir.

Primjer: true
media_idsPolje vrijednosti <Niz znakova> Obvezno: Identifikatori već postojećih medijskih datoteka.

Primjer: ["example"]
positionCijeli brojObvezno: Položaj u uređenoj zbirci.

Primjer: 1
pricingVariantPricingData Obvezno: Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

Primjer: {"base_adjustment":{"amount":"0.00","currency":"PLN","minor_units":2},"market_price":null,"price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"product_version":1,"version":1}
primary_media_idNiz znakova nullObvezno: Identifikator glavne medijske datoteke.

Primjer: "example"
product_idNiz znakovaObvezno: Identifikator proizvoda.

Primjer: "example"
skuNiz znakovaObvezno: Šifra skladišne jedinice.

Primjer: "example"
updated_atNiz znakovaObvezno: Vrijeme posljednjeg ažuriranja.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"
valuesPolje vrijednosti <VariantChoiceData > Obvezno: Vrijednosti šifrarnika.

Primjer: [{"option_id":"example","option_name":"example","value":"example","value_id":"example"}]
versionCijeli brojObvezno: Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Vrijednosti šifrarnika

VariantChoiceData · Shema · Sheme podataka: Varijante i opcije

option_idNiz znakovaObvezno: Identifikator opcije varijante.

Primjer: "example"
option_nameNiz znakova nullObvezno: Naziv opcije varijante.

Primjer: "example"
valueNiz znakova nullObvezno: Vrijednost opisana okolnom shemom.

Primjer: "example"
value_idNiz znakovaObvezno: Identifikator vrijednosti šifrarnika.

Primjer: "example"

Dodatna polja: Ne

Stvori · Varijante proizvoda — Varijante i opcije — Tijelo zahtjeva

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

activeLogička vrijednostNeobavezno

Je li resurs aktivan.

Zadano: true

expected_versionCijeli brojObvezno

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

minimum: 1maximum: 9223372036854775807

Primjer: 1

is_defaultLogička vrijednostNeobavezno

Je li ovo zadani odabir.

media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 20

Polje vrijednosti:minLength: 1maxLength: 63

pricingVariantPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

skuNiz znakovaNeobavezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

value_idsPolje vrijednosti <Niz znakova> Obvezno

Identifikatori vrijednosti šifrarnika.

minItems: 1maxItems: 250

Polje vrijednosti:minLength: 1maxLength: 63

Primjer: ["example"]

Dodatna polja: Ne

Stvori · Opcije — Varijante i opcije — Tijelo zahtjeva

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

nameNiz znakovaObvezno

Naziv resursa u odgovarajućem kontekstu.

minLength: 1maxLength: 120

Ograničenja

pattern: "^[^\\x00]*$"

Primjer: "Example"

selection_typeNiz znakovaNeobavezno

Dopušten način odabira vrijednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

Zadano: "button"

value_presentation_typeNiz znakovaNeobavezno

Način prikaza vrijednosti šifrarnika.

Ograničenja

enum: ["text", "color", "image"]

Zadano: "text"

Dodatna polja: Ne

Ažuriraj · Opcije — Varijante i opcije — Tijelo zahtjeva

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

expected_versionCijeli brojObvezno

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

minimum: 1maximum: 9223372036854775807

Primjer: 1

nameNiz znakova nullNeobavezno

Naziv resursa u odgovarajućem kontekstu.

Niz znakova:minLength: 1maxLength: 120

Ograničenja · Niz znakova 1

pattern: "^[^\\x00]*$"

Primjer: "Example"

selection_typeNiz znakovaNeobavezno

Dopušten način odabira vrijednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

value_presentation_typeNiz znakovaNeobavezno

Način prikaza vrijednosti šifrarnika.

Ograničenja

enum: ["text", "color", "image"]

Dodatna polja: Ne

Postavke cijena i njihove verzije za kontrolu istodobnih upisa

VariantPrice · Shema · Sheme podataka: Varijante i opcije

amountNiz znakova nullObvezno

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

Niz znakova:maxLength: 20

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_product_versionCijeli brojObvezno

Prethodno pročitana verzija proizvoda potrebna za ovaj upis.

minimum: 0maximum: 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_adjustment", "market_fixed"]

Primjer: "base_adjustment"

price_list_idNiz znakovaObvezno

Identifikator cjenika.

minLength: 1maxLength: 63

Primjer: "example"

Dodatna polja: Ne

Postavke cijena i njihove verzije za kontrolu istodobnih upisa

VariantPricingData · Shema · Sheme podataka: Varijante i opcije

base_adjustmentMoneyData Obvezno: Prilagodba u odnosu na osnovnu cijenu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2}
market_priceMoneyData nullObvezno: Cijena za odabrano tržište.

Primjer: null
pricePriceData nullObvezno: Podaci o cijeni u odabranom kontekstu.

Primjer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
product_versionCijeli brojObvezno: Trenutačna verzija proizvoda za kontrolu istodobnih upisa.

Primjer: 1
versionCijeli brojObvezno: Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Ažuriraj · Varijante proizvoda — Varijante i opcije — Tijelo zahtjeva

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

activeLogička vrijednostNeobavezno

Je li resurs aktivan.

expected_versionCijeli brojObvezno

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

minimum: 1maximum: 9223372036854775807

Primjer: 1

is_defaultLogička vrijednostNeobavezno

Je li ovo zadani odabir.

media_idsPolje vrijednosti <Niz znakova> Neobavezno

Identifikatori već postojećih medijskih datoteka.

maxItems: 20

Polje vrijednosti:minLength: 1maxLength: 63

pricingVariantPrice Neobavezno

Postavke cijena i njihove verzije za kontrolu istodobnih upisa.

Primjer:

{"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_product_version":1,"expected_version":0,"kind":"base_adjustment","price_list_id":"example"}

skuNiz znakovaNeobavezno

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primjer: "example"

Dodatna polja: Ne

Stvori · Vrijednosti opcija — Varijante i opcije — Tijelo zahtjeva

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

color_hexNiz znakova nullNeobavezno

Boja prikazana heksadekadskim kodom.

Ograničenja · Niz znakova 1

pattern: "^#[0-9A-Fa-f]{6}$"

expected_versionCijeli brojObvezno

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

minimum: 1maximum: 9223372036854775807

Primjer: 1

valueNiz znakovaObvezno

Vrijednost opisana okolnom shemom.

minLength: 1maxLength: 180

Ograničenja

pattern: "^[^\\x00]*$"

Primjer: "Example"

Dodatna polja: Ne

Dohvati · Vrijednosti opcija — Varijante i opcije — Odgovor

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

color_hexNiz znakova nullObvezno: Boja prikazana heksadekadskim kodom.

Primjer: "#008855"
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. (VariantValueData).

Primjer: "example"
image_media_idNiz znakova nullObvezno: Identifikator odabrane slikovne datoteke.

Primjer: null
numberNiz znakovaObvezno: Broj narudžbe ili zahtjeva namijenjen korisniku.

Primjer: "example"
option_idNiz znakovaObvezno: Identifikator opcije varijante.

Primjer: "example"
positionCijeli brojObvezno: Položaj u uređenoj zbirci.

Primjer: 1
sku_codeNiz znakovaObvezno: Šifra skladišne jedinice.

Primjer: "example"
updated_atNiz znakovaObvezno: Vrijeme posljednjeg ažuriranja.

format: "date-time"

Primjer: "2026-01-01T12:00:00Z"
valueNiz znakova nullObvezno: Vrijednost opisana okolnom shemom.

Primjer: "example"
versionCijeli brojObvezno: Verzija resursa za kontrolu istodobnih upisa.

Primjer: 1

Dodatna polja: Ne

Ažuriraj · Vrijednosti opcija — Varijante i opcije — Tijelo zahtjeva

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

color_hexNiz znakova nullNeobavezno

Boja prikazana heksadekadskim kodom.

Ograničenja · Niz znakova 1

pattern: "^#[0-9A-Fa-f]{6}$"

expected_versionCijeli brojObvezno

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

minimum: 1maximum: 9223372036854775807

Primjer: 1

valueNiz znakova nullNeobavezno

Vrijednost opisana okolnom shemom.

Niz znakova:minLength: 1maxLength: 180

Ograničenja · Niz znakova 1

pattern: "^[^\\x00]*$"

Primjer: "Example"

Dodatna polja: Ne