Grįžti į visus vadovus

Sinchronizacijos tikrintuvas ir „Google Sheets“ failo struktūra

Sinchronizacijos tikrintuvas patikrina, ar „Google Sheets“ produktų failo struktūra yra teisinga, ir parodo, kaip B2BLIX apdorotų nedidelį produktų rinkinį. Jis sugeneruoja bandomąjį XML rezultatą tiesiogiai neskelbdamas kainų prekyvietėje.

Kam naudojamas sinchronizacijos tikrintuvas

Sinchronizacijos tikrintuvas yra parengiamasis įrankis pardavėjams, norintiems patikrinti savo produktų failą prieš nustatant reguliarią sinchronizaciją.

Galite sukurti nedidelį „Google Sheets“ dokumentą su tikrais arba pavyzdiniais produktais, pateikti jo URL ir vieną kartą paleisti BuyBox skaičiavimo procesą. B2BLIX perskaito pateiktus produktų duomenis, naudoja prieinamą aptiktą prekyviečių informaciją ir jūsų sukonfigūruotas BuyBox taisykles bei parengia XML failą su apskaičiuotais rezultatais.

Šis puslapis ypač naudingas, kai reikia:

  • Patvirtinti teisingus stulpelių pavadinimus ir failo struktūrą.
  • Suprasti, ką reiškia kiekvienas palaikomas produkto laukas.
  • Išbandyti bendrąsias ir konkrečiai prekyvietei skirtas kainas.
  • Patikrinti mažiausios ir didžiausios kainos ribas.
  • Išbandyti išimties taisykles arba neįprastas produktų situacijas.
  • Peržiūrėti XML rezultatą prieš konfigūruojant reguliarią sinchronizaciją.

Sinchronizacijos tikrintuvas paprastai naudojamas prieš pridedant galutinį produktų šaltinį skiltyje Sinchronizacijos nustatymai. Sukonfigūravus ir paleidus reguliarią sinchronizaciją, tikrintuvą reikėtų naudoti tik labai atsargiai.

Svarbu: Paleidus testą kainos tiesiogiai nesiunčiamos į Pigu, 220.lv, Kaup24.ee ar HobbyHall.fi. Tačiau testas gali atnaujinti sugeneruotą viešą XML tuo pačiu nekintančiu URL. Nepaleiskite testo, kol šis XML URL prijungtas prie veikiančios prekyvietės ar kitos sistemos, nes prijungta sistema gali gauti laikinus testavimo duomenis.

Sinchronizacijos tikrintuvo puslapis su „Google Sheets“ URL lauku, Discount Mode jungikliu, pavyzdinio lapo mygtuku ir palaikomų atributų lentele
Sinchronizacijos tikrintuvo sąsajoje rodoma, kur įvesti „Google Sheets“ URL, kaip įjungti Discount Mode, kur atidaryti pavyzdinį dokumentą ir kokie produkto atributai palaikomi.

Ką galite atlikti šiame puslapyje

  • Atidaryti pavyzdinį „Google Sheets“ dokumentą su numatyta struktūra.
  • Įvesti savo „Google Sheets“ produktų failo URL.
  • Pasirinkti, kaip pradinės ir apskaičiuotos kainos turi būti pateikiamos XML išvestyje.
  • Peržiūrėti priimtinus laukų pavadinimus ir alternatyvius stulpelių pavadinimus.
  • Paleisti vienkartinį sinchronizacijos testą.
  • Sugeneruoti XML failą su apdorotais produktais ir apskaičiuotomis kainomis.
  • Peržiūrėti sugeneruotą rezultatą sinchronizacijos ataskaitų teikimo procese.

Testas atlieka tikrą skaičiavimo procedūrą, tačiau apskaičiuota ar eksportuota kaina savaime netampa veikiančios prekyvietės kaina. Kaina tampa galiojanti tik tada, kai išorinė integracija naudoja sugeneruotą išvestį, o prekyvietė ją priima ir pritaiko.

Pagrindiniai laukai ir valdikliai

Laukas arba valdiklis Ką tai reiškia Kada naudoti
Google Sheets URL „Google Sheets“ dokumento, kuriame yra norimi išbandyti produktai, adresas. Įklijuokite URL paruošę lapą su palaikomais stulpelių pavadinimais. Įsitikinkite, kad B2BLIX gali pasiekti dokumentą pagal pateiktą URL.
Discount Mode Nustato, kaip pateikta ir apskaičiuota kaina pateikiamos XML išvestyje. Įjunkite, kai norite, kad XML išsaugotų pateiktą kainą kaip pradinę kainą, o apskaičiuotą kainą rodytų kaip kainą su nuolaida.
Open example: Google Sheets Atidaro pavyzdinę skaičiuoklę su numatyta struktūra. Naudokite prieš kurdami savo dokumentą arba tikrindami stulpelių rašybą ir tvarką.
Attribute table Joje pateikiamas pagrindinis priimtinas lauko pavadinimas, palaikomos alternatyvos ir trumpas aprašymas. Naudokite pavadindami „Google Sheets“ dokumento stulpelius.
Run test Perskaito pateiktą lapą, apdoroja jo produktus, pritaiko prieinamus BuyBox nustatymus ir sugeneruoja testo rezultatą. Naudokite patikrinę šaltinio URL, produktų identifikatorius, kainas, ribas ir regionines reikšmes.

Kaip paruošti „Google Sheets“ dokumentą

Kiekvienam produktui naudokite po vieną eilutę. Pirmoje eilutėje turi būti palaikomų atributų pavadinimai.

Tikrintuvas priima pagrindinius puslapyje nurodytus atributų pavadinimus ir kai kurių laukų alternatyvius pavadinimus. Rašykite tiksliai taip, kaip parodyta. Nedėkite tarpų ir nekeiskite apatinių brūkšnių bei brūkšnelių, nebent konkreti alternatyva yra nurodyta sąraše.

Puslapyje nepažymėti visi galimi privalomi stulpeliai. Praktikoje pagrindinė produkto sutapatinimo reikšmė yra EAN arba GTIN. Pridėkite kitus laukus, reikalingus norimai išbandyti situacijai.

Produkto identifikatorius turi nurodyti produktą, kuris yra pardavėjo prekyviečių sąrašuose ir kurį aptiko B2BLIX. Nežinomas arba neteisingas EAN gali sutrukdyti susieti produktą su prieinama prekyvietės informacija.

Prekyviečių sufiksai

Kelių laukų grupės palaiko tiek bendrąją reikšmę, tiek reikšmę konkrečiai prekyvietei. Prekyvietė identifikuojama sufiksu stulpelio pavadinimo pabaigoje.

Sufiksas Prekyvietė Lauko pavyzdys
_lv 220.lv Latvijoje price_lv
_lt Pigu.lt Lietuvoje price_lt
_ee Kaup24.ee Estijoje price_ee
_fi HobbyHall.fi Suomijoje price_fi

Kaip veikia bendrosios ir konkrečioms prekyvietėms skirtos reikšmės

Laukas be prekyvietės sufikso yra bendroji reikšmė visoms palaikomoms prekyvietėms. Konkrečiai prekyvietei skirtas laukas pakeičia bendrąją reikšmę tik tai prekyvietei.

Pavyzdžiui, tarkime, kad produkto eilutėje yra:

Stulpelis Reikšmė
price 100
price_lv 90

Taikomos pateiktos kainos yra:

  • Latvijoje: 90, nes price_lv pakeičia bendrąją reikšmę.
  • Lietuvoje: 100, iš price.
  • Estijoje: 100, iš price.
  • Suomijoje: 100, iš price.

Tas pats principas taikomas:

  • Prekių atsiėmimo arba pristatymo valandoms.
  • Kainoms prieš nuolaidą.
  • Kainoms po nuolaidos.
  • Mažiausioms leidžiamoms kainoms.
  • Didžiausioms leidžiamoms kainoms.

Nereikia kartoti tos pačios reikšmės visuose keturiuose prekyviečių stulpeliuose. Įveskite bendrąją reikšmę ir pridėkite tik nuo jos besiskiriančias regionines išimtis.

Produkto identifikavimo laukai

Atributas Priimtina alternatyva Reikšmė ir naudojimas
ean gtin

Pagrindinis produkto identifikatorius, naudojamas pateiktai eilutei susieti su prekyvietės produktu.

EAN turi priklausyti produktui, esančiam pardavėjo Pigu Group sąrašuose ir žinomam B2BLIX.
sku sku

Pardavėjo Stock Keeping Unit identifikatorius.

Jis gali būti papildoma nuoroda arba tikrinimo reikšmė. Jis nepakeičia EAN, kai produktus reikia sutapatinti pagal EAN.

Atsargų laukas

Atributas Priimtina alternatyva Reikšmė ir naudojimas
stock stock

Turimas produkto kiekis.

Įveskite sveikąjį skaičių, pavyzdžiui, 0, 3 arba 25. Kai pasirinktas XML arba API procesas apima atsargų informaciją, B2BLIX išvestyje naudoja pateiktą kiekį.

Reikšmė 0 reiškia, kad šiuo metu nėra nė vieno turimo vieneto. Atidžiai patikrinkite atsargų reikšmes, kai testuojate išvestį, kurią gali perskaityti kita sistema.

Prekių atsiėmimo ir pristatymo valandų laukai

Šie laukai nurodo produkto pristatymo arba atsiėmimo laiką palaikomose prekyvietėse.

Atributas Priimtina alternatyva Taikoma
collectionhours collection_hours Bendroji reikšmė visoms prekyvietėms, jei nepakeista.
collectionhours_lv collection_hours_lv Tik Latvijai.
collectionhours_lt collection_hours_lt Tik Lietuvai.
collectionhours_ee collection_hours_ee Tik Estijai.
collectionhours_fi collection_hours_fi Tik Suomijai.

Naudokite bendrąjį lauką, kai pristatymo laikas visose rinkose yra vienodas. Kai vienoje šalyje pristatymo laikas skiriasi, pridėkite konkrečiai prekyvietei skirtą lauką.

Kainos prieš nuolaidą laukai

Šiuose laukuose pateikiama pateikta produkto kaina prieš pritaikant nuolaidas. Bendroji reikšmė naudojama visoms prekyvietėms, jei nepateikta regioninė reikšmė.

Atributas Priimtinos alternatyvos Taikoma
price price_before_discount, price-before-discount Bendroji kaina visoms prekyvietėms, jei nepakeista.
price_lv price_before_discount_lv, price-before-discount-lv Tik Latvijai.
price_lt price_before_discount_lt, price-before-discount-lt Tik Lietuvai.
price_ee price_before_discount_ee, price-before-discount-ee Tik Estijai.
price_fi price_before_discount_fi, price-before-discount-fi Tik Suomijai.

Ši pateikta kaina yra įvesties duomenys. Ji nebūtinai yra galutinė siūloma kaina, nes bandymo metu B2BLIX gali pritaikyti sukonfigūruotą kainodaros strategiją ir saugos ribas.

Kainos po nuolaidos laukai

Šiuose laukuose pateikiama pateikta produkto kaina su nuolaida. Jie taip pat lemia, kaip kainos informacija interpretuojama naudojant Discount Mode.

Atributas Priimtinos alternatyvos Taikoma
price_after_discount price_after_discount, price-after-discount Bendroji kaina su nuolaida, jei nepakeista.
price_after_discount_lv price_after_discount_lv, price-after-discount-lv Tik Latvijai.
price_after_discount_lt price_after_discount_lt, price-after-discount-lt Tik Lietuvai.
price_after_discount_ee price_after_discount_ee, price-after-discount-ee Tik Estijai.
price_after_discount_fi price_after_discount_fi, price-after-discount-fi Tik Suomijai.

Mažiausios kainos laukai

Mažiausia kaina yra mažiausia leidžiama produkto kaina. Ji apsaugo pardavėją nuo to, kad apskaičiuota kaina nukristų žemiau pasirinktos ribos.

Atributas Reikšmė
min Bendroji mažiausia kaina visoms prekyvietėms, jei nepakeista.
min_lv Mažiausia leidžiama kaina Latvijai.
min_lt Mažiausia leidžiama kaina Lietuvai.
min_ee Mažiausia leidžiama kaina Estijai.
min_fi Mažiausia leidžiama kaina Suomijai.

Kainos saugumas: Prieš paleisdami testą peržiūrėkite kiekvieną mažiausią kainą. Produkto lygio mažiausios kainos reikšmės yra svarbios saugos ribos ir gali turėti įtakos kiekvienos prekyvietės apskaičiuotam rezultatui.

Didžiausios kainos laukai

Didžiausia kaina yra didžiausia leidžiama produkto kaina. Ji riboja, kiek gali būti padidinta apskaičiuota kaina.

Atributas Reikšmė
max Bendroji didžiausia kaina visoms prekyvietėms, jei nepakeista.
max_lv Didžiausia leidžiama kaina Latvijai.
max_lt Didžiausia leidžiama kaina Lietuvai.
max_ee Didžiausia leidžiama kaina Estijai.
max_fi Didžiausia leidžiama kaina Suomijai.

Patikrinkite, ar mažiausios ir didžiausios reikšmės sudaro logišką leidžiamą intervalą. Ruošdamas apskaičiuotas kainas tikrintuvas naudoja šias ribas kartu su sukonfigūruotomis BuyBox taisyklėmis.

Kaip Discount Mode keičia XML išvestį

Discount Mode neįjungia ir neišjungia paties BuyBox skaičiavimo. Jis keičia, kaip pradinė pateikta kaina ir apskaičiuota kaina įrašomos į XML kainų laukus.

Discount mode Kaina prieš nuolaidą Kaina po nuolaidos
Įjungtas Šaltinio faile pateikta pradinė kaina. B2BLIX apskaičiuota kaina.
Išjungtas B2BLIX apskaičiuota kaina. B2BLIX apskaičiuota kaina.

Įjunkite Discount Mode, kai priimanti sistema turi matyti ir pradinę kainą, ir mažesnę arba kitaip pakoreguotą apskaičiuotą kainą. Palikite jį išjungtą, kai abiejuose XML kainų laukuose turi būti apskaičiuota reikšmė.

Kas vyksta spustelėjus „Run test“

Tikrintuvas atlieka vienkartinę sinchronizacijos procedūrą:

  1. B2BLIX atidaro pateiktą „Google Sheets“ dokumentą.
  2. Nuskaitomos produktų eilutės ir palaikomi laukai.
  3. Produktai sutapatinami pagal prieinamus identifikatorius, visų pirma EAN arba GTIN.
  4. Skaičiavimui naudojama prieinama aptikta prekyviečių informacija.
  5. Pagal poreikį pritaikomos jūsų sukonfigūruotos BuyBox taisyklės, išimtys ir kainų ribos.
  6. Sugeneruojamas XML rezultatas su apdorotais produktų duomenimis ir apskaičiuotomis kainomis.
  7. Rezultatą galima peržiūrėti sinchronizacijos ataskaitų teikimo procese.

Prekyvietė vis tiek nusprendžia, kuriam pardavėjui skiriamas BuyBox. Testo rezultatas parodo B2BLIX skaičiavimą, tačiau negarantuoja BuyBox pozicijos, užsakymų, pajamų ar pelno.

Kaip interpretuoti sugeneruotą XML

XML pateiktos eilutės sugrupuojamos į atskirus produktus. Kiekviename produkte gali būti jo identifikatorius, SKU, atsargos ir atskiri kainų laukai Latvijai, Lietuvai, Estijai ir Suomijai.

Pavyzdžiui, rezultate gali būti atskiri elementai, skirti:

  • Produkto GTIN.
  • Pardavėjo SKU.
  • Pateiktam atsargų kiekiui.
  • Kainai prieš nuolaidą kiekvienoje prekyvietėje.
  • Apskaičiuotai kainai po nuolaidos kiekvienoje prekyvietėje.
Sugeneruoto XML pavyzdys su trimis produktais, GTIN, SKU, atsargomis ir konkrečioms prekyvietėms skirtomis kainomis prieš nuolaidą ir po nuolaidos
Šiame pavyzdyje rodoma sugeneruoto XML rezultato struktūra. Kiekvienas produktas turi savo identifikatorių ir atskirus kainų laukus Latvijai, Lietuvai, Estijai ir Suomijai.

XML yra išvesties dokumentas. Prieš prijungiant jo viešą URL prie prekyvietės ar kitos gamybinės sistemos, dokumentą reikėtų peržiūrėti.

Rekomenduojama saugi eiga

  1. Atidarykite pavyzdinį „Google Sheets“ dokumentą.
  2. Sukurkite atskirą testavimo lapą, o ne naudokite visą gamybinį šaltinį.
  3. Pridėkite nedaug produktų su žinomais EAN.
  4. Patvirtinkite, kad produktai jau yra jūsų prekyviečių sąrašuose ir kad juos aptiko B2BLIX.
  5. Pridėkite dabartinę kainą, atsargas ir kitą reikalingą pristatymo informaciją.
  6. Atidžiai patikrinkite ir pridėkite mažiausias bei didžiausias kainas.
  7. Naudokite bendrąsias reikšmes visoms rinkoms, o regioninius stulpelius pridėkite tik išimtims.
  8. Pasirinkite tinkamą Discount Mode.
  9. Įsitikinkite, kad viešas XML testo URL neprijungtas prie veikiančios paskirties sistemos.
  10. Paleiskite testą ir peržiūrėkite sugeneruotą XML.
  11. Palyginkite išvestį su šaltinio reikšmėmis ir sukonfigūruotomis BuyBox taisyklėmis.
  12. Sėkmingai išbandę, skiltyje „Sinchronizacijos nustatymai“ sukonfigūruokite tikrąjį šaltinį ir išvestį.

Dažniausios klaidos

  • Tikrintuvas paleidžiamas, kai sugeneruotą XML naudoja veikianti integracija. Laikini testavimo produktai ir kainos gali pakeisti turinį, kurį nuskaito ši integracija.
  • Naudojamas nepateiktas arba neaptiktas EAN. B2BLIX gali nepavykti susieti eilutės su tikėtina prekyvietės produkto informacija.
  • Pakeičiama stulpelio rašyba. Tiksliai naudokite pagrindinį atributo pavadinimą arba vieną iš nurodytų alternatyvų.
  • Tikimasi, kad bendroji reikšmė pakeis regioninę reikšmę. Toks laukas kaip price_lv Latvijai turi pirmenybę prieš price.
  • Atsargos įvedamos kaip tekstas arba dešimtainė reikšmė. Atsargos turi būti pateiktos kaip sveikasis kiekis.
  • Naudojamos nepatikrintos mažiausios ir didžiausios kainos. Neteisingos ribos gali sukurti rezultatus, neatitinkančius numatyto pardavėjo kainų intervalo.
  • Neteisingai suprantamas Discount Mode. Jis keičia pradinių ir apskaičiuotų kainų pateikimą XML faile, tačiau pats savaime nepaskelbia nuolaidos.
  • Manoma, kad sugeneruotas XML jau yra aktyvus. Išvestis nepaskelbiama prekyvietėje, nebent kita sukonfigūruota sistema ją nuskaito ir pritaiko.
  • Iškart testuojamas visas katalogas. Pradėkite nuo kelių reprezentatyvių produktų, kad būtų lengviau patikrinti šaltinio duomenis ir apskaičiuotus rezultatus.

Naudojimo pavyzdys

Pardavėjas nori išbandyti vieną produktą, siūlomą visose keturiose prekyvietėse. Įprasta pateikiama kaina yra 100, tačiau Latvijoje kaina turi būti 90. Leidžiamas kainos intervalas yra nuo 80 iki 120.

Stulpelis Pavyzdinė reikšmė Paskirtis
ean 123456789 Susieja eilutę su B2BLIX žinomu produktu.
sku TEST-001 Pateikia vidinę pardavėjo produkto nuorodą.
stock 5 Nustato turimą kiekį testo išvestyje.
price 100 Nustato bendrąją pateikiamą kainą.
price_lv 90 Pakeičia bendrąją kainą Latvijoje.
min 80 Nustato bendrąją mažiausią leidžiamą kainą.
max 120 Nustato bendrąją didžiausią leidžiamą kainą.

Testo metu Latvijoje pradedama nuo pateiktos regioninės 90 reikšmės. Lietuvoje, Estijoje ir Suomijoje naudojama bendroji 100 reikšmė. Tada B2BLIX įvertina produktą pagal sukonfigūruotas BuyBox taisykles ir užtikrina, kad kiekvienas apskaičiuotas rezultatas neviršytų galimų mažiausios ir didžiausios kainos ribų.

Pardavėjas gali peržiūrėti gautą XML, patvirtinti, kad Latvijos išimtis pritaikyta teisingai, ir įsitikinti, kad siūlomos kainos patenka į numatytą intervalą prieš perkeldamas produkto šaltinį į reguliarią sinchronizaciją.