Šeme podataka: Varijante i opcije

Šeme podataka: Varijante i opcije. Polja, tipovi i ograničenja podataka koje API prihvata ili vraća.

Šeme podataka

Prikaži listu · Varijante proizvoda — Varijante i opcije — Odgovor

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

dataNiz vrednosti <ProductVariantData > Obavezno: Primer odgovora · ApiResponse_list_ProductVariantData__.

Primer: [{"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 Obavezno: Metapodaci 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

Prikaži listu · Opcije — Varijante i opcije — Odgovor

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

dataNiz vrednosti <shopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData > Obavezno: Primer odgovora · ApiResponse_list_VariantOptionData__.

Primer: [{"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 Obavezno: Metapodaci 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

Prikaži listu · Vrednosti opcija — Varijante i opcije — Odgovor

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

dataNiz vrednosti <VariantValueData > Obavezno: Primer odgovora · ApiResponse_list_VariantValueData__.

Primer: [{"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 Obavezno: Metapodaci 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

Preuzmi · Varijante proizvoda — Varijante i opcije — Odgovor

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

dataProductVariantData Obavezno: Primer odgovora · ProductVariantData.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Preuzmi · Opcije — Varijante i opcije — Odgovor

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

datashopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData Obavezno: Primer odgovora · shopently_engine__domains__catalog__adapters__public_http__dictionaries__schemas__VariantOptionData.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Preuzmi · Vrednosti opcija — Varijante i opcije — Odgovor

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

dataVariantValueData Obavezno: Primer odgovora · VariantValueData.

Primer: {"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 Obavezno: Metapodaci odgovora.

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

Dodatna polja: Ne

Preuzmi · Opcije — Varijante i opcije — Odgovor

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

created_atNiz znakovaObavezno

Vreme kreiranja.

format: "date-time"

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

idNiz znakovaObavezno

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

Primer: "example"

nameNiz znakova nullObavezno

Naziv resursa u odgovarajućem kontekstu.

Primer: "Example"

numberNiz znakovaObavezno

Broj porudžbine ili zahteva namenjen korisniku.

Primer: "example"

positionCeli brojObavezno

Položaj u uređenoj kolekciji.

Primer: 1

selection_typeNiz znakovaObavezno

Dozvoljen način odabira vrednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

Primer: "button"

updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"

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

value_presentation_typeNiz znakovaObavezno

Način prikaza vrednosti šifrarnika.

Ograničenja

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

Primer: "text"

versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

Preuzmi · Varijante proizvoda — Varijante i opcije — Odgovor

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

activeLogička vrednostObavezno: Da li je resurs aktivan.

Primer: true
created_atNiz znakovaObavezno: Vreme kreiranja.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"
idNiz znakovaObavezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. (ProductVariantData).

Primer: "example"
is_defaultLogička vrednostObavezno: Da li je ovo podrazumevani odabir.

Primer: true
media_idsNiz vrednosti <Niz znakova> Obavezno: Identifikatori već postojećih medijskih datoteka.

Primer: ["example"]
positionCeli brojObavezno: Položaj u uređenoj kolekciji.

Primer: 1
pricingVariantPricingData Obavezno: Postavke cena i njihove verzije za kontrolu istovremenih upisa.

Primer: {"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 nullObavezno: Identifikator glavne medijske datoteke.

Primer: "example"
product_idNiz znakovaObavezno: Identifikator proizvoda.

Primer: "example"
skuNiz znakovaObavezno: Šifra skladišne jedinice.

Primer: "example"
updated_atNiz znakovaObavezno: Vreme poslednjeg ažuriranja.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"
valuesNiz vrednosti <VariantChoiceData > Obavezno: Vrednosti šifrarnika.

Primer: [{"option_id":"example","option_name":"example","value":"example","value_id":"example"}]
versionCeli brojObavezno: Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

Vrednosti šifrarnika

VariantChoiceData · Šema · Šeme podataka: Varijante i opcije

option_idNiz znakovaObavezno: Identifikator opcije varijante.

Primer: "example"
option_nameNiz znakova nullObavezno: Naziv opcije varijante.

Primer: "example"
valueNiz znakova nullObavezno: Vrednost opisana okolnom šemom.

Primer: "example"
value_idNiz znakovaObavezno: Identifikator vrednosti šifrarnika.

Primer: "example"

Dodatna polja: Ne

Kreiraj · Varijante proizvoda — Varijante i opcije — Telo zahteva

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

activeLogička vrednostOpciono

Da li je resurs aktivan.

Podrazumevano: true

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

is_defaultLogička vrednostOpciono

Da li je ovo podrazumevani odabir.

media_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori već postojećih medijskih datoteka.

maxItems: 20

Niz vrednosti:minLength: 1maxLength: 63

pricingVariantPrice Opciono

Postavke cena i njihove verzije za kontrolu istovremenih upisa.

skuNiz znakovaOpciono

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

value_idsNiz vrednosti <Niz znakova> Obavezno

Identifikatori vrednosti šifrarnika.

minItems: 1maxItems: 250

Niz vrednosti:minLength: 1maxLength: 63

Primer: ["example"]

Dodatna polja: Ne

Kreiraj · Opcije — Varijante i opcije — Telo zahteva

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

nameNiz znakovaObavezno

Naziv resursa u odgovarajućem kontekstu.

minLength: 1maxLength: 120

Ograničenja

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

Primer: "Example"

selection_typeNiz znakovaOpciono

Dozvoljen način odabira vrednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

Podrazumevano: "button"

value_presentation_typeNiz znakovaOpciono

Način prikaza vrednosti šifrarnika.

Ograničenja

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

Podrazumevano: "text"

Dodatna polja: Ne

Ažuriraj · Opcije — Varijante i opcije — Telo zahteva

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

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

nameNiz znakova nullOpciono

Naziv resursa u odgovarajućem kontekstu.

Niz znakova:minLength: 1maxLength: 120

Ograničenja · Niz znakova 1

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

Primer: "Example"

selection_typeNiz znakovaOpciono

Dozvoljen način odabira vrednosti svojstva.

Ograničenja

enum: ["button", "dropdown"]

value_presentation_typeNiz znakovaOpciono

Način prikaza vrednosti šifrarnika.

Ograničenja

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

Dodatna polja: Ne

Postavke cena i njihove verzije za kontrolu istovremenih upisa

VariantPrice · Šema · Šeme podataka: Varijante i opcije

amountNiz znakova nullObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

Niz znakova:maxLength: 20

Ograničenja · Niz znakova 1

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

Primer: "0.00"

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja

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

Primer: "PLN"

expected_price_list_versionCeli brojObavezno

Prethodno pročitana verzija cenovnika potrebna za ovaj upis.

minimum: 1maximum: 9223372036854775807

Primer: 1

expected_product_versionCeli brojObavezno

Prethodno pročitana verzija proizvoda potrebna za ovaj upis.

minimum: 0maximum: 9223372036854775807

Primer: 1

expected_versionCeli brojObavezno

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

minimum: 0maximum: 9223372036854775807

Primer: 0

kindNiz znakovaObavezno

Varijanta strukture podataka opisana dozvoljenim vrednostima.

Ograničenja

enum: ["base_adjustment", "market_fixed"]

Primer: "base_adjustment"

price_list_idNiz znakovaObavezno

Identifikator cenovnika.

minLength: 1maxLength: 63

Primer: "example"

Dodatna polja: Ne

Postavke cena i njihove verzije za kontrolu istovremenih upisa

VariantPricingData · Šema · Šeme podataka: Varijante i opcije

base_adjustmentMoneyData Obavezno: Prilagođavanje u odnosu na osnovnu cenu.

Primer: {"amount":"0.00","currency":"PLN","minor_units":2}
market_priceMoneyData nullObavezno: Cena za odabrano tržište.

Primer: null
pricePriceData nullObavezno: Podaci o ceni u odabranom kontekstu.

Primer: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
product_versionCeli brojObavezno: Trenutna verzija proizvoda za kontrolu istovremenih upisa.

Primer: 1
versionCeli brojObavezno: Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

Ažuriraj · Varijante proizvoda — Varijante i opcije — Telo zahteva

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

activeLogička vrednostOpciono

Da li je resurs aktivan.

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

is_defaultLogička vrednostOpciono

Da li je ovo podrazumevani odabir.

media_idsNiz vrednosti <Niz znakova> Opciono

Identifikatori već postojećih medijskih datoteka.

maxItems: 20

Niz vrednosti:minLength: 1maxLength: 63

pricingVariantPrice Opciono

Postavke cena i njihove verzije za kontrolu istovremenih upisa.

Primer:

{"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 znakovaOpciono

Šifra skladišne jedinice.

minLength: 1maxLength: 100

Ograničenja

pattern: "^\\S+$"

Primer: "example"

Dodatna polja: Ne

Kreiraj · Vrednosti opcija — Varijante i opcije — Telo zahteva

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

color_hexNiz znakova nullOpciono

Boja prikazana heksadekadskim kodom.

Ograničenja · Niz znakova 1

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

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

valueNiz znakovaObavezno

Vrednost opisana okolnom šemom.

minLength: 1maxLength: 180

Ograničenja

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

Primer: "Example"

Dodatna polja: Ne

Preuzmi · Vrednosti opcija — Varijante i opcije — Odgovor

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

color_hexNiz znakova nullObavezno: Boja prikazana heksadekadskim kodom.

Primer: "#008855"
created_atNiz znakovaObavezno: Vreme kreiranja.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"
idNiz znakovaObavezno: Identifikator resursa; sačuvajte ga u vraćenom obliku. (VariantValueData).

Primer: "example"
image_media_idNiz znakova nullObavezno: Identifikator odabrane slikovne datoteke.

Primer: null
numberNiz znakovaObavezno: Broj porudžbine ili zahteva namenjen korisniku.

Primer: "example"
option_idNiz znakovaObavezno: Identifikator opcije varijante.

Primer: "example"
positionCeli brojObavezno: Položaj u uređenoj kolekciji.

Primer: 1
sku_codeNiz znakovaObavezno: Šifra skladišne jedinice.

Primer: "example"
updated_atNiz znakovaObavezno: Vreme poslednjeg ažuriranja.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"
valueNiz znakova nullObavezno: Vrednost opisana okolnom šemom.

Primer: "example"
versionCeli brojObavezno: Verzija resursa za kontrolu istovremenih upisa.

Primer: 1

Dodatna polja: Ne

Ažuriraj · Vrednosti opcija — Varijante i opcije — Telo zahteva

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

color_hexNiz znakova nullOpciono

Boja prikazana heksadekadskim kodom.

Ograničenja · Niz znakova 1

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

expected_versionCeli brojObavezno

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

minimum: 1maximum: 9223372036854775807

Primer: 1

valueNiz znakova nullOpciono

Vrednost opisana okolnom šemom.

Niz znakova:minLength: 1maxLength: 180

Ograničenja · Niz znakova 1

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

Primer: "Example"

Dodatna polja: Ne