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 > 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 atributeversion="1.0"imerchant(domen prodavnice, npr.primer-prodavnica.rs) i opcionigenerated_at(ISO 8601). - Redosled elemenata unutar
<product>i<offer>je slobodan. Prazni opcioni elementi se mogu izostaviti. - Znakove
& < >pišite kao& < >ili uCDATA.DOCTYPEiENTITYdeklaracije nisu dozvoljene. - Nepoznata polja zanemarujemo (validator ih prijavljuje kao upozorenje).
Polja proizvoda
| Polje | Status | Tip | Najviše | Primer | Pravilo |
|---|---|---|---|---|---|
id | Obavezno | tekst | 100 | TEL-X1-128-CRN | Jedinstven po varijanti; slova bez dijakritike, cifre i . _ - /. Ne menja se tokom vremena. |
item_group_id | Opciono | tekst | 100 | TEL-X1 | Isti za sve varijante jednog modela; varijante se moraju razlikovati po atributima. |
title | Obavezno | tekst | 200 | Primer Telefon X1 128 GB, crni | 5–200 znakova; brend + model + varijanta, bez promotivnog teksta. |
description | Opciono | tekst | 5000 | Ekran 6,1", 128 GB… | Običan tekst; HTML oznake uklanjamo. |
brand | Obavezno | tekst | 70 | Primer | Za proizvode bez brenda upisati proizvođača. |
gtin | Preporučeno | cifre | 14 | 8600000000011 | 8, 12, 13 ili 14 cifara sa ispravnom kontrolnom cifrom (EAN/UPC/GTIN). |
mpn | Preporučeno | tekst | 70 | PX1-128-BK | Šifra proizvođača. Bez GTIN-a i MPN-a povezivanje je ručno. |
category | Obavezno | putanja | 300 | Telefoni > Mobilni telefoni | Do 6 nivoa odvojenih sa ">", bez praznih nivoa. |
url | Obavezno | HTTPS URL | 2048 | https://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. |
image | Obavezno | HTTPS URL | 2048 | https://…/px1-crni-1200.jpg | Najmanje 500 × 500 px, JPG/PNG/WebP/AVIF, bez vodenog žiga. |
additional_images | Opciono | lista URL | 10 × 2048 | XML: <image>…</image>; CSV: odvojeno sa | | Do 10 dodatnih slika, ista pravila kao image. |
condition | Opciono | enum | — | new | new (podrazumevano), refurbished, used. |
warranty_months | Opciono | ceo broj | 0–120 | 24 | Garancija u mesecima. |
attributes | Preporučeno | naziv → vrednost | 30 × 100 | color = crna; storage_gb = 128 | Naziv: mala slova, cifre i _ (do 50); vrednost 1–100 znakova. CSV: color=crna|storage_gb=128. |
offers | Obavezno | lista ponuda | 6 | — | Najmanje jedna ponuda; najviše jedna po tržištu. |
Polja ponude (po tržištu)
| Polje | Status | Tip | Najviše | Primer | Pravilo |
|---|---|---|---|---|---|
market | Obavezno | enum | 2 | rs | rs, hr, si, ba, me, mk. U XML-u atribut elementa <offer>. |
currency | Obavezno | enum | 3 | RSD | Mora odgovarati tržištu: rs → RSD; hr, si, me → EUR; ba → BAM; mk → MKD. U XML-u atribut. |
price | Jedno od dva | decimalni broj | 12 + 2 dec. | 29990.00 | Cena sa PDV-om; tačka kao decimalni separator; bez valute i razmaka; > 0. |
price_minor | Jedno od dva | ceo broj | 14 cifara | 2999000 | Ista cena u najmanjoj jedinici (pare/centi). Ne slati zajedno sa price. |
old_price | Opciono | decimalni broj | 12 + 2 dec. | 32990.00 | Mora biti veća od price; inače se ne prikazuje. |
availability | Obavezno | enum | — | in_stock | in_stock, limited, out_of_stock, preorder, backorder. |
stock_quantity | Opciono | ceo broj | 0–1.000.000 | 14 | Broj komada na stanju. |
delivery_days_min | Opciono | ceo broj | 0–90 | 1 | Najkraći rok isporuke u radnim danima. |
delivery_days_max | Preporučeno | ceo broj | 0–90 | 3 | Najduži rok; ≥ delivery_days_min. |
shipping.known | Obavezno | logička | — | true | true ako je cena dostave poznata, false ako zavisi od adrese/težine. |
shipping.cost | Ako known=true | decimalni broj | 12 + 2 dec. | 390.00 | 0.00 za besplatnu dostavu; ne šalje se kad je known=false. |
shipping.free_from | Opciono | decimalni broj | 12 + 2 dec. | 10000.00 | Iznos 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.
| market | Tržište | currency |
|---|---|---|
rs | Srbija | RSD |
hr | Hrvatska | EUR |
si | Slovenija | EUR |
ba | Bosna i Hercegovina | BAM |
me | Crna Gora | EUR |
mk | Severna Makedonija | MKD |
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.