Câmpurile produselor

Campuri de baza

Informatiile trimise prin aceste campuri sunt informatiile de baza ale unui produs. Campurile de baza sunt campuri obligatorii, necesare pentru a putea lista un produs.

Atribut Format Descriere
UID [uid]

Obligatoriu

Text cu lungime maxima 255 caractere

Este un identificator unic pentru produse. Acest camp nu va fi afisat pe site, insa este util atunci cand se actualizeaza feed-ul pentru a se creea o legatura intre produsul din feed si cel din aplicatie si atunci cand se utilizeaza variante de produse.

Permite utilizeaza de litere si cifre si nu are o lungime fixa, poate avea pana la 255 caractere.
Exemple: 41067243733178, D105MVMBM
URL [url]

Obligatoriu

URL
Exemplu: https://example.com/

Adresa URL a produsului reprezinta adresa produsului din site-ul sursa al feed-ului. Aceasta adresa va fi utilizata pentru redirectare in momentul in care se acceseaza produsul din aplicatia EV.

Proprietatea conform Schema.org: Offer.​url
GTIN [gtin]

Optional

Text cu lungime maxima 255 caractere

GTIN, acronimul pentru Global Trade Item Number, asigura tuturor partenerilor comerciali un limbaj comun pentru a identifica unic, global articolul si pentru a comunica mai usor informatiile despre acesta. GTIN este total compatibil cu ISO/IEC15459 – Partea 4: Produse Individuale si Ambalaje de Produse

Printre valorile suportate pentru GTIN sunt:

  • UPC (in America de Nord / GTIN-12)
  • EAN (in Europa / GTIN-13)
  • JAN (in Japonia / GTIN-13)

 
SKU [sku]

Optional

Text cu lungime maxima 255 caractere

SKU, acronimul pentru Stock Keeping Unit, se refera la un cod prin care sunt gestionate stocurile unui produs.
Variant ID [variant_product_id]

Optional

UID - Valoarea campului UID de la produsul de baza

Campul este utilizat in cazul produselor care sunt variante ale unui produs de baza, pentru a semnala legatura intre produsul curent si cel de baza. Campul reprezinta valoarea UID a produsului de baza
Name [name]

Obligatoriu

Text cu lungime maxima 255 caractere

Campul nume este de fapt titlul produsului, valoare ce va fi afisata in pagina de produse sau in pagina produsului.

Proprietatea conform Schema.org: Product.name
Brand [brand]

Obligatoriu

Text cu lungime maxima 255 caractere

Reprezinta numele brandului produsului.

Proprietatea conform Schema.org: Product.brand.name
Price [price]

Obligatoriu

Valoare numerica cu 2 zecimale in format US
Exemplu: 199.99

Pretul produsului

Proprietatea conform Schema.org: Offer.price
Currency [currency]

Obligatoriu

Codul valutei in format ISO 4217
Exemplu: USD, RON, EUR

Valori permise:
RON

Moneda in care este exprimat pretul produsului

Proprietatea conform Schema.org: Offer.priceCurrency
Image [image]

Obligatoriu

URL-ul imaginii
Exemplu: https://example.com/image.png

URL-ul imaginii principale a produsului.
Adresa URL trebuie sa fie publica si sa poata fi accesata de crawler-ul aplicatiei.
Utilizati un format de imagine precum JPEG, PNG, GIF, BMP, TIFF.
Nu adaugati in poze watermark, texte, borduri, etc.

Proprietatea conform Schema.org: Product.image
Availability [availability]

Obligatoriu

Text cu lungime maxima 255 caractere

Valori permise:
in_stock, out_of_stock, preorder, backorder, check_stock

Campul reprezinta disponibilitatea produsului. Valoarea acestui camp trebuie sa fie una din lista de valori permise din coloana "Format".
Puteti utiliza acest camp impreuna cu Availability date [availability_date] pentru produsele care au disponibilitatea una din valorile preorder sau backorder pentru a mentiona data la care aceste produse vor putea fi disponibile.

Proprietatea conform Schema.org: Offer.availability
Status [status]

Obligatoriu

Text cu lungime maxima 255 caractere

Valori permise:
active, inactive

Campul reprezinta statusul produsului. Produsele inactive sunt produse indisponibile, din diverse motive.
Campul poate lua una din cele 2 valori din lista de valori disponibile.

Produsele inactive nu vor fi afisate pe site, in lista de produse!
Category [category_id]

Obligatoriu

Valoare numerica intreaga

Categoria din aplicatia EV din care face parte produsul. Campul reprezinta id-ul/codul (valoarea numerica) categoriei.
Orice produs listat pe site-ul EV trebuie sa faca parte dintr-o categorie. Lista de categorii disponibile in aplicatia EV, impreuna cu valoarea numerica (codul) de utilizat in acest camp, sunt disponibile in documentatie la pagina: Lista categorii
Campuri secundare

Informatiile trimise prin aceste campuri nu sunt informatii de baza pentru un produs, astfel ca aceste campuri nu sunt toate obligatorii. Totusi, este important sa furnizati cat mai multe informatii posibile pentru un produs.

Atribut Format Descriere
Stock [stock]

Optional

Valoare numerica intreaga

Stocul produselor reprezinta valoarea numerica sau cantitatea unitatilor disponibile. Campul trebuie sa fie in concordanta cu [availability] pentru a furniza o informatie corecta despre produs. Produsele cu stock 0 trebuie sa aiba in campul [availability] valoarea out_of_stock, iar cele cu valoare mai mare de 0 ar trebui sa aiba valoarea in_stock. Pentru celelalte valori din campul [availability] se poate utiliza orice cantitate in campul [stock].
Description [description]

Obligatoriu

Text

Reprezinta descrierea produsului, un text in format HTML care contine informatiile complete despre produs. Acest text va fi disponibil in pagina produsului si nu va fi afisat in lista de produse.
Campul trebuie sa contina informatii relevante despre produs.

Proprietatea conform Schema.org: Product.description
Images [images]

Optional

array

Pe langa imaginea principala a produsului trimisa prin campul [image], aplicatia EV permite adaugarea de imagini secundare folosind acest camp. Link-ul imaginilor va fi separat prin virgula, iar imaginile incluse in acest camp respecta aceleasi reguli ca si imaginea principala.
Model [model]

Optional

Text cu lungime maxima 255 caractere

Campul este utilizat pentru a descrie un model pentru produs. In combinatie cu [brand], acest camp poate fi utilizat pentru o reprezentare cat mai exacta a produsului.
Availability date [availability_date]

Optional

Data sau data impreuna cu ora. Formatul pentru data aaaa-ll-zz, iar pentru ora oo:mm:ss
Exemplu: 2022-10-20 sau 2022-10-20 00:10:10

Reprezinta data de la care un produs va deveni disponibil. Campul este utilizat in combinatie cu [availability], pentru cazurile in care produsul are disponibilitatea "backorder" sau "preorder".

Proprietatea conform Schema.org: Offer.availabilityStarts
Expiration date [expiration_date]

Optional

Data sau data impreuna cu ora. Formatul pentru data aaaa-ll-zz, iar pentru ora oo:mm:ss
Exemplu: 2022-10-20 sau 2022-10-20 00:10:10

Reprezinta data de la care un produs va deveni inactive si nu va mai fi afisat in site, asemenea produselor cu statusul inactiv.
Shipping cost [shipping_cost]

Optional

Valoare numerica cu 2 zecimale in format US
Exemplu: 199.99

Reprezinta valoarea transportului pentru produsul respectiv.
Shipping courier [shipping_courier]

Optional

Text cu lungime maxima 255 caractere

Numele companiei de curierat care livreaza produsul. Campul permite utilizarea mai multor nume, separate prin virgula, fiind un camp text.
Shipping label [shipping_label]

Optional

Text cu lungime maxima 255 caractere

Camp folosit pentru a afisa un mesaj specific transportului.
Exemplu: "Livrare in aceiasi zi."
Sale price [sale_price]

Optional

Valoare numerica cu 2 zecimale in format US
Exemplu: 199.99

Reprezinta pretul la oferta al produsului. Campul respecta regulile mentionate in campul [price]. Se utilizeaza in combinatie cu urmatorul camp [sale_expiration_date] pentru a mentiona data la care aceasta oferta se incheie.
Sale price expiration date [sale_price_expiration_date]

Optional

Data sau data impreuna cu ora. Formatul pentru data aaaa-ll-zz, iar pentru ora oo:mm:ss
Exemplu: 2022-10-20 sau 2022-10-20 00:10:10

Specifica data la care o oferta de pret pentru un produs se incheie. Se utilizeaza impreuna cu [sale_price].
Campul este unul de tip data si are formatul asemenea campurilor [expiration_date] sau [availability_date].
Weight [weight]

Optional

Text cu lungime maxima 255 caractere

Greutatea produsului, reprezentata in format numeric impreuna cu unitatea de masura.

Exemplu: 1.5 Kg

Sunt permise valori zecimale sau intregi, iar unitatile de masura permise sunt: Kg, g, lb, oz.

Proprietatea conform Schema.org: Product.weight
Height [height]

Optional

Text cu lungime maxima 255 caractere

Reprezinta inaltimea produsului. Campul este utilizat impreuna cu [width] si [length] pentru a descrie dimensiunile produsului.

Exemplu: 40 cm

Sunt permise valori zecimale sau intregi, iar unitatile de masura permise sunt: cm, m.
Width [width]

Optional

Text cu lungime maxima 255 caractere

Reprezinta latimea produsului. Campul este utilizat impreuna cu [height] si [length] pentru a descrie dimensiunile produsului.

Exemplu: 40 cm

Sunt permise valori zecimale sau intregi, iar unitatile de masura permise sunt: cm, m.
Length [length]

Optional

Text cu lungime maxima 255 caractere

Reprezinta lungimea produsului. Campul este utilizat impreuna cu [height] si [width] pentru a descrie dimensiunile produsului.

Exemplu: 40 cm

Sunt permise valori zecimale sau intregi, iar unitatile de masura permise sunt: cm, m.
Condition [condition]

Optional

Text cu lungime maxima 255 caractere

Reprezinta starea produsului. Poate lua valori precum new, refurbished sau used.

Proprietatea conform Schema.org: Offer.itemCondition
Color [color]

Optional

Text cu lungime maxima 255 caractere

Campul este folosit pentru a descrie culoarea produsului.

Proprietatea conform Schema.org: Product.color
Tax [tax]

Optional

Valoare procent
Exemplu: 19%

Reprezinta valoarea procentuala a taxelor aplicate produsului (incluse in pretul produsului). Valoarea campului este formata din valoarea numerica si semnul procent (%).
Este utilizat de exemplu in cazul TVA-ului produsului
Warranty [warranty]

Optional

Text cu lungime maxima 255 caractere
Campuri de caracteristici

Campurile de caracteristici difera in functie de categoria din care face parte produsul si sunt descrie in documentatia pentru fiecare categorie de produs in parte.

Atribute produs