API-ekspordi piirangud, intervallid ja suurte kataloogide viivitused

Miks võivad API-hinnauuendused kauem aega võtta?

See artikkel on asjakohane siis, kui B2BLIX on arvutanud uued hinnad, kuid muudatused ilmuvad Pigu, 220.lv, Kaup24.ee või HobbyHall.fi platvormil oodatust hiljem.

API kaudu avaldamise kiirus sõltub osaliselt töödeldavate toodete arvust. Väikest kataloogi saab tavaliselt töödelda sagedamini kui kataloogi, mis sisaldab kümneid või sadu tuhandeid tooteid.

Lühike vastus

B2BLIX kohandab API-ekspordi intervalli automaatselt vastavalt teie kontol olevate toodete koguarvule. Kataloogi kasvades võib süsteem kasutada pikemat intervalli, et eksporti saaks turvaliselt töödelda ja järgida marketplace'i API piiranguid.

Toodete arvu arvestatakse kõigi ühendatud Pigu Groupi marketplace'ide peale kokku, mitte iga marketplace'i kohta eraldi.

Kui kataloog muutub toetatud API kaudu avaldamise protsessi jaoks liiga suureks, võib B2BLIX väljundi tagasi XML-vormingusse lülitada. XML-i arvutustulemused võivad olla õiged ka siis, kui API kaudu avaldamine viibib või ei ole kogu kataloogi puhul saadaval.

Arvutatud või ettevalmistatud hind ei pruugi marketplace'il veel aktiivne olla. Hind muutub aktiivseks alles pärast selle eksportimist, marketplace'i vastuvõtmist ja rakendamist. Enne eeldamist, et arvutatud hind avaldati edukalt, kontrollige sünkroonimisaruannet.

Kuidas API-päringute piirangud eksporti mõjutavad?

Pigu rakendab oma API-le päringupiiranguid. Näiteks on selle API dokumentatsioonis kirjeldatud pakkumiste uuendamise protsessi piiranguna 500 päringut 10 sekundi jooksul.

B2BLIX järgib marketplace'ide API-piiranguid. See tähendab, et teenus ei saa saata korraga piiramatul arvul toodete uuendusi, isegi kui paljud hinnad on avaldamiseks valmis.

Need piirangud aitavad kaitsta marketplace'i teenust liigse liikluse eest. See ei tähenda, et iga konto saaks alati avaldada 500 tootemuudatust iga 10 sekundi järel. Tegelik töötlemisaeg võib sõltuda ka kataloogi suurusest, marketplace'ide arvust, marketplace'i API vastuse kiirusest ja avaldamisjärjekorras ootavate uuenduste arvust.

Marketplace'i API-piirangud võivad muutuda. Viimase päringupiirangu autoriteetseks allikaks tuleb pidada Pigu kehtivat API dokumentatsiooni.

Kuidas kataloogi suurus ekspordiintervalli muudab?

B2BLIX kasutab sobiva API-ekspordiintervalli määramiseks tootemahtude vahemikke. Täpseid sisemisi piirmäärasid ei avaldata, sest neid võidakse teenuse ja marketplace'i integratsioonide muutudes kohandada.

Praktikas toimib protsess järgmiselt:

Väiksema kataloogi puhul saab kasutada lühemat API-ekspordiintervalli.
Toodete koguarvu suurenemisel valib B2BLIX automaatselt pikema intervalli.
Koguarv sisaldab kõigi ühendatud Pigu Groupi marketplace'ide tooteid.
Väga suurte kataloogide puhul võib iga avaldamisjärjekorra lõpetamine võtta rohkem aega.
Kui kataloog ületab toetatud API mahu, võidakse väljund muuta XML-iks.

Pikem intervall ei viita tingimata veale. See võib olla suurema hulga toodete töötlemisel ja API-piirangute järgimisel eeldatav tulemus.

Mida oma kontol kontrollida?

1. Kinnitage praegune ekspordimeetod

Kontrollige, kas teie konto on seadistatud avaldama hindu API kaudu või genereerima XML-väljundit. Vaadake üle ka seadistatud sünkroonimissagedus ja uuendamise seaded.

Selle kontrollimiseks avage oma kontol sünkroonimise seaded.
Sellel lehel olevate väljade mõistmiseks lugege artiklit Sünkroonimise seaded: toodete impordi ja hinnaekspordi seadistamine.

Enne ekspordimeetodi või -sageduse muutmist kontrollige, kui palju tooteid teie allikas praegu sisaldab ja kas sama allikas sisaldab mitme marketplace'i tooteid.

2. Vaadake üle uusim sünkroonimisaruanne

Sünkroonimisaruanne aitab eristada arvutamist avaldamisest. Kontrollige, kas viimane käivitus lõpetati, kui palju tooteid töödeldi ning kas eksport sisaldas hoiatusi või vigu.

Selle kontrollimiseks avage oma kontol sünkroonimisaruanded.
Aruande olekute ja üksuste kokkuvõtete mõistmiseks lugege artiklit Sünkroonimisaruanded: impordi, BuyBoxi arvutuse ja eksporditulemuste ülevaade.

3. Kontrollige üht mõjutatud toodet

Kui ainult mõne hinna kuvamine viibib, kontrollige Product Checkeris konkreetset EAN-i. See aitab kinnitada selle toote arvutatud hinda ja viimati teadaolevat ekspordiolekut.

Selle kontrollimiseks avage oma kontol Product Checker.
Seal kuvatavate tooteandmete, arvutuse ja eksporditeabe mõistmiseks lugege artiklit Product Checker: tooteandmete, hinn arvutuste ja eksportide ülevaade.

Aeglase API kaudu avaldamise levinud põhjused

Kogu kataloog on kasvanud. Kõigi ühendatud marketplace'ide tooted mõjutavad ekspordiintervalli valimiseks kasutatavat mahtu.
Sama sünkroonimise käigus muutus suur hulk hindu. Rohkem muudatusi tekitab suurema avaldamisjärjekorra.
Marketplace'i API töötleb uuendusi aeglasemalt. B2BLIX peab ootama marketplace'i API vastuseid ja päringupiiranguid järgima.
API-eksport on veel pooleli. Arvutamine võis lõppeda enne, kui kõik ettevalmistatud uuendused on avaldatud.
Väljund lülitati XML-i. Toetatud API mahtu ületava kataloogi puhul võidakse otsese API kaudu avaldamise asemel kasutada XML-i.
Kontrolliti ainult marketplace'il aktiivset hinda. Vaadake üle sünkroonimisaruanded ja Product Checker, et teha kindlaks, kas viivitus tekkis arvutamise, ekspordi või marketplace'il rakendamise ajal.

Näide

Müüja impordib tooteid 220.lv, Pigu.lt ja Kaup24.ee jaoks. Ühendatud kataloog on palju suurem kui ühegi marketplace'i toodete arv eraldi.

B2BLIX lõpetab BuyBoxi arvutused ja valmistab ette uuendatud hinnad. Kuna ühendatud kataloog on suur, kasutab API-eksport pikemat töötlemisintervalli ning uuendused avaldatakse järjekorras. Seetõttu võivad mõned marketplace'il aktiivsed hinnad endiselt näidata eelmist väärtust, samal ajal kui hilisemaid tooteid alles töödeldakse.

Müüja peaks esmalt kontrollima uusimat sünkroonimisaruannet. Konkreetse viivitusega toote puhul saab müüja seejärel kasutada Product Checkerit, et võrrelda selle arvutatud hinda ekspordiolekuga.

Mida järgmisena teha?

Avage sünkroonimise seaded ja kinnitage, kas valitud väljund on API või XML.
Kontrollige teie allikasse kaasatud kõigi marketplace'ide toodete koguarvu.
Avage uusim sünkroonimisaruanne ning vaadake üle selle töötlemis- ja eksporditulemused.
Kasutage Product Checkerit ühe või mitme mõjutatud EAN-i kontrollimiseks.
Ärge muutke sünkroonimise seadeid korduvalt ajal, mil olemasolev suur eksport võib veel töötlemisel olla.
Kui XML-väljund on korrektne, kuid API kaudu avaldamine väga suure kataloogi puhul pidevalt viibib, võtke ühendust B2BLIX-iga, et arutada, kas spetsiaalne suure mahu lahendus võiks olla sobiv.

Püsivast viivitusest teatamisel esitage ligikaudne toodete koguarv, mõjutatud marketplace'id, asjaomase sünkroonimise aeg ja mõni näidis-EAN. Ärge lisage konto paroole ega API mandaate.