Članak pruža detaljne informacije o strukturi XML feeda za proizvode i dostupnost na MALL-u, uključujući pravila kojih se treba pridržavati prilikom izrade oba feeda.
Važna opća pravila:
- Za ovu vezu rade samo MALL XML feedovi prema donjoj strukturi.
Druge vrste feedova ne rade, sustav ih neće učitati. - Struktura MALL XML feedova je ista za sve zemlje, samo će se podaci poput stabala kategorija, parametara, PDV-a za zemlju mijenjati prema jezičnoj verziji zemlje
- Heureka feedovi ne rade za ovu vezu. MALL XML feed i Heureka feed su potpuno različite vrste feedova i smatramo ih dvjema različitim vrstama veza. Također nije moguće kombinirati vrste feedova. Provjerite jeste li postavili ispravnu vrstu veze na MALL partnerskom portalu . Ako ste postavili pogrešnu vrstu veze, pišite svom stručnjaku za uvođenje u sustav.
- Nije moguće umetnuti zalihe u feed proizvoda, potrebno je kreirati zaseban feed dostupnosti.
- Feedovi moraju biti generirani u URL-ove dostupne online u XML formatu i samo u UTF-8 kodiranju. Ne toleriramo FTP ili FTPS.
- Testiranje feedova se vrši direktno na portalu MALL Partner. Nakon kreiranja, potrebno je umetnuti URL poveznice u portal u odjeljku Feedovi i započeti obradu. Rezultat obrade može se pronaći u kartici Statistika , gdje se nalaze i poruke o pogreškama koje je potrebno ispraviti. Upute za umetanje feedova u portal i gdje pronaći poruke o pogreškama možete pronaći u članku ovdje .
Također preporučujemo da uvijek uključujete redovitu reprodukciju u vremenskim intervalima.
Na sljedećim stranicama pronaći ćete detaljan opis dvaju osnovnih oblika XML feeda.
stranica 2 : Feed proizvoda
stranica 3 : Feed dostupnosti
Ako imate dodatnih pitanja, možete nas kontaktirati putem Centra za pomoć .
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. |
Feed dostupnosti
Postavke feeda dostupnosti proizvoda iste su kao i za feed proizvoda, ali je struktura XML datoteke drugačija.
Važna pravila
- Polje URL-a za feed dostupnosti ne smije sadržavati istu vezu kao feed proizvoda.
- Feed dostupnosti je uvijek zaseban i ima svoju obveznu strukturu.
- Svi elementi u feedu su obavezni.
- Redoslijed elemenata je opcionalan.
- Ako u svom feedu proizvoda imate varijante proizvoda , uvijek biste trebali slati dostupnost na ID varijante, nikada na ITEMGROUP_ID .
- Brisanje proizvoda iz feeda dostupnosti nije valjan način deaktiviranja proizvoda.
Detaljnije informacije o deaktivaciji proizvoda možete pronaći ovdje . - Proizvod koji postoji u feedu proizvoda, ali nema ekvivalent u feedu dostupnosti, ostaje u sustavu s najnovije ažuriranim informacijama.
- Indikator dostupnosti za varijantni i nevarijantni proizvod je identičan.
- Maksimalni broj komada na zalihi je 9.999.
- Preporučujemo da uvijek navedete stvarno stanje zaliha . Za robu proizvedenu po narudžbi preporučujemo da kao raspoloživost navedete maksimalan broj komada koje možete obraditi u jednoj narudžbi.
- Broj dostupnosti može se navesti samo u cijelim brojevima , sustav će sve ostale podatke procijeniti kao pogrešku i dostupnost se neće izračunati.
PAŽNJA:
Ako ste u fazi PRIJAVE i vaš račun još nije aktiviran, polje AKTIVNO uvijek mora sadržavati vrijednost "true".
Primjer feeda za pristupačnost u .xml formatu možete preuzeti ovdje.
Opis elemenata feeda dostupnosti
| DOSTUPNOST | Korijenski XML element (pojavljuje se samo jednom u feedu). |
| DOSTUPNOST | Element koji označava dostupnost za svaki od proizvoda i varijanti. |
| ID | ID produktu/varianty. Musí být totožné s ID které uvádíte v produktovém feedu. |
| NA ZALIHI | Broj komada na zalihi, ako je broj na zalihi 0, molimo vas da ostavite proizvod u feedu, prikazat će se kao nedostupan. Uvijek mora biti naveden u cijelim brojevima. |
| AKTIVAN | Poprima vrijednosti true/false i koristi se za deaktivaciju proizvoda koji je na zalihi. Detaljnije informacije o deaktivaciji proizvoda možete pronaći ovdje . Uvjet za prikaz proizvoda/varijante na web stranici je također postavljanje ACTIVE elementa na true. |
Ako imate dodatnih pitanja, možete nas kontaktirati putem Centra za pomoć .