Scheme de date: Produse

Scheme de date: Produse. Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

Scheme de date

Listează — Produse — Răspuns

ApiResponse_list_ProductSummaryData__ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

dataTablou <ProductSummaryData > Obligatoriu: Exemplu de răspuns · ApiResponse_list_ProductSummaryData__.

Exemplu: [{"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

Obține — Produse — Răspuns

ApiResponse_ProductDetailData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

dataProductDetailData Obligatoriu: Exemplu de răspuns · ProductDetailData.

Exemplu: {"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 Obligatoriu: Metadatele răspunsului.

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

Câmpuri suplimentare: Nu

Informații despre disponibilitate în contextul selectat

AvailabilityData · Schemă · Scheme de date: Produse

available_fromȘir de caractere nullObligatoriu: Începutul disponibilității.

Șir de caractere:format: "date-time"

Exemplu: null
available_untilȘir de caractere nullObligatoriu: Sfârșitul disponibilității.

Șir de caractere:format: "date-time"

Exemplu: null
is_availableValoare booleanăObligatoriu: Indică dacă articolul este disponibil în acest context.

Exemplu: true

Câmpuri suplimentare: Nu

Informații despre preț în contextul selectat

PriceData · Schemă · Scheme de date: Produse

amountȘir de caractereObligatoriu

Sumă zecimală codificată ca șir JSON; null numai unde este permis.

Exemplu: "0.00"

currencyȘir de caractereObligatoriu

Codul monedei în care este exprimată suma.

Restricții

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

Exemplu: "PLN"

minor_unitsNumăr întregObligatoriu

Numărul de zecimale folosite de monedă.

minimum: 0maximum: 4

Exemplu: 2

tax_includedValoare booleanăObligatoriu

Indică dacă prețul trimis include taxele.

Exemplu: true

Câmpuri suplimentare: Nu

Informații despre lista de prețuri

PriceListData · Schemă · Scheme de date: Produse

currencyȘir de caractereObligatoriu: Codul monedei în care este exprimată suma.
idȘir de caractereObligatoriu: Identificatorul resursei; păstrați-l în forma returnată. (PriceListData).
tax_includedValoare booleanăObligatoriu: Indică dacă prețul trimis include taxele.
versionNumăr întregObligatoriu: Versiunea resursei folosită pentru controlul concurenței.

Câmpuri suplimentare: Nu

Creează — Produse — Corpul cererii

ProductCreate · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

brand_idȘir de caractere nullOpțional

Identificatorul mărcii.

Șir de caractere:minLength: 1maxLength: 63

conditionȘir de caractereOpțional

Starea produsului.

Restricții

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

Valoare implicită: "new"

descriptionȘir de caractere nullOpțional

Descriere în limba selectată.

Șir de caractere:maxLength: 100000

feature_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale caracteristicilor.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpțional

Codurile de identificare ale produsului.

market_idsTablou <Șir de caractere> Opțional

Identificatorii piețelor selectate.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

media_idsTablou <Șir de caractere> Opțional

Identificatorii fișierelor media deja existente.

maxItems: 20

Tablou:minLength: 1maxLength: 63

meta_descriptionȘir de caractere nullOpțional

Descriere pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 160

meta_keywordsTablou <Șir de caractere> nullOpțional

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Tablou:maxItems: 20

Tablou / Tablou:maxLength: 50

meta_titleȘir de caractere nullOpțional

Titlu pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 70

nameȘir de caractereObligatoriu

Numele resursei în contextul relevant.

minLength: 1maxLength: 300

Exemplu: "Example"

pricingProductPrice Opțional

Configurația prețurilor și versiunile pentru controlul concurenței.

primary_category_idȘir de caractere nullOpțional

Identificatorul categoriei principale.

Șir de caractere:minLength: 1maxLength: 63

publishedValoare booleanăOpțional

Indică dacă resursa este publicată.

Valoare implicită: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

minLength: 1maxLength: 100

Restricții

pattern: "^\\S+$"

Exemplu: "example"

slugȘir de caractere nullOpțional

Segmentul căii URL în limba selectată.

Șir de caractere:maxLength: 160

tax_category_idȘir de caractere nullOpțional

Identificatorul categoriei fiscale.

Șir de caractere:minLength: 1maxLength: 63

variant_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale variantelor.

maxItems: 250

Tablou:minLength: 1maxLength: 63

variants_enabledValoare booleanăOpțional

Indică dacă produsul folosește variante.

Valoare implicită: false

Câmpuri suplimentare: Nu

Obține — Produse — Răspuns

ProductDetailData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

availabilityAvailabilityData Obligatoriu

Informații despre disponibilitate în contextul selectat.

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

brand_idȘir de caractere nullObligatoriu

Identificatorul mărcii.

Exemplu: null

conditionȘir de caractereObligatoriu

Starea produsului.

Restricții

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

Exemplu: "new"

created_atȘir de caractereObligatoriu

Momentul creării.

format: "date-time"

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

descriptionȘir de caractere nullObligatoriu

Descriere în limba selectată.

Exemplu: "example"

featuresTablou <FeatureSelectionData > Obligatoriu

Caracteristicile produsului.

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

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductDetailData).

Exemplu: "example"

identifiersObiectCâmpuri suplimentare: Șir de caractereObligatoriu

Codurile de identificare ale produsului.

Exemplu: {}

mediaTablou <ProductMediaData > Obligatoriu

Informații despre fișierele media atașate.

Exemplu:

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

meta_descriptionȘir de caractere nullObligatoriu

Descriere pentru motoarele de căutare, în limba selectată.

Exemplu: "example"

meta_keywordsTablou <Șir de caractere> nullObligatoriu

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Exemplu: ["example"]

meta_titleȘir de caractere nullObligatoriu

Titlu pentru motoarele de căutare, în limba selectată.

Exemplu: "example"

nameȘir de caractere nullObligatoriu

Numele resursei în contextul relevant.

Exemplu: "Example"

numberȘir de caractereObligatoriu

Numărul comenzii sau al solicitării, destinat utilizatorilor.

Exemplu: "example"

pricePriceData nullObligatoriu

Informații despre preț în contextul selectat.

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

price_versionNumăr întregObligatoriu

Versiunea curentă a prețului, pentru controlul concurenței.

Exemplu: 1

primary_category_idȘir de caractere nullObligatoriu

Identificatorul categoriei principale.

Exemplu: "example"

primary_media_idȘir de caractere nullObligatoriu

Identificatorul fișierului media principal.

Exemplu: "example"

publishedValoare booleanăObligatoriu

Indică dacă resursa este publicată.

Exemplu: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

Exemplu: "example"

slugȘir de caractere nullObligatoriu

Segmentul căii URL în limba selectată.

Exemplu: "example"

tax_category_idȘir de caractereObligatoriu

Identificatorul categoriei fiscale.

Exemplu: "example"

updated_atȘir de caractereObligatoriu

Momentul celei mai recente actualizări.

format: "date-time"

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

variants_enabledValoare booleanăObligatoriu

Indică dacă produsul folosește variante.

Exemplu: false

versionNumăr întregObligatoriu

Versiunea resursei folosită pentru controlul concurenței.

Exemplu: 1

Câmpuri suplimentare: Nu

Codurile de identificare ale produsului

ProductIdentifiers · Schemă · Scheme de date: Produse

eanȘir de caractere nullOpțional: Identificatorul EAN al produsului.

Șir de caractere:minLength: 1maxLength: 100
isbnȘir de caractere nullOpțional: Identificatorul ISBN.

Șir de caractere:minLength: 1maxLength: 100
mpnȘir de caractere nullOpțional: Codul de produs al producătorului.

Șir de caractere:minLength: 1maxLength: 100
upcȘir de caractere nullOpțional: Identificatorul UPC al produsului.

Șir de caractere:minLength: 1maxLength: 100

Câmpuri suplimentare: Nu

Informații despre fișierele media atașate

ProductMediaData · Schemă · Scheme de date: Produse

alt_textȘir de caractere nullObligatoriu

Text alternativ pentru o imagine.

Exemplu: "example"

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductMediaData).

Exemplu: "example"

is_primaryValoare booleanăObligatoriu

Indică dacă acesta este elementul principal.

Exemplu: true

kindȘir de caractereObligatoriu

Varianta structurii de date, descrisă prin valorile permise.

Restricții

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

Exemplu: "image"

mime_typeȘir de caractereObligatoriu

Tipul conținutului media.

Exemplu: "image/jpeg"

positionNumăr întregObligatoriu

Poziția în colecția ordonată.

Exemplu: 1

urlȘir de caractere nullObligatoriu

URL-ul resursei.

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

Câmpuri suplimentare: Nu

Configurația prețurilor și versiunile pentru controlul concurenței

ProductPrice · Schemă · Scheme de date: Produse

amountȘir de caractere nullObligatoriu

Sumă zecimală codificată ca șir JSON; null numai unde este permis.

Șir de caractere:maxLength: 19

Restricții · Șir de caractere 1

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

Exemplu: "0.00"

currencyȘir de caractereObligatoriu

Codul monedei în care este exprimată suma.

Restricții

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

Exemplu: "PLN"

expected_price_list_versionNumăr întregObligatoriu

Versiunea listei de prețuri citită anterior, necesară pentru această scriere.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

expected_versionNumăr întregObligatoriu

Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 0maximum: 9223372036854775807

Exemplu: 0

kindȘir de caractereObligatoriu

Varianta structurii de date, descrisă prin valorile permise.

Restricții

enum: ["base", "market_fixed"]

Exemplu: "base"

price_list_idȘir de caractereObligatoriu

Identificatorul listei de prețuri.

minLength: 1maxLength: 63

Exemplu: "example"

tax_includedValoare booleanăObligatoriu

Indică dacă prețul trimis include taxele.

Exemplu: true

Câmpuri suplimentare: Nu

Listează — Produse — Răspuns

ProductSummaryData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

availabilityAvailabilityData Obligatoriu

Informații despre disponibilitate în contextul selectat.

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

brand_idȘir de caractere nullObligatoriu

Identificatorul mărcii.

Exemplu: null

conditionȘir de caractereObligatoriu

Starea produsului.

Restricții

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

Exemplu: "new"

created_atȘir de caractereObligatoriu

Momentul creării.

format: "date-time"

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

idȘir de caractereObligatoriu

Identificatorul resursei; păstrați-l în forma returnată. (ProductSummaryData).

Exemplu: "example"

nameȘir de caractere nullObligatoriu

Numele resursei în contextul relevant.

Exemplu: "Example"

numberȘir de caractereObligatoriu

Numărul comenzii sau al solicitării, destinat utilizatorilor.

Exemplu: "example"

pricePriceData nullObligatoriu

Informații despre preț în contextul selectat.

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

price_versionNumăr întregObligatoriu

Versiunea curentă a prețului, pentru controlul concurenței.

Exemplu: 1

primary_category_idȘir de caractere nullObligatoriu

Identificatorul categoriei principale.

Exemplu: "example"

primary_media_idȘir de caractere nullObligatoriu

Identificatorul fișierului media principal.

Exemplu: "example"

publishedValoare booleanăObligatoriu

Indică dacă resursa este publicată.

Exemplu: false

skuȘir de caractereObligatoriu

Codul unității de stoc.

Exemplu: "example"

slugȘir de caractere nullObligatoriu

Segmentul căii URL în limba selectată.

Exemplu: "example"

tax_category_idȘir de caractereObligatoriu

Identificatorul categoriei fiscale.

Exemplu: "example"

updated_atȘir de caractereObligatoriu

Momentul celei mai recente actualizări.

format: "date-time"

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

variants_enabledValoare booleanăObligatoriu

Indică dacă produsul folosește variante.

Exemplu: false

versionNumăr întregObligatoriu

Versiunea resursei folosită pentru controlul concurenței.

Exemplu: 1

Câmpuri suplimentare: Nu

Actualizează — Produse — Corpul cererii

ProductUpdate · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

brand_idȘir de caractere nullOpțional

Identificatorul mărcii.

Șir de caractere:minLength: 1maxLength: 63

conditionȘir de caractereOpțional

Starea produsului.

Restricții

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

descriptionȘir de caractere nullOpțional

Descriere în limba selectată.

Șir de caractere:maxLength: 100000

Exemplu: null

expected_variant_price_versionsObiectCâmpuri suplimentare: Număr întreg

minimum: 0maximum: 9223372036854775807

Opțional

Versiunile prețurilor citite anterior, indexate după identificatorul variantei.

maxProperties: 250

Restricții

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

expected_versionNumăr întregObligatoriu

Versiunea citită înainte de scriere; o neconcordanță respinge actualizarea.

minimum: 1maximum: 9223372036854775807

Exemplu: 1

feature_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale caracteristicilor.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

identifiersProductIdentifiers nullOpțional

Codurile de identificare ale produsului.

market_idsTablou <Șir de caractere> Opțional

Identificatorii piețelor selectate.

maxItems: 1000

Tablou:minLength: 1maxLength: 63

media_idsTablou <Șir de caractere> Opțional

Identificatorii fișierelor media deja existente.

maxItems: 20

Tablou:minLength: 1maxLength: 63

meta_descriptionȘir de caractere nullOpțional

Descriere pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 160

meta_keywordsTablou <Șir de caractere> nullOpțional

Cuvinte-cheie pentru motoarele de căutare, în limba selectată.

Tablou:maxItems: 20

Tablou / Tablou:maxLength: 50

meta_titleȘir de caractere nullOpțional

Titlu pentru motoarele de căutare, în limba selectată.

Șir de caractere:maxLength: 70

nameȘir de caractere nullOpțional

Numele resursei în contextul relevant.

Șir de caractere:maxLength: 300

Exemplu: null

pricingProductPrice Opțional

Configurația prețurilor și versiunile pentru controlul concurenței.

Exemplu:

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

primary_category_idȘir de caractere nullOpțional

Identificatorul categoriei principale.

Șir de caractere:minLength: 1maxLength: 63

publishedValoare booleanăOpțional

Indică dacă resursa este publicată.

skuȘir de caractereOpțional

Codul unității de stoc.

minLength: 1maxLength: 100

Restricții

pattern: "^\\S+$"

Exemplu: "example"

slugȘir de caractere nullOpțional

Segmentul căii URL în limba selectată.

Șir de caractere:maxLength: 160

tax_category_idȘir de caractere nullOpțional

Identificatorul categoriei fiscale.

Șir de caractere:minLength: 1maxLength: 63

variant_value_idsTablou <Șir de caractere> Opțional

Identificatorii valorilor selectate ale variantelor.

maxItems: 250

Tablou:minLength: 1maxLength: 63

variants_enabledValoare booleanăOpțional

Indică dacă produsul folosește variante.

Câmpuri suplimentare: Nu