Za prodavnice · isplati-feed 1.0
Pošaljite katalog proizvoda
Jedan fajl sa vašim proizvodima, cenama, dostupnošću i dostavom je dovoljan da vaše ponude uđu u poređenje na isplati.se. Ovaj vodič objašnjava kako se povezuje feed, šta proveravamo i zašto neka stavka može biti odbijena.
Načini povezivanja
XML feed na adresi
Feed u formatu isplati-feed na stalnoj HTTPS adresi vaše prodavnice. Adresu unosite u partner portalu; preuzimamo je mi, po dogovorenom rasporedu.
CSV tabela
Ista polja kao XML, jedan red po ponudi (proizvod × tržište). Pogodno za izvoz iz Excela ili ERP-a. UTF-8, zarez ili tačka-zarez.
JSON
Za prodavnice sa sopstvenim API-jem ili programerima. Ista struktura kao XML, objekat sa listom products.
WooCommerce dodatak
Dodatak koji sam pravi feed iz WooCommerce prodavnice, bez ručnog izvoza. U pripremi; do tada koristite XML ili CSV izvoz.
Postojeći Google Merchant ili drugi XML feed možemo privremeno prihvatiti uz ručno mapiranje polja, ali za brže i tačnije povezivanje preporučujemo isplati-feed.
Povezivanje korak po korak
- Prijavite prodavnicu. Nalog, podaci firme i veb-sajt u prijavi partnera. Ulistavanje je besplatno.
- Pripremite feed. Napravite fajl po specifikaciji ili krenite od primera (XML, CSV, JSON).
- Proverite ga validatorom. Validator odmah pokazuje greške po stavci i polju. Ništa se ne čuva.
- Pošaljite adresu feeda. Posle verifikacije firme unosite HTTPS adresu feeda ili otpremate fajl u portalu.
- Probni uvoz. Pregledamo prvi uvoz, povezujemo proizvode sa katalogom i javljamo šta je odbijeno i zašto.
- Ponude su vidljive. Odobrene ponude ulaze u poređenje na izabranim tržištima i osvežavaju se automatski.
Koliko često osvežavamo
- Feed preuzimamo najmanje na svakih 6 sati; za veće prodavnice dogovaramo češće osvežavanje.
- Ponuda koja nije potvrđena u poslednjih 24 sata se skriva iz poređenja dok je sledeći uvoz ne potvrdi. Zato feed mora biti stalno dostupan.
- Uz svaku cenu kupcima prikazujemo kada je poslednji put proverena („Provereno pre X“).
- Feed treba da sadrži ceo aktivan asortiman. Proizvod koji nestane iz feeda tretiramo kao da više nije u ponudi.
Pravila za podatke
- Jedna stavka = jedna varijanta. Telefon 128 GB i 256 GB, crni i plavi, pakovanje 5 kg i 10 kg su različite stavke sa svojim
id. Povežite ih istimitem_group_idi atributima koji ih razlikuju. - Cena sa PDV-om, u valuti tržišta. Decimalno sa tačkom (
29990.00) ili kao ceo broj u parama/centima (price_minor=2999000). Valuta: RSD za Srbiju, EUR za Hrvatsku, Sloveniju i Crnu Goru, BAM za BiH, MKD za Severnu Makedoniju. Bez oznake valute i razmaka u broju. - Stara cena samo ako je stvarna.
old_pricemora biti veća od trenutne. Sniženje kupcu ne ističemo na osnovu stare cene prodavca, već na osnovu istorije koju sami beležimo. - Dostupnost:
in_stock(na stanju),limited(malo komada),out_of_stock(nema),preorder(prednarudžbina),backorder(po porudžbini). - Dostava je obavezan podatak. Ako znate cenu dostave, pošaljite je (
0.00za besplatnu) i po želji prag besplatne dostave. Ako cena zavisi od adrese ili težine, pošaljiteknown="false": tada kupcima ne računamo ukupnu cenu i to jasno pišemo. - EAN/GTIN sa ispravnom kontrolnom cifrom (8, 12, 13 ili 14 cifara) i MPN (šifra proizvođača) su najvažniji za tačno povezivanje. Bez njih povezujemo ručno i sporije.
- Brend je obavezan; za proizvode bez brenda upišite proizvođača.
- Kategorija je putanja iz vaše prodavnice, nivoi odvojeni znakom
>(npr.Telefoni > Mobilni telefoni). Mi je mapiramo na našu taksonomiju. - Slike: HTTPS, najmanje 500 × 500 px, JPG/PNG/WebP/AVIF, proizvod na neutralnoj pozadini, bez vodenih žigova, natpisa o akciji i okvira.
- Link proizvoda je kanonska HTTPS adresa stranice proizvoda na vašem domenu. Dozvoljeni su samo
utm_source=isplati.se,utm_mediumiutm_campaign. Affiliate parametri, redirekti, skraćeni linkovi i linkovi na drugi domen nisu dozvoljeni — klikove merimo sami. - Naziv je brend + model + varijanta, bez promotivnog teksta („AKCIJA“, „!!!“, „besplatna dostava“).
Kvalitet i razlozi odbijanja
Stavka sa greškom se ne objavljuje; ostatak feeda se uvozi normalno. Upozorenja ne blokiraju objavu, ali smanjuju tačnost poređenja.
| Razlog | Šta se dešava | Kako ispraviti |
|---|---|---|
| Nedostaje obavezno polje (id, naziv, brend, kategorija, link, slika, cena, dostupnost, dostava) | Stavka odbijena | Popunite polje u izvozu |
| Valuta ne odgovara tržištu ili cena nije broj | Stavka odbijena | Cena sa tačkom, valuta tržišta |
| Link na drugi domen, redirekt ili affiliate parametar | Stavka odbijena | Direktan link na stranicu proizvoda |
| Neispravna kontrolna cifra GTIN-a | Stavka odbijena | Proverite EAN sa pakovanja |
Isti id dva puta | Druga stavka odbijena | Jedinstven id po varijanti |
| Nagla promena cene (npr. 90% niže od prethodne) ili promena valute | Ponuda ide na ručnu proveru pre objave | Ništa, ako je cena tačna |
| Slika manja od 500 px ili nedostupna | Ponuda bez slike ili odbijena | Veća slika na HTTPS adresi |
| Dostava nepoznata | Objavljeno, bez ukupne cene | Pošaljite cenu dostave |
| Nema GTIN-a ni MPN-a | Objavljeno posle ručnog povezivanja | Dodajte GTIN ili MPN |
Kako povezujemo vaše proizvode
Svaku stavku povezujemo sa tačnom varijantom proizvoda u našem katalogu, kako bi kupac poredio iste stvari:
- Prvo po GTIN/EAN kodu.
- Zatim po brendu + MPN-u.
- Na kraju po brendu, modelu i atributima varijante (kapacitet, boja, pakovanje). Automatski spajamo samo kad je poklapanje nedvosmisleno; ostalo proverava čovek.
Nikad ne spajamo različite varijante (npr. 128 GB i 256 GB). Ponude koje ne možemo sigurno da povežemo ostaju na čekanju i vidite ih u portalu.
Redosled ponuda na sajtu ne zavisi od provizije ni oglašavanja — rangiramo po ukupnoj ceni, ceni i svežini podataka.
Česta pitanja
Da li moram da koristim isplati-feed format?
Ne nužno, ali je to najbrži put. Drugi format možemo mapirati ručno, što produžava povezivanje i povećava rizik od grešaka.
Mogu li u jednom feedu da pošaljem ponude za više tržišta?
Da. Svaki proizvod ima jednu ili više ponuda (offer), svaku sa svojim tržištem, valutom, cenom, dostupnošću i dostavom. U CSV-u je to jedan red po tržištu sa istim id.
Šta ako mi se cena menja više puta dnevno?
Dogovorite češće preuzimanje feeda. Cena prikazana kupcu je uvek ona iz poslednjeg uvoza, uz vreme provere.
Da li validator čuva moj feed?
Ne. Sadržaj se proverava u memoriji i odmah odbacuje. Validator ne preuzima adrese sa interneta — zalepite sadržaj ili izaberite fajl.
Koliko proizvoda može da ima feed?
Za proizvodni uvoz nema strogog ograničenja; validator proverava do 5.000 proizvoda i do 5 MB odjednom. Veći katalog podelite ili proverite uzorak.
Da li se plaća ulistavanje ili klik?
Ne. Ulistavanje i organski klikovi su besplatni. Provizija i oglasi su posebne, dobrovoljne opcije.
Pomoć pri povezivanju
Ako vam nešto nije jasno ili vaš sistem ne može da napravi feed u ovom obliku, pišite nam preko kontakt stranice (tema „Partneri i feed“) ili, posle prijave, iz partner portala. Pošaljite naziv prodavnice i, ako je moguće, izveštaj validatora.