Documentație

Ghid de integrare — cum să structurezi feed-urile pentru import automat pe ePretz.ro

1. Câmpuri obligatorii

CâmpTipDescriere

idREQ

stringSKU unic al produsului în magazinul tău

titleREQ

stringTitlul complet al produsului (max 300 caractere)

priceREQ

decimalPrețul de vânzare (fără monedă, ex: 2499.99)

currencyREQ

stringCodul monedei ISO 4217 (RON, EUR, USD)

stockREQ

enumin_stock | out_of_stock | preorder

urlREQ

urlLink direct la pagina produsului

image_url

urlImagine principală (JPG/PNG, min 200×200px)

brand

stringMarca produsului (îmbunătățește matching-ul)

category

stringCategoria din magazinul tău

ean

stringCod EAN/GTIN (13 cifre) — îmbunătățește deduplicarea

description

textDescriere scurtă (max 1000 caractere)

2. Format XML

Structura recomandată pentru feed-urile XML. Elementul rădăcină poate fi <products>, <catalog> sau <offers>.

feed.xml

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <id>SKU-001</id>
    <title>Laptop ASUS VivoBook 15 X1502ZA</title>
    <description>Laptop performant cu procesor Intel Core i5</description>
    <price>2499.99</price>
    <currency>RON</currency>
    <stock>in_stock</stock>
    <url>https://magazin.ro/laptop-asus-vivobook</url>
    <image_url>https://magazin.ro/images/asus-vivobook.jpg</image_url>
    <brand>ASUS</brand>
    <category>Laptopuri</category>
    <ean>4711387154138</ean>
  </product>
</products>

3. Format CSV

Prima linie trebuie să conțină header-ele coloanelor. Separatorul implicit este virgula (,). Titlurile cu virgulă internă se pun între ghilimele.

feed.csv

id,title,price,currency,stock,url,image_url,brand,category
SKU-001,"Laptop ASUS VivoBook 15",2499.99,RON,in_stock,https://...,https://...,ASUS,Laptopuri
SKU-002,"Telefon Samsung Galaxy S25",4599.00,RON,in_stock,https://...,https://...,Samsung,Telefoane

4. Reguli de validare

Feed-ul trebuie să fie accesibil public printr-un URL HTTPS

Encoding recomandat: UTF-8

Prețul se specifică fără simbol monedă și cu punct decimal (2499.99, nu 2.499,99)

URL-urile de imagine trebuie să returneze JPG sau PNG (nu redirect)

Câmpul id trebuie să fie unic în cadrul aceluiași feed

Nu include prețuri de 0 — produsele cu preț 0 sunt ignorate

Nu include caractere de control XML (<, >, &) necodate în titluri

Nu include produse cu aceeași imagine generică „image_unavailable"

5. Întrebări frecvente

Cât de des sunt sincronizate feed-urile?

Feed-urile active sunt sincronizate de 2 ori pe zi (dimineața și după-amiaza). După prima importare, actualizările de preț și stoc apar în maxim 12 ore.

Pot importa produse fără URL de feed?

Da — lasă câmpul URL gol și echipa ePretz te va contacta pentru a stabili metoda de import (upload manual de fișier, SFTP etc.).

Cum sunt eliminate produsele duplicate?

Platforma folosește un algoritm de matching bazat pe titlu, brand și cod EAN. Produsele identice din magazine diferite sunt grupate automat — nu apar ca duplicate.

Pot actualiza prețul unui produs fără să reimport totul?

Da, dacă feed-ul tău este sincronizat regulat, modificările de preț din feed se reflectă automat la următoarea sincronizare.

Ce se întâmplă dacă un produs din feed nu mai există în magazin?

Produsul este marcat automat ca out_of_stock și nu mai apare în rezultatele de căutare, dar istoricul de prețuri se păstrează.

Ai nevoie de ajutor cu integrarea?

Echipa noastră tehnică te poate ajuta să configurezi feed-ul și să verifici că importul funcționează corect.

Contactează-ne la b2b@epretz.ro →