XML navodila za trgovce

01 /

Od vaše trgovine do naših kupcev

Trije koraki do urejenega podatkovnega vira.

01

Pripravite podatke

Izvozite izdelke v XML ali nam posredujte obstoječi feed za preverjanje preslikave.

02

Preverite svoj feed

V checker vnesite URL in preglejte napake ter priporočila za izboljšave.

03

Oddajte za vključitev

Posredujte preverjeni URL naši ekipi, ki uskladi uvoz in objavo.

02 /

Pravi podatki za vsak izdelek

Za nov XML uporabite spodnja imena polj. Vsaka prodajna varianta je svoj zapis z lastnim, stabilnim SKU.

PoljeKaj poslati

skuOsnovno

Vaš enolični in trajni ID ponudbe. Ob spremembi cene ali zaloge ga ne spreminjajte.

PrimerSHIRT-001-M

product_nameOsnovno

Jasen naziv izdelka z znamko, modelom in pomembno različico.

PrimerAcme majica Essential, črna, M

product_categoryOsnovno

Celotna pot kategorije v vaši trgovini.

PrimerOblačila > Majice

product_brandOsnovno

Dejanska znamka ali proizvajalec. Če znamke ni, se dogovorite z našo ekipo; ne izmišljajte si je.

PrimerAcme

product_urlOsnovno

Povezava na izdelek oziroma izbrano varianto brez UTM-parametrov. Ohranite parametre, potrebne za izbiro variante.

Primerhttps://example.com/essential?size=M

product_priceOsnovno

Redna cena z DDV v valuti trga. Decimalna pika, brez oznake valute in ločil tisočic.

Primer29.90

product_image_urls / product_image_urlOsnovno

Neposredne povezave do slik. Vsak URL v svojem elementu; za preverjanje priporočamo najmanj 500 × 500 px.

Primerhttps://example.com/images/essential.jpg

product_mpnPriporočeno

Izvirna oznaka modela proizvajalca, kadar obstaja.

PrimerESSENTIAL-01

product_eanPriporočeno

Pravi EAN/GTIN konkretne variante. Ohranite začetne ničle; ne ustvarjajte nadomestnih kod.

PrimerEAN/GTIN

product_descriptionPriporočeno

Opis in specifikacije v UTF-8, brez oglasnih sporočil, povezav, skript in slogov CSS.

PrimerBombažna majica z okroglim izrezom.

product_stockPriporočeno

Število kosov na zalogi, tudi 0. Če natančnega števila ne poznate, uporabite product_availability.

Primer12

product_availabilityPriporočeno

Razpoložljivost, kadar ne pošiljate količine. Če pošljete obe polji, naj si ne nasprotujeta.

Primerin stock / available for order / out of stock

attributesPriporočeno

Preverjene lastnosti izdelka kot pari key/value, z enotami, kjer so potrebne.

PrimerColor: Black · Size: M

group_idPo potrebi

Stabilna oznaka povezanih variant znotraj trgovine. Pravila grupiranja najprej uskladite z našo ekipo.

PrimerESSENTIAL-BLACK

product_price_discountPo potrebi

Dejanska akcijska cena z DDV. Kadar akcije ni, polje izpustite oziroma pustite prazno.

Primer24.90

product_delivery_pricePo potrebi

Cena dostave v valuti trga. 0 pomeni brezplačno dostavo; prazno polje ne pomeni brezplačne dostave.

Primer3.90

product_conditionPo potrebi

Stanje izdelka: 1 = nov, 2 = obnovljen, 3 = rabljen.

Primer1

product_isbnPo potrebi

Za knjige pošljite pravi ISBN. Pri drugih izdelkih ga izpustite.

Primer9780306406157

product_warrantyPo potrebi

Trajanje garancije z jasno navedeno enoto.

Primer24 mesecev

product_remarkPo potrebi

Kratka in aktualna opomba o ponudbi.

PrimerBrezplačna dostava nad 50 EUR.

Osnovna polja so minimum za tehnično preverjanje. Podatke izpolnite za vsak izdelek; rezultat checkerja še ne pomeni potrjenega uvoza ali objave.

03 /

Primer, ki ga lahko uporabite

Začnite z osnovnim zapisom ali dodajte podatke za bogatejšo predstavitev. Primeri so izmišljeni; URL-je in vrednosti zamenjajte s svojimi.

products.xml

Osnovni XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <sku>SHIRT-001-M</sku>
    <product_name>Acme majica Essential, črna, M</product_name>
    <product_category>Oblačila &gt; Majice</product_category>
    <product_brand>Acme</product_brand>
    <product_url>https://example.com/essential?size=M</product_url>
    <product_price>29.90</product_price>
    <product_image_urls>
      <product_image_url>https://example.com/images/essential.jpg</product_image_url>
    </product_image_urls>
  </product>
</products>

Razširjeni XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <sku>SHIRT-001-M</sku>
    <product_name>Acme majica Essential, črna, M</product_name>
    <product_category>Oblačila &gt; Majice</product_category>
    <product_brand>Acme</product_brand>
    <product_url>https://example.com/essential?size=M</product_url>
    <product_price>29.90</product_price>
    <product_image_urls>
      <product_image_url>https://example.com/images/essential.jpg</product_image_url>
    </product_image_urls>
    <product_mpn>ESSENTIAL-01</product_mpn>
    <product_description>Bombažna majica z okroglim izrezom.</product_description>
    <product_stock>12</product_stock>
    <product_price_discount>24.90</product_price_discount>
    <product_delivery_price>3.90</product_delivery_price>
    <product_condition>1</product_condition>
    <attributes>
      <attribute>
        <key>Color</key>
        <value>Black</value>
      </attribute>
      <attribute>
        <key>Size</key>
        <value>M</value>
      </attribute>
    </attributes>
  </product>
</products>

Stalen SKU

Isti izdelek naj pri vsakem izvozu ohrani isti identifikator.

Veljaven XML

Znak & zapišite kot &. Besedilo lahko zaščitite tudi s CDATA.

Ena slika, en element

Več slik pošljite z več elementi product_image_url.

04 /

Različice naj bodo povezane pravilno

Vsaka varianta ima svoj SKU, ceno, zalogo in ustrezno povezavo. group_id povezuje samo variante, za katere je grupiranje dogovorjeno.

group_idESSENTIAL-BLACK

M

Velikost Msku: SHIRT-001-M

L

Velikost Lsku: SHIRT-001-L

Ponazoritev dogovorjene skupine: isti model in barva, dve velikosti.

Pred uporabo uskladite pravila grupiranja. Enak group_id lahko vpliva na povezovanje z istim kataloškim izdelkom; različni modeli ali kapacitete ne sodijo samodejno v isto skupino.

Primer prikazuje odnos med identifikatorji. Za dejanski uvoz dodajte vsa osnovna polja za vsako varianto.

05 /

Pripravljen za naslednji korak?

Objavite feed na stalnem URL-ju, preverite rezultat in nato uskladite vključitev z našo ekipo.

Stalen in dostopen URL

Feed naj bo dostopen za samodejni prevzem. Checker vas opozori na težave pri dostopu.

Aktualne cene in zaloga

Feed osvežujte najmanj dnevno in ob pomembnih spremembah. Pogostost našega prevzema uskladimo ob vključitvi.

Pregled konkretnih napak

Preverite število pregledanih izdelkov in vzorce napak. Pregled slik in produktnih strani je vzorčen.

Preverite, preden oddate

Feed checker pomaga poiskati manjkajoča polja, težave s formatom in slikami ter priložnosti za izboljšave.

Preveri moj feed ↗

Tehnični pregled ne vključi trgovine in ne objavi izdelkov.

Oddaj trgovino za vključitev

06 /

Še nekaj koristnih odgovorov

Že imam Google, Meta ali drug feed. Moram narediti novega?

Najprej preverite obstoječi feed. Checker prepozna več pogostih imen polj in XML/CSV. Prepoznava še ne zagotavlja pravilne preslikave za uvoz; to uskladimo ob vključitvi.

Ali »Ready« pomeni, da je vsak izdelek pravilen?

Ne. Checker trenutno dopušča manjše vrzeli pri obveznih poljih, če vsako doseže najmanj 95 % pokritosti. Preglejte tudi opozorila in prizadete izdelke. Rezultat ni potrditev objave.

Kaj pošljem, če nimam EAN ali MPN?

Pošljite samo dejanske identifikatorje, ki obstajajo za izdelek. Ne izmišljajte si kod in ne uporabljajte iste kode za različne variante. Manjkajoče podatke uskladite pri vključitvi.

Kaj naredim, ko izdelka ni več na zalogi?

Posodobite količino na 0 oziroma razpoložljivost na out of stock. Obravnavo izdelkov, ki izginejo iz feeda, uskladite z našo ekipo; odstranitev zapisa ni enaka sporočilu o zalogi.

Zakaj checker sprejme tudi ceno z oznako valute?

Checker zaradi združljivosti sprejme nekatere oznake valute. Za nov XML vseeno uporabite čisto številko, npr. 29.90, v pravilni valuti trga. Sprejeta številka ne potrjuje valute.

Vaši izdelki.Pripravljeni za objavo.