Feed proizvoda
Prvo što trebate učiniti je stvoriti feed proizvoda koji sadrži sve informacije o proizvodima osim njihove dostupnosti.
Važna pravila
- Redoslijed elemenata nije obavezan.
- Feed sadrži obavezne elemente koji uvijek moraju biti navedeni s odgovarajućim vrijednostima.
Detaljniji pregled možete pronaći u nastavku. - Sustav će sve elemente bez vrijednosti procijeniti kao pogrešku . U slučaju obveznih elemenata, vrijednost se mora dodati, a u slučaju opcionalnih elemenata, cijeli element se mora ukloniti. Također nije moguće poslati prazne elemente koristeći samo zatvarajuću oznaku.
- Proizvodi koji nisu na zalihi i dalje se moraju održavati u feedu proizvoda. Njihov prikaz na web stranici kontrolira se pomoću feeda dostupnosti . Za detaljnije informacije o deaktivaciji proizvoda pogledajte ovdje .
- Svaka kategorija identificira se jedinstvenim ID-om. Kategorički uvjeti mogu uključivati i obavezne elemente koji se moraju umetnuti u feed s preciznim vrijednostima.
Izvoz stabla kategorija zajedno s kategoričkim pojmovima možete preuzeti ovdje ili kategoriju možete pretražiti na portalu MALL Partner u odjeljku Kategorije .
Detaljniji opis kategorija, parametara sortiranja i njihovih vrijednosti možete pronaći u članku ovdje .
Sustav ne provjerava ispravnost uvjeta sortiranja. Proizvod s netočnim ili nedostajućim kategoričkim uvjetima neće se prikazati na web stranici. Ispravnost prikaza možete provjeriti u Sandbox računu . - Potrebno je obratiti posebnu pozornost na mogućnost stvaranja grupa varijantnih proizvoda, na primjer, majica u 10 varijanti boja i 5 veličina potrebna je kao jedna grupa proizvoda/varijanta proizvoda . Postoje 3 ključna elementa za stvaranje varijantnog proizvoda: ITEMGROUP_ID, ITEMGROUP_TITLE i VARIABLE_PARAMS . Svi ovi elementi su obavezni za stvaranje varijantnih proizvoda. Detaljniji opis ovih elemenata možete pronaći u nastavku.
- Sustav uvijek provjerava proizvode jedan po jedan element dok ne pronađe grešku u podacima zadanog proizvoda. Ako se to dogodi, proizvod aktivira unos u zapisnik pogrešaka i sustav prelazi na provjeru sljedećeg proizvoda. Dakle, ako imate više od jedne pogreške u zadanom proizvodu, ona se ne može otkriti pri prvom pregledavanju.
Primjere feedova proizvoda u .xml formatu možete preuzeti ovdje.
- Nevarijantni proizvod sa svim elementima
- Nevarijantni proizvod sa samo obaveznim elementima
- Proizvod bez varijante s energetskom oznakom i informativnim listom
- Varijantni proizvod sa svim elementima
- Primjer XML FEED-a za trgovački centar sa svim primjerima
Opis elemenata feeda proizvoda
Ako imate dodatnih pitanja, možete nas kontaktirati putem Centra za pomoć .
| STAVKE obvezni element | Korijenski element XML datoteke. Pojavljuje se samo jednom u feedu. | |
| ARTIKAL obvezni element | Sadrži informacije o određenom proizvodu ili varijanti. | |
| ID obvezni element | ID proizvoda ili varijante. Ovdje unosite svoj kod proizvoda koji se zatim dodjeljuje narudžbama, na primjer. Svaki ID mora biti jedinstven . Ne može biti isti kao ITEMGROUP_ID. Kombinacije od maksimalno 50 znakova, dopušteni znakovi su: _ – 0-9 od AZ (podvlake, crtice, brojevi od nula do devet, mala i velika slova bez dijakritičkih znakova). | |
| POZORNICA obvezni element | Određuje je li proizvod vidljiv online. Uzima vrijednosti uživo/nacrt . U fazi implementacije (TESTIRANJE) uvijek je potrebno poslati nacrt vrijednosti, sustav bi aktivnu vrijednost procijenio kao grešku. Aktivna vrijednost se u ovoj fazi ne može postaviti. Proizvodi se prebacuju na aktivno tržište tek nakon uspješnog pregleda. izgled proizvoda i izvršavanje svih postavki . Nakon provjere, stručnjak za uvođenje prebacit će vaš račun u završnu fazu – PRODUKCIJU. Zatim će vas obavijestiti da je moguće prebaciti proizvode na aktivno korištenje . Proizvodi će tada biti vidljivi na web stranici. Aktivna vrijednost ne može se vratiti na nacrt. Za deaktivaciju proizvoda upotrijebite jednu od ovdje opisanih metoda . | |
| ID_GRUPE_ITEMA obavezni element za varijante | Ako se radi o varijanti, ovaj element označava ID grupe varijanti. ITEMGROUP_ID mora biti jedinstven i ne smije biti isti kao ID. Kombinacije od maksimalno 50 znakova, dopušteni znakovi su: _ – 0-9 od AZ (podvlake, crtice, brojevi od nula do devet, mala i velika slova bez dijakritičkih znakova). OBAVEZAN ELEMENT SAMO ZA VARIJANTNE PROIZVODE | |
| NASLOV_GRUPE_ITEMA obavezni element za varijante | Ako se radi o varijanti, polje označava naziv matičnog proizvoda. Vrijednost treba sadržavati opći naziv grupe varijanti bez specifičnosti pojedinačnih varijanti (na primjer, bez boje, veličine, ...). OBAVEZAN ELEMENT SAMO ZA VARIJANTNE PROIZVODE | |
| ID_KATEGORIJE obvezni element | Identifikator kategorije Uvijek mora sadržavati kod kategorije prema našem stablu kategorija za zemlju u kojoj se proizvodi implementiraju. Stabla za pojedine zemlje mogu se razlikovati. Kategorički uvjeti mogu uključivati i obavezne elemente; ID kategorije možda neće biti dovoljan za ispravan prikaz proizvoda. Uvijek provjerite kategoričke uvjete za svaku kategoriju. | |
| BRAND_ID obvezni element | Identifikator robne marke Uvijek mora sadržavati šifru marke ili BRAND ID. Šifra marke nije ista kao i njezino pravo ime. ID svog brenda možete pronaći na portalu MALL Partner u odjeljku Brendovi . Ako vaš brend još ne postoji u našem sustavu, kreirajte zahtjev za uspostavu prema uputama ovdje . | |
| TITULA obvezni element | Naziv/varijanta proizvoda Ne smije sadržavati naziv robne marke, jer se robna marka automatski dodaje na prvu poziciju elementa BRAND_ID na web stranici. Maksimalna duljina je 200 znakova. Mora sadržavati ključne riječi i, ako je varijanta, njezinu specifikaciju (na primjer, boju). Posebni znakovi nisu dopušteni. | |
| KRATKI OPIS obvezni element | Kratak opis proizvoda Ne smije sadržavati formatne ili HTML znakove, samo cijele rečenice. Maksimalna duljina je 300 znakova. Kratki opis se pojavljuje u popisu proizvoda na web stranici, pa bi trebao ukratko predstaviti proizvod. | |
| DUGI OPIS obvezni element | Dugi opis proizvoda Može sadržavati osnovne HTML oznake, a maksimalna duljina je 13 000 znakova. Mora sadržavati detaljniji opis proizvoda. Ovo su osnovne HTML oznake koje se mogu koristiti u dugom opisu: <a>, <b>, <br>, <div>, <dl>, <dt>, <em>, <hr>, <i>, <img>, <li>, <ol>, <p>, <strong>, <sub>, <sup>, <table>, <tbody>, <td>, <tfoot>, <th>, <thead>, <tr>, <u>, <ul>Nema potrebe koristiti prilagođene stilove u potezima, bez njih se tekst najbolje prilagođava našim stranicama. Ako u opisu imate tablice, ipak ih je potrebno dodati. <table class="”tbl”">kako bi tablica bila responzivna. | |
| PRIORITETI obvezni element | Upišite vrijednost 1 u okvir . Sustav automatski rangira proizvode pomoću algoritma koji radi na principu broja klikova, prometa i prodaje određenog proizvoda. Ovo je zastarjeli element koji još treba popuniti, ali se uopće ne uzima u obzir. Trenutno radimo na njegovom uklanjanju. | |
| VELIČINA_PAKETA obvezni element | Uzima vrijednosti smallbox/bigbox i označava veličinu paketa. Ovaj element povezuje proizvod s prijevozom, stoga je važno imati također je uspostavljen odgovarajući prijevoz . Smallbox mora ispunjavati 3 uvjeta – zbroj sve tri stranice paketa do 175 cm – najdulja stranica paketa maksimalno 100 cm – težina paketa do 20 kg Bigbox je svaki paket koji ne ispunjava gore navedene uvjete. | |
| BARKOD obvezni element | EAN kod proizvoda je obavezan za nas . Sustav prihvaća 13 numeričkih znakova. Ako vaš EAN ima 14 numeričkih znakova, unesite ga kao 13 znamenki bez vodeće nule. Ako imate kraći 8-znamenkasti EAN, dodajte onoliko nula na početak koliko nedostaje unutar 13 znakova. | |
| PRICE obvezni element | Cijena proizvoda s PDV-om koja odgovara navedenoj zemlji . Cijena ne smije uključivati proviziju. | |
| PDV obvezni element | PDV kao cijeli broj (npr. 21). PDV mora odgovarati poreznim stopama koje se primjenjuju u zemlji u kojoj se proizvodi provode . | |
| Preporučena maloprodajna cijena obvezni element | Preporučena maloprodajna cijena U zemljama izvan Češke Republike koristite točku "." kao razdjelnik iznosa. | |
| PARAM obvezni element | Parametri proizvoda Ovdje se unose samo parametri i vrijednosti koji su definirani u našem sustavu za danu kategoriju . Detaljne informacije o parametrima za pojedine kategorije možete pronaći u odjeljku Kategorije na portalu MALL Partner. | |
| PARAM obvezni element | NAME | Identifikator parametra Ne smije se koristiti naziv parametra, već njegov ID, koji je na engleskom jeziku ( npr. COLOR) . |
| PARAM obvezni element | VALUE | Vrijednost parametra mora uvijek biti na lokalnom jeziku i u precizno definiranim riječima ( npr. „ crveno “). |
| PARAMETRI_VARIJABLE obavezni element za varijante | Označava parametre na temelju kojih sustav treba stvoriti varijante. Mogu ih biti najviše 2 (na primjer, veličina "SIZE" i boja "COLOR"). OBAVEZAN ELEMENT SAMO ZA VARIJANTNE PROIZVODE | |
| PARAMETRI_VARIJABLE obavezni element za varijante | PARAM | Identifikator varijabilnog parametra (npr. BOJA). Ovdje se ne unosi naziv parametra, već njegov ID. OBAVEZAN ELEMENT SAMO ZA VARIJANTNE PROIZVODE |
| MEDIJI obvezni element | Slike/varijante proizvoda. Maksimalan broj je 20, a slike moraju biti na bijeloj pozadini/bez pozadine, bez logotipa, vodenih žigova ili naljepnica. Za više informacija o zahtjevima za izgled proizvoda, pogledajte ovdje . Nije moguće umetnuti dupliciranu sliku (s URL-om ili sadržajem). | |
| MEDIJI obvezni element | URL | URL slike Mora imati najviše 200 znakova, bez dijakritičkih znakova i razmaka. Maksimalna veličina slike je 2 MB, a rezolucija 2000px x 2000px. Minimalna veličina je 100 KB. Prilikom promjene slike, potrebno je urediti i URL adresu. |
| MEDIJI obvezni element | MAIN | Vrijednost true/false označava je li ovo glavna slika. Samo jedan MEDIA element može sadržavati vrijednost true. |
| MEDIJI obvezni element | Energetska oznaka je također umetnuta u medij. Imajte na umu da je potrebno koristiti sve elemente iz primjera , inače cijeli feed proizvoda neće funkcionirati . Obvezno samo za proizvode za koje su energetske oznake potrebne iz zakonskih razloga . | |
| MEDIJI obvezni element | URL | URL energetske oznake Mora imati najviše 200 znakova, bez dijakritičkih znakova i razmaka. Maksimalna veličina slike je 2 MB, a rezolucija 2000px x 2000px. Minimalna veličina je 100 KB. Prilikom promjene, potrebno je urediti i URL adresu. |
| MEDIJI obvezni element | MAIN | uvijek ispunite vrijednost FALSE |
| MEDIJI obvezni element | ENERGY_LABEL | uvijek ispunite vrijednost TRUE |
| MEDIJI obvezni element | INFORMATION_LIST | uvijek ispunite vrijednost FALSE |
| MEDIJI obvezni element | U medij se također umeće informativni list. Imajte na umu da je potrebno koristiti sve elemente iz primjera , inače cijeli feed proizvoda neće funkcionirati . Obvezno samo za proizvode za koje su informativni listovi potrebni iz zakonskih razloga . | |
| MEDIJI obvezni element | URL | URL informativnog lista Mora imati maksimalno 200 znakova, bez dijakritičkih znakova i razmaka. Maksimalna veličina slike je 2 MB, a rezolucija 2000px x 2000px. Minimalna veličina je 100 KB. Prilikom promjene potrebno je urediti i URL adresu. |
| MEDIJI obvezni element | MAIN | uvijek ispunite vrijednost FALSE |
| MEDIJI obvezni element | ENERGY_LABEL | uvijek ispunite vrijednost FALSE |
| MEDIJI obvezni element | INFORMATION_LIST | uvijek ispunite vrijednost TRUE |
| PROMOCIJA opcionalni element | Označava promotivnu cijenu proizvoda. Za detaljniji opis promotivne cijene pogledajte ovdje. | |
| PROMOCIJA opcionalni element | PRICE | Promotivna cijena s uključenim PDV-om. |
| PROMOCIJA opcionalni element | FROM | Cijena vrijedi od (u formatu 2022-03-20T13:00:00) |
| PROMOCIJA opcionalni element | TO | Vrijednost cijene do (u formatu 2022-03-21T13:00:00) |
| DIMENZIJE obvezni element | Dimenzije proizvoda za dostavu Prilikom uključivanja DIMENZIJA u feed, potrebno je uvijek uključiti sve elemente dimenzija kako bi se proizvodi ispravno učitali. Na primjer, ako trebate dodati samo dimenziju težine (za određivanje cijene dostave na temelju težine ), unesite vrijednost 0 za ostale dimenzije. | |
| DIMENZIJE obvezni element | WEIGHT | Težina u kg |
| DIMENZIJE obvezni element | WIDTH | Širina u cm |
| DIMENZIJE obvezni element | HEIGHT | Visina u cm |
| DIMENZIJE obvezni element | LENGTH | Duljina u cm |
| OZNAČITI opcionalni element | Ovdje možete pronaći oznake koje se mogu koristiti. Broj naljepnica na proizvodu nije ograničen, ali ne smiju postojati dvije iste naljepnice. | |
| OZNAČITI opcionalni element | NAME | Identifikator oznake Mogu se koristiti osnovne oznake FDEL (besplatna dostava), NEW (novo) i SALE (rasprodaja). Sve ostale oznake mogu se koristiti samo nakon prethodne konzultacije s vašim trgovcem. |
| OZNAČITI opcionalni element | FROM | Datum valjanosti oznake od (2022-03-20T13:00:00) |
| OZNAČITI opcionalni element | TO | Datum isteka naljepnice (2022-03-21T13:00:00) |
| KAŠNJENJE DOSTAVE obvezni element | Označava broj punih radnih dana za isporuku proizvoda. Vrijednost mora biti cijeli broj. Ove se informacije mogu postaviti i za cijeli portfelj u odjeljku Dostava na portalu MALL Partner. Postavka kašnjenja isporuke za proizvod ima prednost pred postavkom dostave. Vrijednost 0 znači da se podaci preuzimaju iz postavki dostave. Vrijednosti iz kašnjenja isporuke za dostavu i za proizvod ili varijantu ne zbrajaju se. | |
| TARIC_KOD obvezni element | Oznaka kombinirane nomenklature (KN) koja odgovara vašem proizvodu. Ove oznake ključne su za carinske deklaracije pri uvozu ili izvozu robe unutar EU-a i u/iz EU-a. Ako niste sigurni u točnu oznaku, preporučujemo korištenje službene baze podataka KN-a EU-a ili konzultaciju s carinskim stručnjakom. Sustav prihvaća 8 numeričkih znakova CN koda. |