API eksporto apribojimai, intervalai ir didelių katalogų vėlavimai

Kodėl API kainų atnaujinimai gali užtrukti ilgiau?

Šis straipsnis aktualus, kai B2BLIX apskaičiavo naujas kainas, tačiau pakeitimai Pigu, 220.lv, Kaup24.ee arba HobbyHall.fi platformose pasirodo vėliau, nei tikėtasi.

API publikavimo sparta iš dalies priklauso nuo apdorojamų produktų skaičiaus. Mažas katalogas paprastai gali būti apdorojamas dažniau nei katalogas, kuriame yra dešimtys ar šimtai tūkstančių produktų.

Trumpas atsakymas

B2BLIX automatiškai koreguoja API eksporto intervalą pagal bendrą produktų skaičių jūsų paskyroje. Katalogui augant, sistema gali naudoti ilgesnį intervalą, kad eksportas būtų saugiai apdorotas laikantis prekyvietės API apribojimų.

Produktų skaičius vertinamas visose prijungtose Pigu Group prekyvietėse kartu, o ne atskirai kiekvienai prekyvietei.

Jei katalogas tampa per didelis palaikomam API publikavimo procesui, B2BLIX gali vėl perjungti išvestį į XML. XML skaičiavimo rezultatai vis tiek gali būti teisingi, net jei tiesioginis API publikavimas visam katalogui vėluoja arba yra nepasiekiamas.

Apskaičiuota arba paruošta kaina nebūtinai jau rodoma prekyvietėje. Kaina prekyvietėje pradedama rodyti tik ją eksportavus, priėmus ir pritaikius prekyvietei. Prieš manydami, kad apskaičiuota kaina sėkmingai paskelbta, patikrinkite sinchronizavimo ataskaitą.

Kaip API užklausų apribojimai veikia eksportą

Pigu taiko savo API užklausų apribojimus. Pavyzdžiui, jų API dokumentacijoje buvo nurodytas pasiūlymų atnaujinimo proceso apribojimas – 500 užklausų per 10 sekundžių.

B2BLIX laikosi prekyviečių API apribojimų. Tai reiškia, kad paslauga negali vienu metu išsiųsti neriboto skaičiaus produktų atnaujinimų, net jei daug kainų yra paruoštos publikuoti.

Šie apribojimai padeda apsaugoti prekyvietės paslaugą nuo per didelio srauto. Jie nereiškia, kad kiekviena paskyra visada gali paskelbti 500 produktų pakeitimų kas 10 sekundžių. Faktinis apdorojimo laikas taip pat gali priklausyti nuo katalogo dydžio, prekyviečių skaičiaus, prekyvietės API atsako laiko ir publikavimo eilėje laukiančių atnaujinimų skaičiaus.

Prekyvietės API apribojimai gali keistis. Naujausia Pigu API dokumentacija turėtų būti laikoma pagrindiniu šaltiniu, kuriame pateikiamas aktualus užklausų apribojimas.

Kaip katalogo dydis keičia eksporto intervalą

B2BLIX naudoja produktų kiekio intervalus, kad nustatytų tinkamą API eksporto intervalą. Tikslūs vidiniai slenksčiai neskelbiami, nes jie gali būti koreguojami keičiantis paslaugai ir prekyviečių integracijoms.

Praktiškai procesas vyksta taip:

Mažesniam katalogui gali būti taikomas trumpesnis API eksporto intervalas.
Didėjant bendram produktų skaičiui, B2BLIX automatiškai parenka ilgesnį intervalą.
Į bendrą skaičių įtraukiami produktai iš visų prijungtų Pigu Group prekyviečių.
Labai dideliems katalogams gali reikėti daugiau laiko kiekvienai publikavimo eilei užbaigti.
Jei katalogas viršija palaikomą API apimtį, išvestis gali būti pakeista į XML.

Ilgesnis intervalas nebūtinai reiškia klaidą. Tai gali būti numatytas didesnio produktų skaičiaus apdorojimo rezultatas, laikantis API apribojimų.

Ką patikrinti savo paskyroje

1. Patvirtinkite dabartinį eksporto metodą

Patikrinkite, ar jūsų paskyra sukonfigūruota skelbti kainas per API, ar generuoti XML išvestį. Taip pat peržiūrėkite sukonfigūruotą sinchronizavimo dažnį ir atnaujinimo nustatymus.

Norėdami tai patikrinti savo paskyroje, atidarykite Sinchronizavimo nustatymai.
Norėdami suprasti šiame puslapyje pateikiamus laukus, skaitykite Sinchronizavimo nustatymai: produktų importo ir kainų eksporto konfigūravimas.

Prieš keisdami eksporto metodą arba dažnį, patikrinkite, kiek produktų šiuo metu yra jūsų šaltinyje ir ar tame pačiame šaltinyje nėra produktų kelioms prekyvietėms.

2. Peržiūrėkite naujausią sinchronizavimo ataskaitą

Sinchronizavimo ataskaita padeda atskirti skaičiavimą nuo publikavimo. Patikrinkite, ar naujausias vykdymas baigtas, kiek produktų apdorota ir ar eksporto metu pateikta įspėjimų arba klaidų.

Norėdami tai patikrinti savo paskyroje, atidarykite Sinchronizavimo ataskaitos.
Norėdami suprasti ataskaitų būsenas ir elementų suvestines, skaitykite Sinchronizavimo ataskaitos: importo, BuyBox skaičiavimo ir eksporto rezultatų peržiūra.

3. Patikrinkite vieną paveiktą produktą

Jei vėluoja tik kai kurių produktų kainos, peržiūrėkite konkretų EAN skiltyje „Produktų tikrintuvas“. Tai gali padėti patvirtinti apskaičiuotą kainą ir naujausią žinomą to produkto eksporto būseną.

Norėdami tai patikrinti savo paskyroje, atidarykite Produktų tikrintuvas.
Norėdami suprasti ten pateikiamą produkto informaciją, skaičiavimo ir eksporto duomenis, skaitykite Produktų tikrintuvas: produkto duomenų, kainų skaičiavimų ir eksporto peržiūra.

Dažniausios lėtesnio API publikavimo priežastys

Bendras katalogas išaugo. Produktai iš visų prijungtų prekyviečių prisideda prie apimties, pagal kurią parenkamas eksporto intervalas.
Atliekant tą patį sinchronizavimą pasikeitė daug kainų. Dėl didesnio pakeitimų skaičiaus susidaro ilgesnė publikavimo eilė.
Prekyvietės API atnaujinimus apdoroja lėčiau. B2BLIX turi laukti prekyvietės API atsakymų ir laikytis jos atsakymų bei užklausų apribojimų.
API eksportas vis dar vykdomas. Skaičiavimas gali būti baigtas anksčiau, nei paskelbti visi paruošti atnaujinimai.
Išvestis perjungta į XML. Katalogui viršijus palaikomą API apimtį, vietoj tiesioginio publikavimo per API gali būti naudojamas XML.
Patikrinta tik prekyvietėje rodoma kaina. Peržiūrėkite sinchronizavimo ataskaitas ir Produktų tikrintuvą, kad nustatytumėte, ar vėlavimas įvyko skaičiavimo, eksporto ar pritaikymo prekyvietėje etape.

Pavyzdys

Pardavėjas importuoja produktus į 220.lv, Pigu.lt ir Kaup24.ee. Bendras katalogas yra gerokai didesnis nei bet kurios vienos prekyvietės produktų skaičius.

B2BLIX baigia BuyBox skaičiavimus ir paruošia atnaujintas kainas. Kadangi bendras katalogas yra didelis, API eksportui taikomas ilgesnis apdorojimo intervalas, o atnaujinimai publikuojami eilėje. Todėl kai kurių produktų kainos prekyvietėje dar gali rodyti ankstesnę reikšmę, kol toliau apdorojami vėlesni produktai.

Pardavėjas pirmiausia turėtų patikrinti naujausią sinchronizavimo ataskaitą. Jei vėluoja konkretus produktas, pardavėjas gali naudoti Produktų tikrintuvą ir palyginti jo apskaičiuotą kainą su eksporto būsena.

Kas toliau?

Atidarykite Sinchronizavimo nustatymus ir patvirtinkite, ar pasirinkta išvestis yra API, ar XML.
Patikrinkite bendrą produktų skaičių visose prekyvietėse, įtrauktose į jūsų šaltinį.
Atidarykite naujausią sinchronizavimo ataskaitą ir peržiūrėkite apdorojimo bei eksporto rezultatus.
Naudokite Produktų tikrintuvą vienam ar keliems paveiktiems EAN.
Venkite pakartotinai keisti sinchronizavimo nustatymus, kol dar gali būti apdorojamas esamas didelis eksportas.
Jei XML išvestis yra teisinga, tačiau labai didelio katalogo API publikavimas nuolat vėluoja, susisiekite su B2BLIX ir aptarkite, ar galėtų tikti specialiai didelės apimties katalogams pritaikyta sąranka.

Pranešdami apie nuolatinį vėlavimą, nurodykite apytikslį bendrą produktų skaičių, paveiktas prekyvietes, atitinkamo sinchronizavimo laiką ir kelių pavyzdinių EAN sąrašą. Nenurodykite paskyros slaptažodžių ar API prisijungimo duomenų.