IVO
Înapoi la centrul de ajutor
Integrare Merchant

Formatul feedului de produse

Formate JSON, XML și CSV acceptate, maparea câmpurilor, imagini, valori implicite și variante.

URL-uri de feed acceptate

IVO poate citi feeduri de produse dintr-un URL public în format JSON, XML, Google Shopping RSS/XML sau CSV. URL-ul trebuie să returneze direct conținutul feedului și să fie accesibil crawlerului IVO.md.

Structură JSON

Feedul poate fi o listă de produse sau un obiect care conține lista, de exemplu {"products": [...]}, {"product": [...]}, {"offers": [...]} sau o listă de produse într-o structură mai adâncă. IVO caută cea mai mare listă de produse când structura este imbricată.

Structură XML

IVO acceptă feeduri XML obișnuite, inclusiv itemi Google Shopping RSS și cataloage simple de produse.

Structură CSV

Feedurile CSV trebuie să aibă antet pe primul rând. Delimitatoarele virgulă, punct și virgulă, tab și bară verticală sunt detectate automat.

Câmpuri obligatorii

Câmpurile minime obligatorii sunt name și price. Moneda poate fi inclusă în preț, mapată separat ca currency sau setată ca valoare implicită.

Maparea câmpurilor

În previzualizarea integrării, IVO afișează fiecare cheie sursă din feed. Atribuie fiecare cheie câmpului IVO corespunzător. Mai multe chei pot fi atribuite aceluiași câmp. Pentru text, cum ar fi name sau description, valorile se concatenează. Pentru image, toate URL-urile valide de imagine sunt colectate.

Imagini

Folosește un singur câmp țintă: image. Poți mapa chei precum image, images, image_1, image_2, image_link sau gallery. Sunt acceptate și liste de URL-uri.

Valori implicite

Dacă feedul nu conține o valoare precum moneda, brandul, categoria, disponibilitatea, imaginea sau descrierea, poți seta o valoare fixă în configurarea integrării.

Variante

Pentru detaliile variantelor, mapează doar dimensiuni explicite precum color, size, memory sau display la variant_option. Mai multe chei sursă pot fi mapate la variant_option.

{
  "name": "Laptop 14 Ultra / 32GB / Silver",
  "price": 15999,
  "variant_option": ["memory:32GB", "color:Silver"]
}

Dacă feedul conține deja un item_group_id de încredere, IVO îl poate citi intern, dar nu îl deduce automat, deoarece o grupare greșită poate uni produse diferite ca variante.

Identificarea crawlerului

Cererile către feed folosesc acest User-Agent:

IVO.md (+https://ivo.md/help/merchant-integration/ivo-md-crawler)

Ți-a fost util acest articol?

Spune-ne rapid dacă ți-a fost de ajutor.

Articole similare

Integrare Merchant

Referință API Merchant

Referință completă pentru API-ul de comerciant: autentificare, toate endpoint-urile și semnificația fiecărui câmp de intrare și de ieșire.

Integrare Merchant

Extensii: cum funcționează

O prezentare generală despre cum extensiile IVO se instalează, se autorizează, sincronizează și raportează statusul.

Integrare Merchant

Extensie Magento 2: instalare

Instalează extensia Magento 2 pentru IVO Marketplace și conectează magazinul la IVO.

Integrare Merchant

Extensie OpenCart 4: instalare

Instalează extensia OpenCart pentru IVO Marketplace și conectează magazinul la IVO.