Tagasi kõigi juhendite juurde

Sünkroonimise testija ja Google Sheetsi faili struktuur

Sünkroonimise testija kontrollib, kas Google Sheetsi tootefailil on õige struktuur, ja näitab, kuidas B2BLIX töötleks väikest hulka tooteid. See genereerib XML-testitulemuse ilma hindu otse turuplatsil avaldamata.

Milleks sünkroonimise testijat kasutatakse

Sünkroonimise testija on ettevalmistustööriist müüjatele, kes soovivad oma tootefaili enne regulaarse sünkroonimise seadistamist kontrollida.

Saate luua väikese Google Sheetsi dokumendi, mis sisaldab tegelikke või näidisena kasutatavaid tooteid, sisestada selle URL-i ja käivitada BuyBoxi arvutusprotsessi ühe korra. B2BLIX loeb sisestatud tooteandmeid, kasutab saadaolevat avastatud turuplatside teavet ja teie seadistatud BuyBoxi reegleid ning koostab arvutatud tulemustega XML-faili.

See leht on eriti kasulik, kui soovite:

  • kinnitada veergude õiged nimed ja faili struktuuri;
  • mõista, mida iga toetatud tooteväli tähendab;
  • testida üldisi ja turuplatsipõhiseid hindu;
  • kontrollida minimaal- ja maksimumhinnapiiranguid;
  • testida välistamisreegleid või ebatavalisi tooteolukordi;
  • vaadata XML-tulemust enne regulaarse sünkroonimise seadistamist.

Sünkroonimise testijat kasutatakse tavaliselt enne lõpliku tooteallika lisamist jaotises Sünkroonimise seaded. Kui regulaarne sünkroonimine on seadistatud ja töötab, tuleb testijat kasutada ainult erilise ettevaatusega.

Oluline: testi käivitamine ei saada hindu otse Pigu, 220.lv, Kaup24.ee või HobbyHall.fi platvormile. Test võib aga uuendada sama fikseeritud URL-i kaudu avaldatavat loodud XML-i. Ärge käivitage testi ajal, kui see XML-i URL on ühendatud toimiva turuplatsi või muu süsteemiga, sest ühendatud süsteem võib saada ajutised testandmed.

Sünkroonimise testija leht Google Sheetsi URL-i välja, Discount Mode'i lüliti, näidislehe nupu ja toetatud atribuutide tabeliga
Sünkroonimise testija liides näitab, kuhu sisestada Google Sheetsi URL, kuidas lubada Discount Mode, kust avada näidisdokument ja milliseid tooteatribuute toetatakse.

Mida sellel lehel teha saab

  • avada eeldatava struktuuriga Google Sheetsi näidisdokumendi;
  • sisestada oma Google Sheetsi tootefaili URL;
  • valida, kuidas algsed ja arvutatud hinnad XML-väljundis kuvatakse;
  • vaadata aktsepteeritavaid väljanimesid ja alternatiivseid veerunimesid;
  • käivitada ühekordse sünkroonimise testi;
  • genereerida töödeldud toodete ja arvutatud hindadega XML-faili;
  • vaadata loodud tulemust sünkroonimise aruandluse töövoos.

Test teostab tegeliku arvutusprotseduuri, kuid arvutatud või eksporditud hind ei ole automaatselt toimiv turuplatsi hind. Hind muutub toimivaks ainult juhul, kui väline integratsioon kasutab loodud väljundit ning turuplats selle vastu võtab ja rakendab.

Peamised väljad ja juhtelemendid

Väli või juhtelement Mida see tähendab Millal seda kasutada
Google Sheetsi URL Google Sheetsi dokumendi aadress, mis sisaldab testitavaid tooteid. Kleepige URL pärast lehe ettevalmistamist toetatud veerunimedega. Veenduge, et B2BLIX pääseb dokumendile sisestatud URL-i kaudu ligi.
Discount Mode Määrab, kuidas sisestatud ja arvutatud hind XML-väljundis esitatakse. Lülitage see sisse, kui soovite, et XML säilitaks sisestatud hinna alghinnana ja näitaks arvutatud hinda soodushinnana.
Ava näide: Google Sheets Avab eeldatava struktuuriga näidistabeli. Kasutage seda enne oma dokumendi loomist või veergude õigekirja ja järjekorra kontrollimisel.
Atribuutide tabel Loetleb peamise aktsepteeritava väljanime, toetatud alternatiivid ja lühikirjelduse. Kasutage seda Google Sheetsi dokumendi veergude nimetamisel.
Käivita test Loeb sisestatud lehte, töötleb selle tooteid, rakendab saadaolevaid BuyBoxi seadeid ja genereerib testitulemuse. Kasutage seda pärast lähte-URL-i, tooteidentifikaatorite, hindade, piirangute ja piirkondlike väärtuste kontrollimist.

Kuidas Google Sheetsi dokumenti ette valmistada

Kasutage iga toote jaoks ühte rida. Esimene rida peab sisaldama toetatud atribuutide nimesid.

Testija aktsepteerib lehel näidatud peamisi atribuudinimesid ja mõne välja puhul ka alternatiivseid nimesid. Kasutage õigekirja täpselt sellisel kujul, nagu see on näidatud. Ärge lisage tühikuid ega muutke alakriipse ja sidekriipse, välja arvatud juhul, kui täpselt selline alternatiiv on loetletud.

Leht ei märgi kõiki võimalikke veerge kohustuslikeks. Praktikas on EAN või GTIN peamine toote sobitamise väärtus. Lisage muud väljad, mida vajate testitava olukorra jaoks.

Tooteidentifikaator peab viitama tootele, mis on olemas müüja turuplatsi pakkumistes ja mille B2BLIX on avastanud. Tundmatu või vale EAN võib takistada toote sobitamist saadaoleva turuplatsiteabega.

Turuplatsi järelliited

Mitmed väljade rühmad toetavad nii üldist väärtust kui ka ühe konkreetse turuplatsi väärtust. Turuplats määratakse veerunime lõpus oleva järelliitega.

Järelliide Turuplats Näidisväli
_lv 220.lv Lätis price_lv
_lt Pigu.lt Leedus price_lt
_ee Kaup24.ee Eestis price_ee
_fi HobbyHall.fi Soomes price_fi

Kuidas üldised ja turuplatsipõhised väärtused toimivad

Ilma turuplatsi järelliiteta väli toimib üldise väärtusena kõigil toetatud turuplatsidel. Turuplatsipõhine väli kirjutab üldise väärtuse üle ainult enda turuplatsi puhul.

Oletame näiteks, et toote rida sisaldab järgmist:

Veerg Väärtus
price 100
price_lv 90

Tegelikult sisestatud hinnad on järgmised:

  • Läti: 90, sest price_lv kirjutab üldise väärtuse üle;
  • Leedu: 100 väljast price;
  • Eesti: 100 väljast price;
  • Soome: 100 väljast price.

Sama põhimõte kehtib järgmistele andmetele:

  • kättesaamise või kohaletoimetamise tunnid;
  • hinnad enne allahindlust;
  • hinnad pärast allahindlust;
  • lubatud miinimumhinnad;
  • lubatud maksimumhinnad.

Sama väärtust ei ole vaja korrata kõigis neljas turuplatsi veerus. Sisestage üldine väärtus ja lisage ainult sellest erinevad piirkondlikud erandid.

Toote tuvastamise väljad

Atribuut Aktsepteeritav alternatiiv Tähendus ja kasutus
ean gtin

Peamine tooteidentifikaator, mille abil sobitatakse sisestatud rida turuplatsi tootega.

EAN peab kuuluma müüja Pigu Groupi pakkumistes saadaolevale ja B2BLIX-ile teadaolevale tootele.
sku sku

Müüja SKU-identifikaator.

See võib olla täiendav viite- või valideerimisväärtus. See ei asenda EAN-i, kui toote sobitamiseks on vaja EAN-i.

Laoväli

Atribuut Aktsepteeritav alternatiiv Tähendus ja kasutus
stock stock

Saadaolev tootekogus.

Sisestage see täisarvuna, näiteks 0, 3 või 25. Kui valitud XML-i või API töövoog sisaldab laoteavet, kasutab B2BLIX väljundis sisestatud kogust.

Väärtus 0 näitab, et hetkel pole ühtegi ühikut saadaval. Kontrollige laoväärtusi hoolikalt, kui testite väljundit, mida võib lugeda mõni teine süsteem.

Kättesaamise ja kohaletoimetamise tunni väljad

Need väljad kirjeldavad toote kohaletoimetamise või kättesaamise aega toetatud turuplatsidel.

Atribuut Aktsepteeritav alternatiiv Kehtib
collectionhours collection_hours Üldine väärtus kõigil turuplatsidel, kui seda üle ei kirjutata.
collectionhours_lv collection_hours_lv Ainult Läti.
collectionhours_lt collection_hours_lt Ainult Leedu.
collectionhours_ee collection_hours_ee Ainult Eesti.
collectionhours_fi collection_hours_fi Ainult Soome.

Kasutage üldist välja, kui kohaletoimetamise aeg on kõigil turgudel sama. Lisage turuplatsi põhine väli, kui ühes riigis on erinev kohaletoimetamise aeg.

Allahindluse-eelse hinna väljad

Need väljad sisaldavad sisestatud tootehinda enne allahindluste rakendamist. Üldist väärtust kasutatakse kõigil turuplatsidel, kui piirkondlikku väärtust ei ole esitatud.

Atribuut Aktsepteeritavad alternatiivid Kehtib
price price_before_discount, price-before-discount Üldine hind kõigil turuplatsidel, kui seda üle ei kirjutata.
price_lv price_before_discount_lv, price-before-discount-lv Ainult Läti.
price_lt price_before_discount_lt, price-before-discount-lt Ainult Leedu.
price_ee price_before_discount_ee, price-before-discount-ee Ainult Eesti.
price_fi price_before_discount_fi, price-before-discount-fi Ainult Soome.

See sisestatud hind on sisendandmed. See ei pruugi olla lõplik soovitatud hind, sest B2BLIX võib testi ajal rakendada seadistatud hinnastrateegiat ja turvapiiranguid.

Allahindlusjärgse hinna väljad

Need väljad tähistavad tootele sisestatud allahindlusjärgset hinda. Samuti määravad need, kuidas hinnateavet Discount Mode'i kasutamisel tõlgendatakse.

Atribuut Aktsepteeritavad alternatiivid Kehtib
price_after_discount price_after_discount, price-after-discount Üldine allahindlusjärgne hind, kui seda üle ei kirjutata.
price_after_discount_lv price_after_discount_lv, price-after-discount-lv Ainult Läti.
price_after_discount_lt price_after_discount_lt, price-after-discount-lt Ainult Leedu.
price_after_discount_ee price_after_discount_ee, price-after-discount-ee Ainult Eesti.
price_after_discount_fi price_after_discount_fi, price-after-discount-fi Ainult Soome.

Miinimumhinna väljad

Miinimumhind on tootele lubatud madalaim hind. See kaitseb müüjat selle eest, et arvutatud hind langeks valitud piirist allapoole.

Atribuut Tähendus
min Üldine miinimumhind kõigil turuplatsidel, kui seda üle ei kirjutata.
min_lv Lätis lubatud miinimumhind.
min_lt Leedus lubatud miinimumhind.
min_ee Eestis lubatud miinimumhind.
min_fi Soomes lubatud miinimumhind.

Hinna turvalisus: kontrollige enne testi käivitamist iga miinimumhinda. Toote tasemel määratud miinimumväärtused on olulised turvapiirangud ja võivad mõjutada arvutatud tulemust igal turuplatsil.

Maksimumhinna väljad

Maksimumhind on tootele lubatud kõrgeim hind. See piirab, kui palju võib arvutatud hinda tõsta.

Atribuut Tähendus
max Üldine maksimumhind kõigil turuplatsidel, kui seda üle ei kirjutata.
max_lv Lätis lubatud maksimumhind.
max_lt Leedus lubatud maksimumhind.
max_ee Eestis lubatud maksimumhind.
max_fi Soomes lubatud maksimumhind.

Kontrollige, et miinimum- ja maksimumväärtused moodustaksid mõistliku lubatud vahemiku. Testija kasutab neid piiranguid koos seadistatud BuyBoxi reeglitega arvutatud hindade ettevalmistamisel.

Kuidas Discount Mode XML-väljundit muudab

Discount Mode ei lülita BuyBoxi arvutust sisse ega välja. See muudab seda, kuidas algne sisestatud hind ja arvutatud hind XML-i hinnaväljadele paigutatakse.

Discount Mode Allahindluse-eelne hind Allahindlusjärgne hind
Lubatud Lähtefailis sisestatud algne hind. B2BLIX-i arvutatud hind.
Keelatud B2BLIX-i arvutatud hind. B2BLIX-i arvutatud hind.

Lülitage Discount Mode sisse, kui vastuvõttev süsteem peab nägema nii alghinda kui ka madalamat või muul viisil kohandatud arvutatud hinda. Jätke see välja, kui mõlemad XML-i hinnaväljad peavad sisaldama arvutatud väärtust.

Mis juhtub pärast testi käivitamist

Testija teostab ühekordse sünkroonimisprotseduuri:

  1. B2BLIX avab sisestatud Google Sheetsi dokumendi.
  2. Tooteridadelt loetakse toetatud väljad.
  3. Tooted sobitatakse saadaolevate identifikaatorite, peamiselt EAN-i või GTIN-i, abil.
  4. Arvutuseks kasutatakse saadaolevat avastatud turuplatsiteavet.
  5. Vajaduse korral rakendatakse teie seadistatud BuyBoxi reegleid, välistusi ja hinnapiiranguid.
  6. Genereeritakse töödeldud tooteandmete ja arvutatud hindadega XML-tulemus.
  7. Tulemust saab vaadata sünkroonimise aruandluse töövoo kaudu.

Turuplats otsustab endiselt, milline müüja BuyBoxi saab. Testitulemus näitab B2BLIX-i arvutust; see ei taga BuyBoxi positsiooni, järjestust, tulu ega kasumit.

Kuidas loodud XML-i tõlgendada

XML rühmitab sisestatud read eraldi toodetena. Iga toode võib sisaldada oma identifikaatorit, SKU-d, laoseisu ning eraldi hinnavälju Läti, Leedu, Eesti ja Soome jaoks.

Tulemus võib sisaldada eraldi elemente järgmiste andmete jaoks:

  • toote GTIN;
  • müüja SKU;
  • sisestatud laokogus;
  • allahindluse-eelne hind igal turuplatsil;
  • allahindlusjärgne arvutatud hind igal turuplatsil.
Näide loodud XML-ist kolme toote, GTIN-i, SKU, laoseisu ning turuplatsi-põhiste allahindluseelsete ja allahindlusjärgsete hindadega
See näide näitab loodud XML-tulemuse struktuuri. Igal tootel on oma identifikaator ning eraldi hinnaväljad Läti, Leedu, Eesti ja Soome jaoks.

XML on väljunddokument. See tuleb üle vaadata enne, kui selle avalik URL ühendatakse turuplatsi või muu tootmissüsteemiga.

Soovitatav turvaline töövoog

  1. Avage Google Sheetsi näidisdokument.
  2. Looge eraldi testleht selle asemel, et kasutada kogu tootmisallikat.
  3. Lisage väike arv teadaolevate EAN-idega tooteid.
  4. Veenduge, et tooted on teie turuplatsi pakkumistes juba olemas ja B2BLIX on need avastanud.
  5. Lisage praegune hind, laoseis ja vajalik kohaletoimetamise teave.
  6. Lisage hoolikalt kontrollitud miinimum- ja maksimumhinnad.
  7. Kasutage kõigil turgudel üldisi väärtusi ja lisage piirkondlikud veerud ainult erandite jaoks.
  8. Valige sobiv Discount Mode.
  9. Veenduge, et avalik XML-i testi-URL ei oleks ühendatud toimiva sihtkohaga.
  10. Käivitage test ja kontrollige loodud XML-i.
  11. Võrrelge väljundit lähteväärtuste ja seadistatud BuyBoxi reeglitega.
  12. Pärast edukat testimist seadistage tegelik allikas ja väljund jaotises Sünkroonimise seaded.

Levinud vead

  • Testija käivitamine ajal, kui loodud XML-i kasutab toimiv integratsioon. Ajutised testtooted ja -hinnad võivad asendada sisu, mida see integratsioon loeb.
  • EAN-i kasutamine, mida ei ole loetletud või avastatud. B2BLIX ei pruugi olla võimeline rida oodatava turuplatsi tooteteabega ühendama.
  • Veeru õigekirja muutmine. Kasutage peamist atribuudinime või üht loetletud alternatiividest täpselt.
  • Eeldamine, et üldine väärtus kirjutab piirkondliku väärtuse üle. Selline väli nagu price_lv on Lätis väljast price prioriteetsem.
  • Laoseisu sisestamine tekstina või kümnendväärtusena. Laoseis tuleb esitada täisarvulise kogusena.
  • Kontrollimata miinimum- ja maksimumhindade kasutamine. Valed piirangud võivad anda tulemusi, mis ei vasta müüja kavandatud hinnavahemikule.
  • Discount Mode'i valesti mõistmine. See muudab algsete ja arvutatud hindade esitust XML-is; see ei avalda allahindlust iseseisvalt.
  • Eeldamine, et loodud XML on juba toimiv. Väljundit ei avaldata turuplatsil, välja arvatud juhul, kui mõni muu seadistatud süsteem seda loeb ja rakendab.
  • Kogu kataloogi kohe testimine. Alustage mõne näidistoodega, et lähteandmeid ja arvutatud tulemusi oleks lihtsam kontrollida.

Näidisjuhtum

Müüja soovib testida ühte toodet, mida pakutakse kõigil neljal turuplatsil. Tavaline sisestatud hind on 100, kuid Läti hind peab olema 90. Lubatud hinnavahemik on 80 kuni 120.

Veerg Näidisväärtus Eesmärk
ean 123456789 Sobitab rea B2BLIX-ile teadaoleva tootega.
sku TEST-001 Annab müüja sisemise tooteviite.
stock 5 Määrab testiväljundis saadaoleva koguse.
price 100 Määrab üldise sisestatud hinna.
price_lv 90 Kirjutab Läti puhul üldise hinna üle.
min 80 Määrab üldise lubatud miinimumhinna.
max 120 Määrab üldise lubatud maksimumhinna.

Testi ajal alustab Läti sisestatud piirkondlikust väärtusest 90. Leedu, Eesti ja Soome kasutavad üldist väärtust 100. Seejärel hindab B2BLIX toodet seadistatud BuyBoxi reeglite alusel ning hoiab iga arvutatud tulemuse saadaolevate miinimum- ja maksimumpiirangute piires.

Müüja saab loodud XML-i üle vaadata, kinnitada, et Läti erand rakendus õigesti, ning kontrollida, et soovitatud hinnad jäävad kavandatud vahemikku, enne kui tooteallikas regulaarsele sünkroonimisele üle viiakse.