Upute za povezivanje MALL XML feeda

MALL XML Feed,

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.

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 proizvodai 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
NAMEIdentifikator parametra
Ne smije se koristiti naziv parametra, već njegov ID, koji je na engleskom jeziku ( npr. COLOR) .
PARAM
obvezni element
VALUEVrijednost 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
PARAMIdentifikator 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
URLURL 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
MAINVrijednost 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
URLURL 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
MAINuvijek ispunite vrijednost FALSE
MEDIJI
obvezni element
ENERGY_LABELuvijek ispunite vrijednost TRUE
MEDIJI
obvezni element
INFORMATION_LISTuvijek 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
URLURL 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
MAINuvijek ispunite vrijednost FALSE
MEDIJI
obvezni element
ENERGY_LABELuvijek ispunite vrijednost FALSE
MEDIJI
obvezni element
INFORMATION_LISTuvijek ispunite vrijednost TRUE
PROMOCIJA
opcionalni element
 Označava promotivnu cijenu proizvoda. Za detaljniji opis promotivne cijene pogledajte ovdje.
PROMOCIJA
opcionalni element
PRICEPromotivna cijena s uključenim PDV-om.
PROMOCIJA
opcionalni element
FROMCijena vrijedi od (u formatu 2022-03-20T13:00:00)
PROMOCIJA
opcionalni element
TOVrijednost 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
WEIGHTTežina u kg
DIMENZIJE
obvezni element
WIDTHŠirina u cm
DIMENZIJE
obvezni element
HEIGHTVisina u cm
DIMENZIJE
obvezni element
LENGTHDuljina 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
NAMEIdentifikator 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
FROMDatum valjanosti oznake od (2022-03-20T13:00:00)
OZNAČITI
opcionalni element
TODatum 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.

Koliko je ova objava bila korisna?

Kliknite na zvjezdicu kako biste ocijenili objavu!

Prosječna ocjena: 1.5 / 5. Broj glasova: 133

Nitko još nije glasao. Budite prvi koji će ocijeniti ovu objavu.

hrHrvatski

Otkrijte više od MALL Partner - Nápověda Marketplace

Pretplatite se sada kako biste nastavili čitati i dobili pristup cijeloj arhivi.

Nastavite čitati