Intrebari frecventeSpecificatii datafeedArticol

Ce este un fisier de date (datafeed)?

Listarea produselor pe ShopMania se face prin intermediul unui datafeed in format txt, CSV sau XML. Acesta este un fisier ce contine informatii detaliate despre produsele tale cum ar fi numele, pretul, categoria etc. Campurile intr-un datafeed sunt separate cu pipe (|), iar randurile cu linie noua (\n).

Aceasta este formatarea si ordonarea unui datafeed standard in format txt si CSV:

categorie cu cale completa | producator | model | cod produs | nume produs | descriere | URL produs | URL imagine | pret | moneda | cost transport | disponibilitate | GTIN (UPC/EAN/ISBN)

Campurile obligatorii sunt urmatoarele: Categorie, Cod produs, Nume produs, URL produs, URL imagine si Pret. Campul GTIN este de asemenea obligatoriu in cazul cartilor; in acest caz trebuie adaugat codul ISBN. Obligativitatea se refera in primul rand la prezenta unei informatii corecte in campul respectiv, si nu la simpla existenta a coloanelor corespunzatoare in feed. Pentru o listare corecta a produselor este recomandat ca datafeedul sa contina toate campurile si nu doar pe cele obligatorii.

Campurile incluse in datafeed trebuie sa contina urmatoarele informatii:

Camp Descriere Exemplu
Categorie Trebuie sa contina categoria site-ului tau cu calea completa de la categoria "radacina" la categoria in care sunt listate produsele.

Limita: 255 caractere
Electrocasnice > Electrocasnice pentru ingrijire personala > Aparate de ras
Producator Trebuie sa contina numele marcii produsului.

Limita: 100 caractere
Nokia
Model Trebuie sa contina codul de identificare al producatorului (MPN, EAN, UPC sau ISBN).

Limita: 100 caractere
Pentru placa video Gigabyte Nvidia GeForce 210 512MB DDR2, modelul este "GV-N210OC-512I"
Cod produs Codul unic dupa care un produs este indentificat in magazinul tau. Se recomanda ca acest cod sa ramana neschimbat pe toata durata listarii produsului in cadrul sistemului de comparatii.

Limita: 100 caractere
12345, 12346, 123457
Nume produs Numele produsului, asa cum apare pe site-ul tau.

Limita: 255 caractere
Placa video Gigabyte Nvidia GeForce 210 512MB
Descriere produs Descrierea produsului; nu este recomandat sa contina taguri HTML, cod Javascript, imagini sau orice alt tip de fisier multimedia.

Limita: 200 caractere
Aparatul foto D3100 incredibil de usor de utilizat, este raspunsul oricarei familii pentru fotografii frumoase
URL produs URL-ul catre pagina de produs. http://example.com/view-product?prod-id=12345
URL imagine URL-ul catre imaginea principala a produsului. Este recomandat ca imaginea sa aiba dimensiune cat mai mare, sa aiba o calitate buna, sa fie in conformitate cu produsul. Imaginile de produs nu trebuie sa aiba watermark si sa contina mesaje promotionale. http://example.com/images/12345.jpg
Pret produs Pretul produsului trebuie sa contina toate evantualele taxe care se aplica la achizitionare, mai putin cele de livrare pentru care exista o coloana separata.

Nu se accepta preturi care sunt valabile doar pentru anumite categorii de clienti.
Pretul nu trebuie sa includa moneda: RON.
120.45
Moneda Moneda in care este exprimat pretul. RON
Cost livrare Costul de livrare al produsului.

Pentru afisarea costului de livrare inclus in feed trebuie sa bifezi optiunea "Definit pentru fiecare produs in parte" in sectiunea de Configurari - Configurari livrare din contul tau. Costul de livrare sa fie exprimat in aceeasi moneda ca pretul produsului. Costurile de livrare trebuie sa includa toate taxele aplicabile.

Pentru a indica faptul ca livrarea este gratuita trebuie sa introduci valoarea 0.
2.5
Disponibilitate Contine specificatii cu privire la disponibilitatea unui produs. Valorile acceptate pentru acest camp sunt:
- In stock / In stoc: Aceasta valoare trebuie inclusa in cazul in care exista certitudinea ca produsul va fi livrat (sau se va afla in curs de livrare catre client) in 3 zile lucratoare cel mult. De exemplu, in cazul in care produsul exista deja in depozit.
- Available for order / Disponibil la comanda: Aceasta valoare trebuie inclusa in cazul in care livrarea catre client dureaza cel putin 4 zile lucratoare. De exemplu, in cazul in care produsul nu se afla in depozit in acest moment, dar exista certitudinea ca acesta va sosi in urmatoarele cateva zile. In cazul produselor inca nelasante, trebuie folosita valoarea Preorder / Disponibil cu precomanda.
- Out of stock / Stoc epuizat: In prezent magazinul nu accepta comenzi pentru respectivul produs.
- Preorder / Disponibil cu precomanda: Magazinul accepta comenzi pentru respectivul produs, dar acesta nu a fost inca lansat.

Nota: In cazul in care folosesti alte valori pentru campul Disponibilitate in fisierul de date, trebuie sa accesezi panoul tau de control ShopMania si sa faci corespondenta intre aceste valori si cele folosite in sistemul ShopMania.
In stock / In stoc
GTIN (UPC/EAN/ISBN) Codurile GTIN reprezinta un set de identificatori unici de produs si includ codurile UPC - Universal Product Code, codurile EAN - European Article Number (in Europa) si codurile ISBN - International Standard Book Number.

Aceste valori sunt de o importanta ridicata pentru a corela cautarile utilizatorilor cu produsele tale. Furnizarea codurilor ISBN in cazul cartilor este obligatorie. In orice caz, recomandam includerea identificatorilor GTIN pentru toate produsele in fisierul de date, deoarece aceste informatii ar putea deveni obligatorii in viitor.

Mai multe informatii despre codurile GTIN pot fi accesate pe Wikipedia.
- UPC: numar unic de identificare pentru produse comerciale, de obicei asociat codurilor de bare;
Numar format din 12 cifre, spre exemplu 001234567891
Mai multe informatii despre codurile UPC pot fi accesate pe Wikipedia.

- EAN: numar unic de identificare pentru produse comerciale, de obicei asociat codurilor de bare;
Numar format din 13 cifre, spre exemplu 1001234567891
Mai multe informatii despre codurile EAN pot fi accesate pe Wikipedia.

- ISBN: numar unic de identificare pentru carti, de obicei aflat pe spatele acestora alaturi de codul de bare;
Numar format din 10 sau 13 cifre, spre exemplu 0451524233
In cazul detinerii ambelor formate, trebuie inclus codul format din 13 cifre;
Mai multe informatii despre codurile ISBN pot fi accesate pe Wikipedia.


Datafeed in format XML

Se pot prelucra si fisiere in format XML, cu conditia ca acestea sa contina cel putin campurile obligatorii. Poti sa definesti propriile taguri pentru campurile din datafeed sau sa le folosesti pe cele din exemplu.

Exemplu datafeed XML:

<store>
<products>
...
<Product>
<MPC>12554</MPC>
<Category>Computers - Monitors</Category>
<Manufacturer>Samsung</Manufacturer >
<MPN>12350</MPN>
<Name>SyncMaster 206BW</Name>
<Description>Samsung 15.6" Widescreen LCD - 1360x768, 500... </Description>
<URL>http://www.example.com/products.php?id=a3057</URL>
<Image>http://www.example.com/products.jpg</Image>
<Price>431</Price>
<Currency>RON</Currency>
<Shipping>15</Shipping>
<Availability>In stock / In stoc</Availability>
<GTIN>1001234567891</GTIN>
</Product>


Observatii:

- Produsele pentru care nu ni se ofera informatii corecte in campurile marcate ca obligatorii vor fi automat respinse. In panoul de control in sectiunea "Statistici produse" gasesti informatiile necesare privind campurile respinse;
- Campurile lipsa sunt separate de doua caractere consecutive. Exemplu feed care nu contine campul Model: categorie | producator | | cod produs | nume produs | descriere produs | url produs | | pret | moneda | livrare
- Descrierea produselor nu trebuie sa contina informatii legate de promotii sau reduceri de pret, taguri html, costuri de livrare sau doar text in majuscule;
- Inainte de a fi afisate in feed, informatiile trebuie sa fie curatate de randuri noi sau de alte caractere care se folosesc drept separatori de coloana;
- Categoria produsului trebuie sa fie completa: Categoria / Subcategoria1 / subcategoria2. Exemplu: Calculatoare – Periferice – Monitoare. Sunt acceptate doar datafeedurile care contin categoriile de produse proprii site-ului care solicita listarea pe ShopMania si nu cele care folosesc categoriile din sistemul ShopMania;
- URL-urile de produs si de imagine trebuie sa fie complete si sa inceapa cu http://
- Disponibilitatea unui produs trebuie indicata in mod clar pe site-ul tau, in pagina produsului, fie prin afisarea explicita a status-ului (In stock / In stoc, Available for order / Disponibil la comanda, Out of stock / Stoc epuizat, Preorder / Disponibil cu precomanda) sau prin mentionarea numarului de zile necesare pentru livrarea produsului. Produsele care nu mai sunt comercializate de catre magazine trebuie sa fie eliminate complet din fisierul de date.

Upload-ul datafeedului in contul ShopMania

Trebuie sa te loghezi in contul tau ShopMania si sa accesezi meniul Setari - Setari Upload. In functie de tipul feedului, trebuie sa alegi modalitatea de upload (auto sau manual) si sa introduci URL-ul catre datafeed in cazul fisierelor automate sau sa uploadezi fisierul manual.

Metode de upload

1. Auto - pentru crearea datafeed-ului, ShopMania iti pune la dispozitie scripturi automate pentru majoritatea platormelor ecommerce: OSCommerce, OSCommerce v3, ZenCart, Virtuemart, Virtuemart 2, JoomShopping, phpShop, CSCart, CSCart 4, XCart, CubeCart, SunShop, OpenCart, PHPMass, OOS Shop, xtCommerce, Interspire, PrestaShop, Magento, Shop-Script, Shop-Script Premium, Creloaded, QuickCart, PinnacleCart, Ubercart, TomatoCart, eShop, ShopperPress, WP e-Commerce, WP e-Commerce 3.8, WP Online Store, WP Store, WP StoreBox, WooCommerce, LogiVert, INDIGO Shop, PHP + MySQL, ASP + MySQL.

Pentru site-urile care nu folosesc una din platformele enumerate mai sus, punem la dispozitie modele de scripturi PHP + MySQL, ASP + MySQL, ASP + SQLServer si ASP + MsAccess pentru generarea datafeedului insa acestea trebuie customizate de catre un programator pentru a se potrivi cu structura bazei de date a site-ului tau.

Click aici pentru mai multe informatii despre instalarea scripturilor

2. Manual - este recomandat ca numarul maxim de produse sa fie de 50. Fisierul trebuie actualizat la un interval de maxim 30 de zile si de fiecare data atunci cand au loc schimbari de pret sau stoc. Daca fisierul folosit pentru upload nu este actualizat si reincarcat in cont timp de mai mult de 30 de zile, listarea produselor va fi suspendata automat.

In general, dureaza intre 1 si 3 zile lucratoare pana se aproba datafeed-ul si produsele sunt listate pe site. In cazul in care a trecut aceasta perioada si nu ai primit nicio notificare ca datafeed-ul a fost acceptat sau respins, te rugam sa ne contactezi pe adresa de email support@shopmania.ro.

Listat in: Specificatii datafeed