Alustamine B2BLIX Feed’iga

See juhend viib teid läbi B2BLIX Feed’i esimese täieliku seadistuse: ühe tarnija ühendamine, selle toodete importimine, XML-ekspordi loomine, faili genereerimine ja tulemuse kontrollimine.

Turvalisema esmase seadistuse jaoks alustage võimaluse korral ühe tarnija ja piiratud tooterühmaga. Kontrollige imporditud andmeid ja genereeritud XML-i enne ekspordi ühendamist toimiva poe, turuplatsi, hinnavõrdlusplatvormi või muu sihtkohaga.

Oluline: Tarnija sünkroonimine, kataloogi töötlemine, ekspordi genereerimine ja välise platvormi import on eraldi toimingud. Toote ilmumine B2BLIX-is ei tähenda automaatselt, et see on juba eksporditud või mõne teise süsteemi poolt avaldatud.

Enne alustamist

Aktiveerige B2BLIX Feed oma B2BLIX-i kontol ja koguge kokku teave, mida vajate oma esimese tarnijavoo kasutamiseks.

Tavaliselt peaks teil olema:

• Töötav XML- või JSON-allika URL.
• Luba tarnijaandmete allalaadimiseks ja töötlemiseks.
• Autentimisandmed või päringu päised, kui neid nõutakse.
• Tarnija hindades kasutatav valuuta.
• Kinnitus selle kohta, kas valitud hinnad sisaldavad käibemaksu.
• Kohaldatav käibemaksumäär.
• Tootesisu põhikeel.
• Allikas kasutatav kaaluühik.
• Teave selle kohta, kui sageli tarnija faili uuendab.

Avage allika URL käsitsi enne selle lisamist. Veenduge, et see tagastab oodatud XML- või JSON-andmed, mitte vealehe, sisselogimislehe või muu asjakohatu dokumendi.

Hoidke tarnija juurdepääsuandmed privaatsena: Allika URL-id võivad sisaldada klienditunnuseid või juurdepääsutunnuseid. Ärge avaldage tarnija URL-e, paroole, päringu päiseid ega genereeritud privaatseid ekspordilinke.

1. Lisage esimene tarnija

Avage Tarnijad ja klõpsake Lisa uus tarnija.

Samuti saate tarnijavormi avada otse siit: Lisa uus tarnija.

Sisestage tarnija pealkiri

Kasutage pealkirja, mis jääb selgeks ka siis, kui teil on hiljem mitu tarnijat. Nimi nagu Tarnija nimi — põhikataloog on kasulikum kui „Voog 1” või „Uus tarnija”.

Lisage põhiallikas

Põhiallikas on tarnija põhikataloog. Tavaliselt sisaldab see täielikke tootekirjeid, sealhulgas näiteks:

• EAN ja tarnija SKU.
• Pealkiri ja kirjeldus.
• Hind ja laovaru.
• Pildid.
• Kategooria ja tootja.
• Kaal, mõõtmed, värv ja muud atribuudid.

Sisestage täielik allika URL. Lisage lihtautentimise kasutajanimi, parool või sünkroonimise päised ainult siis, kui tarnija neid nõuab.

Otsustage, kas teisene allikas on vajalik

Teisene allikas on valikuline. Kasutage seda siis, kui tarnija pakub sageli muutuvate andmete, näiteks hinna ja laovaru jaoks eraldi, tavaliselt väiksemat faili.

• Üks allikas: Sisestage täielik voog põhiallikana ja jätke teisene allikas tühjaks.
• Kaks allikat: Kasutage täielikku kataloogi põhiallikana ning hinna- ja laovaru uuendusfaili teisese allikana.

Ärge lisage sama URL-i mõlema allikana. Teisene allikas on kasulik ainult siis, kui see pakub eraldi andmekogumit, mis tuleb põhitootekirjetega ühendada.

Pärast allikateabe sisestamist klõpsake Jätka. B2BLIX küsib allikast andmed ja kontrollib neid, et selle tootestruktuuri saaks kaardistada. Esmane kontroll võib võtta ligikaudu üks kuni kaks minutit.

Tarnija väljade täielikud juhised leiate siit: Tarnijad: tarnijavoo lisamine ja seadistamine. Abi saamiseks kahe allika vajalikkuse otsustamisel lugege Kuidas kavandada tarnija põhiallikat ja teisest allikat.

2. Seadistage, kuidas B2BLIX peaks tarnijaandmeid tõlgendama

Pärast allika kontrollimist täitke tarnija üldised, finants-, sisu- ja sünkroonimisseaded.

Hoidke tarnija seadistamise ajal keelatuna

Jätke Olek väärtusele Keelatud, kuni kõik vajalikud vastendused on lõpetatud ja üle vaadatud. Nii ei kasutata lõpetamata seadeid ajastatud kataloogi sünkroonimisel.

Täitke finantsseaded

• Riik: Valige tarnija riik.
• Valuuta: Valige kaardistatud allikahinnas tegelikult kasutatav valuuta.
• KM sisaldub: Määrake, kas valitud allikahind sisaldab juba käibemaksu.
• KM määr: Sisestage väärtus liidese näidatud vormingus. Näiteks võib liides kasutada 20% käibemaksumäära jaoks väärtust 1.20.

Kontrollige allikahinda hoolikalt: Tarnijafail võib sisaldada neto-, bruto-, soovituslikke, algseid või soodushindu. Valuuta- ja käibemaksuseaded peavad kirjeldama välja, mille kaardistate tegelikult väljale Hind.

Täitke sisuseaded

• Sisu vaikekeel: Valige pealkirjades ja kirjeldustes kasutatav keel.
• Kaaluühik: Valige allikaandmete järgi grammid või kilogrammid.
• Luba kategoriseerimata: Otsustage, kas lahendatud kategooriata tooted võivad ajutiselt jääda kategoriseerimata väärtuse alla.
• Sunni null-laovaru: Määrake, kui kaua võib puuduvat toodet pidada nähtamatuks, enne kui selle laovaru muudetakse nulliks.
• Viimati nähtud maksimaalselt: Määrake, kui kaua võib puuduvaks jäänud toodet säilitada enne eemaldamist.

Värskuse väärtused peaksid olema tavalisest sünkroonimisintervallist pikemad. Praktilise lähtekohana lubage vähemalt ligikaudu kahe eeldatava sünkroonimistsükli pikkune aeg. Viimati nähtud maksimaalselt on tavaliselt pikem kui Sunni null-laovaru.

Valige sünkroonimissagedused

Valige iga seadistatud allika jaoks nullist erinev sünkroonimissagedus. Saadaolevad intervallid võivad olla iga 30 minuti järel, iga tunni järel ning iga 2, 3, 6, 12 või 24 tunni järel.

Lihtsa esimese testi jaoks võib tunnine intervall olla praktiline, kui tarnija lubab allalaadimist kord tunnis. Pidage siiski meeles:

• Ärge valige 30 minutit, kui tarnija ei uuenda faili nii sageli ega luba sellise sagedusega allalaadimist.
• Suur põhikataloog võib vajada pikemat intervalli, näiteks iga 6, 12 või 24 tunni järel.
• Väiksemat teisest hinna- ja laovaruallikat saab tavaliselt sünkroonida põhikataloogist sagedamini.
• Sagedasem sünkroonimine ei loo uuemaid andmeid, kui tarnija uuendab oma allikat harvem.
• Tarnijate allalaadimised on kasutuspõhised toimingud, seega võib sagedus mõjutada konto kasutust.

3. Kaardistage tarnija põhiallikas

Pärast uue allika lisamist on hoiatused, näiteks Andmete vastendus puudub, ootuspärased. See tähendab, et B2BLIX pääseb allikale ligi, kuid ei tea veel, millised tarnija väljad tähistavad EAN-i, hinda, laovaru, pealkirja ja muid standardatribuute.

Klõpsake põhiallikal Loo vastendus.

Valige toote tee

Esimene vastendamise samm on valida korduv allikatee, mis tähistab üht täielikku toodet.

Valige tee, mis:

• Kordub ligikaudu üks kord toote kohta.
• Sisaldab toote EAN-i, hinda, laovaru, pealkirja ja muid välju.
• Ei tähista kogu faili ümbrist.
• Ei tähista ainult üht alamvälja, näiteks hinda, pilti või tootjat.

Näiteks kui catalog/products/product kordub tuhandeid kordi ja iga vastav element sisaldab üht täielikku toodet, on see tõenäoliselt õige tee.

Kaardistage nõutavad tooteväljad

Kasuliku esmase seadistuse jaoks kaardistage vähemalt:

• EAN
• SKU või tarnija toote-ID
• Pealkiri
• Hind
• Laovaru
• Kategooria

Kui need on saadaval, kaardistage ka kirjeldus, pildid, kategooria ID, tootja, kaal, mõõtmed, värv ja muud kasulikud atribuudid.

EAN on oluline: B2BLIX kasutab EAN-i standardse kataloogitöövoo peamise tunnusena. Puuduva, vigase või tagasilükatud EAN-iga tooteid ei töödelda tavapäraselt. Ärge kaardistage sisemist SKU-d või variatsioonirühma koodi EAN-iks, välja arvatud juhul, kui see on tegelikult toote vöötkood.

Enne salvestamist kontrollige päris toote eelvaadet. Sarnastel väljanimedel võib olla erinev tähendus, eriti kui allikas sisaldab mitut tunnust või hinnavälja.

Lisateavet vastendamise ja puuduvate toodete kohta leiate siit: Kuidas toimivad tarnija vastendamine, hinnaväljad, valuuta ja puuduvate toodete diagnoosimine.

4. Kaardistage ja ühendage teisene allikas, kui seda kasutatakse

Jätke see samm vahele, kui teie tarnija kasutab ainult üht allikat.

Kui teisene allikas on seadistatud, lõpetage selle vastendamine eraldi. Valige korduv toote tee ja kaardistage:

• Stabiilne tunnus, mida kasutatakse allikakirjete ühendamiseks.
• Hind.
• Laovaru.
• Muud väärtused, mida teisene allikas on mõeldud uuendama.

Seejärel avage vastendus Ühendus. Valige vastav tunnus põhiallikast ja teisest allikast.

Sobiv ühendusväli võib olla:

• EAN.
• Tarnija SKU.
• Stabiilne tarnija toote-ID.

Väärtused peavad mõlemas failis ühtima. Põhiallika EAN-i ja teisese allika SKU valimine ei toimi, kui need kaks välja ei sisalda tegelikult sama väärtust.

Vaadake kattuvusstatistika enne salvestamist üle. Väga väike vastete arv võib viidata järgmisele:

• Valiti vale ühendusväli.
• Ühes allikas on eesliited, tühikud või erinev vorming.
• Teisene allikas sisaldab ainult osa tarnija kataloogist.
• Valitud teed ei tähista täielikke tooteid.

Kahe allika kasutamisel peaks tarnija seadistus enne tarnija lubamist näitama salvestatud põhiallika vastendust, salvestatud teisese allika vastendust ja salvestatud ühenduse vastendust.

5. Lubage tarnija ja käivitage esimene ajastatud import

Pärast seadete ülevaatamist ja kõigi kuvatud vastendamisülesannete lõpetamist:

1. Muutke Olek väärtuseks Lubatud.
2. Veenduge, et igal seadistatud allikal oleks nullist erinev sünkroonimissagedus.
3. Klõpsake Uuenda tarnijat.

Oodake vähemalt ühe seadistatud sünkroonimisintervalli möödumist. Näiteks kui tarnijat sünkroonitakse kord tunnis, arvestage esimese ajastatud kataloogiuuenduse jaoks ligikaudu ühe tunniga.

Tarnija sünkroonimine ja ekspordi genereerimine on sõltumatud. Selles etapis ootate tarnijaandmete jõudmist B2BLIX-i salvestatud kataloogi; eksporti pole veel loodud.

Abi töötlemise viivituste tuvastamiseks leiate siit: Kuidas jälgida töötlemist, tõlkeid ja voo sünkroonimist.

6. Kinnitage toodete importimine

Avage Kõik tooted.

Filtreerige uue tarnija järgi või otsige mitut teadaolevat EAN-i. Kontrollige järgmist:

• Toote pealkiri.
• EAN ja SKU.
• Tarnija hind.
• Laokogus.
• Kategooria.
• Viimase nähtavuse või sünkroonimise teave.

Avage toote üksikasjad, et kontrollida kogu kaardistatud kirjet.

Ärge looge eksporti veel, kui tooted puuduvad, EAN-i väärtused on valed, hinnas kasutatakse valet välja või valuutat, laovaru puudub või imporditud väärtused ei vasta tarnija allikale.

Kui EAN on tarnijafailis olemas, kuid seda ei leita vaatest Kõik tooted, kontrollige toote teed, EAN-i vastendust, allika ühendust, kategooriate käsitlemist, tarnija olekut ja sünkroonimissagedust.

Lehe juhised leiate siit: Kõigi toodete liides. EAN-i ja kategooriate nõuete kohta lugege Kuidas toimivad nõutavad tooteväljad ja kategooriate vastendamine.

7. Looge esimene XML-eksport

Pärast seda, kui olete kinnitanud, et tarnija tooted on õigesti salvestatud, avage Ekspordid ja klõpsake Lisa uus eksport.

Samuti saate otse avada Lisa uus eksport.

Täitke ekspordi üldseaded

1. Sisestage selge Pealkiri, eelistatavalt sihtkoha põhjal.
2. Valige vorminguks XML.
3. Valige nullist erinev Sagedus.
4. Valige nõutav Sisuvaliku meetod.
5. Valige seadistatud tarnija.
6. Sisestage tarnija Vaikimisi marginaal.
7. Klõpsake Loo.

Valige ekspordi sagedus

Ekspordi sagedus määrab, kui sageli genereerib B2BLIX uusima kataloogiandmestiku põhjal uue XML-faili. Saadaolevad intervallid võivad olla iga 30 minuti järel, iga tunni järel, iga 2 tunni järel või iga 3 tunni järel.

Tunnine eksport on paljude testseadistuste jaoks praktiline lähtekoht. Pidage meeles:

• Tarnija ja ekspordi sagedused on sõltumatud.
• Eksport saab kasutada ainult tarnijaandmeid, mis on juba kataloogi jõudnud.
• Ekspordi genereerimine tarnija uuendustest sagedamini ei muuda tarnijateavet värskemaks.
• Ekspordi genereerimine on kasutuspõhine toiming.

Valige sisuvalik

Kui eksport kasutab ainult üht tarnijat, ei muuda sisuvalik tavaliselt esimest tulemust. Kui mitu tarnijat pakuvad hiljem sama EAN-iga toodet:

• Min hind kasutab madalaimat sobivat hinda pakkuva tarnija sisu.
• Maksimaalne sisu pikkus eelistab rikkalikuma või pikema tootesisuga tarnijat.

Määrake vaikimisi marginaal

Vaikimisi marginaal on kordaja, mida rakendatakse igale valitud tarnijale eraldi.

• 1.0 jätab hinna muutmata.
• 1.1 lisab 10%.
• 1.2 lisab 20%.

Marginaali hoiatus: Sisestage kordaja, mitte täisarvulist protsenti. Väärtus 20 ei tähenda 20% marginaali.

Ekspordi täieliku liidese kohta lugege Ekspordid: XML-ekspordi projektsioonide loomine ja seadistamine.

8. Lisage lihtne ekspordifilter

Leidke uus eksport ekspordiloendist ja avage Muuda filtrit.

Ekspordifilter määrab, millised kataloogitooted võivad jätkata ekspordimalli ja genereeritud XML-i.

Lihtsa esimese ekspordi jaoks looge järgmine tingimus:

See loob ekspordis selge tunnusenõude. B2BLIX nõuab standardse kataloogitöövoo jaoks juba kasutatavat EAN-i, kuid filter muudab sihtkoha nõude selgeks.

Müügihinna ekspordi jaoks võite lisada ka järgmise tingimuse:

Ühendage EAN-i ja hinna tingimused tehtega JA, nii et mõlemad peavad olema tõesed.

Vältige esimese testi ajal keerukaid kategooria-, tarnija-, tootja-, laovaru- või välistamisrühmi, välja arvatud juhul, kui sihtkoht neid nõuab. Lisage need järk-järgult pärast seda, kui olete kontrollinud teadaolevaid tooteid, mis peaksid filtri läbima, ja teadaolevaid tooteid, mis tuleks välistada.

Üksikasjaliku JA/VÕI-loogika ja välistamiste kohta lugege Kuidas toimivad ekspordifiltrid ja toodete välistamised.

9. Otsustage, kas teisendused on vajalikud

Esimese seadistuse ajal võite teisendused vahele jätta, kui tarnija kaardistatud väärtused ja ekspordi vaikimisi marginaal annavad juba vajaliku tulemuse.

Kasutage Andmete teisendusreeglid hiljem, kui teil on vaja:

• Luua sihtkohapõhine hind.
• Rakendada täpsemaid kategooria- või tootemarginaale.
• Ümardada hindu.
• Muuta laovaru väärtusi.
• Eemaldada kirjeldustest HTML.
• Tõlkida pealkirju või kirjeldusi.
• Luua XML-malli jaoks uusi atribuute.

Reegli loomine ei aktiveeri seda automaatselt. Reegel tuleb lubada ka asjakohases ekspordis ja määrata sobiv prioriteet.

Esimese ekspordi jaoks jätke ka Soodustused tühjaks, välja arvatud juhul, kui kampaaniasoodustus on konkreetselt vajalik.

Reeglite juhised leiate siit: Andmete teisendusreeglid.

10. Koostage XML-ekspordi mall

Minge tagasi ekspordiloendisse ja avage Muuda malli.

Mall määrab, kuidas valitud tooteandmed genereeritud XML-i kirjutatakse. See määratleb:

• Korduva XML-i tootetee.
• Väljundväljade nimed.
• Dünaamiliste väärtustena kasutatavad B2BLIX-i atribuudid.
• Valikulised fikseeritud või varuväärtused.

Määrake tootetee

Kasutage sihtkoha nõutavat korduvat tooteteed. Näiteks võib lihtne struktuur kasutada järgmist:

products > product

Selles struktuuris genereeritakse üks product-element iga ekspordifiltri läbinud toote kohta.

Lisage väljundväljad

Lihtne testmall võib sisaldada järgmist:

Klõpsake iga lisavälja jaoks Lisa atribuut ja klõpsake malli lõpetamisel Uuenda.

Sihtkoha nõuded on esmatähtsad: Ülaltoodud näide on kasulik XML-i genereerimise kontrollimiseks, kuid see ei ole universaalne turuplatsi spetsifikatsioon. Enne URL-i teise süsteemiga ühendamist kasutage selle sihtkoha täpset teed, väljanimesid, nõutavaid atribuute, vorminguid ja lubatud väärtusi.

Kasutage vaikeväärtusi ettevaatlikult. Teksti varuväärtus võib mõnikord olla sobiv, kuid fikseeritud hinna- või laovaru väärtus võib peita puuduvad tarnijaandmed ja tekitada vale äriteabe.

Malli täieliku kavandamise kohta lugege Kuidas muuta sihtkoha XML-i spetsifikatsioon B2BLIX-i ekspordimalliks.

11. Genereerige esimene XML-fail

Minge tagasi ekspordiloendisse ja avage oma ekspordi juures Muuda.

Kontrollige järgmist:

• Valitud on õige tarnija.
• Vaikimisi marginaal on õige.
• Ekspordi sagedus on suurem kui null.
• Filter ja mall on salvestatud.

Ekspordi kohe genereerimiseks, mitte järgmise ajastatud ekspordiintervalli ootamiseks, klõpsake käsitsi sünkroonimise toimingul Käivita sünkroonimine.

Pärast genereerimist kuvatakse jaotises Muuda ekspordi avalik XML-i URL. Aadress jääb selle ekspordiprojektsiooniga seotuks.

Kontrollige järgmist:

• Fail avaneb edukalt.
• See sisaldab tooteid.
• Tootetee ja XML-i väljanimed on õiged.
• EAN-i, hinna, laovaru ja sisu väärtused on mõistlikud.
• Vaikimisi marginaal andis oodatud hinna.
• Kaasatud pole ootamatuid tarnijaid ega tooteid.

Ärge ühendage testimata eksporti toimiva sihtkohaga. Kehtiv XML-dokument võib siiski sisaldada valesid hindu, laovaru väärtusi, tootevalikuid või väljanimesid.

12. Kontrollige esinduslikke tooteid ekspordi kontrollijas

Avage Ekspordi kontrollija.

1. Sisestage teadaoleva toote täielik EAN.
2. Valige uus eksport.
3. Klõpsake Leia.
4. Arvestage aruande koostamiseks ligikaudu ühe kuni kahe minutiga.

Vaadake üle:

• Iga tarnija saadetud algandmed.
• Toote jaoks valitud tarnija.
• Algne hind ja laovaru.
• Vaikimisi marginaal ja muud arvutused.
• Ekspordifiltri tulemus.
• Kõik tootele mõjunud teisendused.
• Lõplikud atribuudid.
• Eksporditud XML-i näidis.
• Välistamise põhjus, kui toodet ei eksporditud.

Kontrollige mitut esinduslikku toodet, sealhulgas:

• Tavaline laos olev toode.
• Madala ja kõrge hinnaga toode.
• Piiratud sisuga toode.
• Iga valitud tarnija toode, kui tarnijaid lisatakse.
• Toode, mille puhul eeldate, et filter välistab selle.

Aruande üksikasjade kohta lugege Ekspordi kontrollija: tooteandmete ja eksporditulemuste ülevaatamine.

13. Ühendage kontrollitud XML-i URL sihtkohaga

Pärast genereeritud XML-i struktuuri ja tooteväärtuste kontrollimist kopeerige avalik URL ekspordi jaotisest Muuda ning lisage see sihtkohta vastavalt selle platvormi voo importimise juhistele.

Väline sihtkoht määrab:

• Millal see XML-i alla laadib.
• Kuidas see välju valideerib.
• Millised tooted see vastu võtab või tagasi lükkab.
• Millal vastuvõetud teave nähtavaks muutub.

See, et B2BLIX genereerib oodatud XML-i, ei kinnita iseenesest, et sihtkoht on selle alla laadinud, vastu võtnud või avaldanud.

Turvalise käivitamise töövoo kohta lugege Kuidas turuplatsi eksporti ette valmistada, testida ja ühendada.

Kiire tõrkeotsingu juhis

Lõpliku seadistuse kontrollnimekiri

• B2BLIX Feed on aktiivne.
• Tarnija allika URL avaneb ja tagastab oodatud XML- või JSON-andmed.
• Tarnija valuuta- ja käibemaksuseaded kirjeldavad kaardistatud hinda õigesti.
• Sisu keel ja kaaluühik on õiged.
• Põhitootetee tähistab täielikke üksiktooteid.
• EAN, hind, laovaru, pealkiri ja kategooria on õigesti kaardistatud.
• Teisene allikas ja ühenduse vastendus on kahe allika kasutamisel lõpetatud.
• Tarnija on lubatud ja igal seadistatud allikal on nullist erinev sagedus.
• Esimene tarnija sünkroonimine on lõpetatud.
• Esinduslikud tooted on vaates Kõik tooted nähtavad ja õiged.
• Eksport sisaldab ettenähtud tarnijat.
• Vaikimisi marginaal on sisestatud kordajana.
• Ekspordil on nullist erinev genereerimissagedus.
• Ekspordifilter sisaldab vähemalt ettenähtud EAN-i nõuet.
• Esimese testi ajal on mittevajalikud teisendused ja soodustused keelatud.
• XML-mall järgib sihtkoha nõutavat struktuuri.
• Käsitsi ekspordi sünkroonimine on lõpetatud.
• Avalik XML-i URL avaneb ja sisaldab oodatud tooteid.
• Esinduslikud EAN-id on ekspordi kontrollijas üle vaadatud.
• XML-i on enne toimiva sihtkohaga ühendamist testitud.

Pärast seda, kui esimene tarnija ja eksport töötavad õigesti, lisage järk-järgult rohkem tarnijaid, filtreid, teisendusreegleid, kategooriaid, keeli ja sihtkohapõhiseid eksporti. Genereerige vastav eksport uuesti ja kontrollige seda pärast iga olulist seadistusmuudatust.