Specifikacija · verzija 1.0

isplati-feed 1.0

Jedan model podataka u tri zapisa: XML, CSV i JSON. Polja i pravila su ista u sva tri; razlikuje se samo način zapisa. Sve vrednosti su u UTF-8.

Struktura

Feed opisuje proizvode (jedan proizvod = jedna varijanta) i njihove ponude po tržištima. Proizvod nosi podatke koji ne zavise od tržišta (naziv, brend, GTIN, slike), a ponuda cenu, valutu, dostupnost, rok i dostavu za jedno tržište.

<?xml version="1.0" encoding="UTF-8"?>
<isplati_feed version="1.0" merchant="primer-prodavnica.rs" generated_at="2026-11-22T08:00:00+01:00">
  <products>
    <product>
      <id>TEL-X1-128-CRN</id>
      <item_group_id>TEL-X1</item_group_id>
      <title>Primer Telefon X1 128 GB, crni</title>
      <brand>Primer</brand>
      <gtin>8600000000011</gtin>
      <mpn>PX1-128-BK</mpn>
      <category>Telefoni &gt; Mobilni telefoni</category>
      <url>https://www.primer-prodavnica.rs/telefoni/primer-x1-128-crni</url>
      <image>https://www.primer-prodavnica.rs/slike/px1-crni-1200.jpg</image>
      <warranty_months>24</warranty_months>
      <attributes>
        <attribute name="color">crna</attribute>
        <attribute name="storage_gb">128</attribute>
      </attributes>
      <offers>
        <offer market="rs" currency="RSD">
          <price>29990.00</price>
          <availability>in_stock</availability>
          <delivery_days_min>1</delivery_days_min>
          <delivery_days_max>3</delivery_days_max>
          <shipping known="true"><cost>390.00</cost><free_from>10000.00</free_from></shipping>
        </offer>
        <offer market="me" currency="EUR">
          <price_minor>25900</price_minor>
          <availability>limited</availability>
          <shipping known="false"/>
        </offer>
      </offers>
    </product>
  </products>
</isplati_feed>
  • Koreni element <isplati_feed> ima obavezne atribute version="1.0" i merchant (domen prodavnice, npr. primer-prodavnica.rs) i opcioni generated_at (ISO 8601).
  • Redosled elemenata unutar <product> i <offer> je slobodan. Prazni opcioni elementi se mogu izostaviti.
  • Znakove & < > pišite kao &amp; &lt; &gt; ili u CDATA. DOCTYPE i ENTITY deklaracije nisu dozvoljene.
  • Nepoznata polja zanemarujemo (validator ih prijavljuje kao upozorenje).

Polja proizvoda

PoljeStatusTipNajvišePrimerPravilo
idObaveznotekst100TEL-X1-128-CRNJedinstven po varijanti; slova bez dijakritike, cifre i . _ - /. Ne menja se tokom vremena.
item_group_idOpcionotekst100TEL-X1Isti za sve varijante jednog modela; varijante se moraju razlikovati po atributima.
titleObaveznotekst200Primer Telefon X1 128 GB, crni5–200 znakova; brend + model + varijanta, bez promotivnog teksta.
descriptionOpcionotekst5000Ekran 6,1", 128 GB…Običan tekst; HTML oznake uklanjamo.
brandObaveznotekst70PrimerZa proizvode bez brenda upisati proizvođača.
gtinPreporučenocifre1486000000000118, 12, 13 ili 14 cifara sa ispravnom kontrolnom cifrom (EAN/UPC/GTIN).
mpnPreporučenotekst70PX1-128-BKŠifra proizvođača. Bez GTIN-a i MPN-a povezivanje je ručno.
categoryObaveznoputanja300Telefoni > Mobilni telefoniDo 6 nivoa odvojenih sa ">", bez praznih nivoa.
urlObaveznoHTTPS URL2048https://www.primer-prodavnica.rs/…Na domenu iz atributa merchant (ili poddomenu); port 443; bez redirekta, affiliate i click-id parametara; od UTM-a samo utm_source=isplati.se, utm_medium, utm_campaign.
imageObaveznoHTTPS URL2048https://…/px1-crni-1200.jpgNajmanje 500 × 500 px, JPG/PNG/WebP/AVIF, bez vodenog žiga.
additional_imagesOpcionolista URL10 × 2048XML: <image>…</image>; CSV: odvojeno sa |Do 10 dodatnih slika, ista pravila kao image.
conditionOpcionoenum—newnew (podrazumevano), refurbished, used.
warranty_monthsOpcionoceo broj0–12024Garancija u mesecima.
attributesPreporučenonaziv → vrednost30 × 100color = crna; storage_gb = 128Naziv: mala slova, cifre i _ (do 50); vrednost 1–100 znakova. CSV: color=crna|storage_gb=128.
offersObaveznolista ponuda6—Najmanje jedna ponuda; najviše jedna po tržištu.

Polja ponude (po tržištu)

PoljeStatusTipNajvišePrimerPravilo
marketObaveznoenum2rsrs, hr, si, ba, me, mk. U XML-u atribut elementa <offer>.
currencyObaveznoenum3RSDMora odgovarati tržištu: rs → RSD; hr, si, me → EUR; ba → BAM; mk → MKD. U XML-u atribut.
priceJedno od dvadecimalni broj12 + 2 dec.29990.00Cena sa PDV-om; tačka kao decimalni separator; bez valute i razmaka; > 0.
price_minorJedno od dvaceo broj14 cifara2999000Ista cena u najmanjoj jedinici (pare/centi). Ne slati zajedno sa price.
old_priceOpcionodecimalni broj12 + 2 dec.32990.00Mora biti veća od price; inače se ne prikazuje.
availabilityObaveznoenum—in_stockin_stock, limited, out_of_stock, preorder, backorder.
stock_quantityOpcionoceo broj0–1.000.00014Broj komada na stanju.
delivery_days_minOpcionoceo broj0–901Najkraći rok isporuke u radnim danima.
delivery_days_maxPreporučenoceo broj0–903Najduži rok; ≥ delivery_days_min.
shipping.knownObaveznologička—truetrue ako je cena dostave poznata, false ako zavisi od adrese/težine.
shipping.costAko known=truedecimalni broj12 + 2 dec.390.000.00 za besplatnu dostavu; ne šalje se kad je known=false.
shipping.free_fromOpcionodecimalni broj12 + 2 dec.10000.00Iznos porudžbine od kog je dostava besplatna.

Više tržišta i valuta

Jedan feed može da sadrži ponude za više tržišta. Svaka ponuda je u valuti svog tržišta — ne preračunavamo kurseve i ne mešamo valute.

marketTržištecurrency
rsSrbijaRSD
hrHrvatskaEUR
siSlovenijaEUR
baBosna i HercegovinaBAM
meCrna GoraEUR
mkSeverna MakedonijaMKD

Varijante

Svaka kombinacija boje, kapaciteta, veličine ili pakovanja je poseban proizvod sa sopstvenim id, cenom i GTIN-om. Varijante istog modela imaju isti item_group_id i razlikuju se bar po jednom atributu. Preporučeni nazivi atributa: color, storage_gb, ram_gb, size, pack_size, weight_g, volume_ml, material.

CSV zapis

UTF-8, prvi red je zaglavlje, separator zarez (,), tačka-zarez (;) ili tab. Vrednosti sa separatorom ili navodnicima stavite pod navodnike, a navodnik udvojite (""). Jedan red = jedna ponuda: proizvod koji se prodaje na dva tržišta ima dva reda sa istim id (podaci o proizvodu se uzimaju iz prvog reda). Dodatne slike i atributi idu u jednu kolonu, odvojeni znakom |.

id,item_group_id,title,description,brand,gtin,mpn,category,url,image,additional_images,condition,warranty_months,attributes,market,currency,price,price_minor,old_price,availability,stock_quantity,delivery_days_min,delivery_days_max,shipping_known,shipping_cost,shipping_free_from

Obavezne kolone u zaglavlju: id, title, market i price ili price_minor. Dostava: shipping_known (true/false), shipping_cost, shipping_free_from.

JSON zapis

{
  "format": "isplati-feed",
  "version": "1.0",
  "merchant": "primer-prodavnica.rs",
  "products": [
    {
      "id": "TEL-X1-128-CRN",
      "title": "Primer Telefon X1 128 GB, crni",
      "brand": "Primer",
      "gtin": "8600000000011",
      "category": "Telefoni > Mobilni telefoni",
      "url": "https://www.primer-prodavnica.rs/telefoni/primer-x1-128-crni",
      "image": "https://www.primer-prodavnica.rs/slike/px1-crni-1200.jpg",
      "attributes": {"color": "crna", "storage_gb": "128"},
      "offers": [
        {"market": "rs", "currency": "RSD", "price": "29990.00", "availability": "in_stock",
         "delivery_days_max": 3, "shipping": {"known": true, "cost": "390.00"}}
      ]
    }
  ]
}

Iznose šaljite kao tekst ("29990.00") ili kao price_minor ceo broj, da izbegnete greške zaokruživanja decimalnih brojeva.

XSD šema i validator

isplati-feed-1.0.xsd proverava strukturu XML-a, tipove i dozvoljene vrednosti. Pravila koja XSD ne može da izrazi — tačno jedno od price/price_minor, valuta po tržištu, domen linka, kontrolna cifra GTIN-a, UTM i affiliate pravila, jedinstven id — proverava validator. Feed koji prođe validator bez grešaka spreman je za probni uvoz.

Promene formata objavljujemo kao novu verziju; verzija 1.0 ostaje podržana najmanje 12 meseci od objave sledeće.