API-ekspordi piirangud, intervallid ja suurte kataloogide viivitused

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

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

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

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 eksport saaks turvaliselt ja turuplatsi API piirangute piires töödeldud.

Toodete arvu arvestatakse kõigi ühendatud Pigu Groupi turuplatside peale kokku, mitte iga turuplatsi kohta eraldi.

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

Arvutatud või ettevalmistatud hind ei pruugi turuplatsil veel aktiivne olla. Hind muutub aktiivseks alles pärast selle eksportimist, vastuvõtmist ja turuplatsi poolt rakendamist. Enne kui eeldate, et arvutatud hind avaldati edukalt, kontrollige sünkroonimisaruannet.

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

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

B2BLIX järgib turuplatsi API piiranguid. See tähendab, et teenus ei saa saata korraga piiramatut arvu tooteuuendusi isegi siis, kui paljud hinnad on avaldamiseks valmis.

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

Turuplatsi API piirangud võivad muutuda. Uusima päringupiirangu jaoks tuleks lähtuda Pigu API ajakohasest dokumentatsioonist kui kõige usaldusväärsemast allikast.

Kuidas kataloogi suurus ekspordiintervalli muudab?

B2BLIX kasutab sobiva API-ekspordi intervalli määramiseks toodete mahu vahemikke. Täpseid sisemisi lävendeid ei avaldata, sest neid võidakse teenuse ja turuplatside integratsioonide muutudes kohandada.

Praktikas toimib protsess järgmiselt:

Väiksema kataloogi puhul saab kasutada lühemat API-ekspordi intervalli.
Kui toodete koguarv suureneb, valib B2BLIX automaatselt pikema intervalli.
Koguarv sisaldab kõigi ühendatud Pigu Groupi turuplatside tooteid.
Väga suurte kataloogide iga avaldamisjärjekorra lõpetamine võib võtta rohkem aega.
Kui kataloog ületab toetatud API kaudu töödeldava mahu, võidakse väljund muuta XML-iks.

Pikem intervall ei tähenda tingimata viga. See võib olla suurema tootearvu töötlemisel ja API piirangute järgimisel oodatav tulemus.

Mida oma kontol kontrollida?

1. Kinnitage praegune ekspordimeetod

Kontrollige, kas teie konto on seadistatud hindade avaldamiseks API kaudu või XML-väljundi genereerimiseks. Vaadake üle ka seadistatud sünkroonimissagedus ja uuendamise seaded.

Selle kontrollimiseks avage oma kontol Sünkroonimise seaded.
Selle lehe väljade kohta lisateabe saamiseks lugege juhendit Sünkroonimise seaded: toodete impordi ja hindade ekspordi seadistamine.

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

2. Vaadake üle uusim sünkroonimisaruanne

Sünkroonimisaruanne aitab eristada arvutamist ja avaldamist. Kontrollige, kas viimane käivitus lõppes, 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 kohta lisateabe saamiseks lugege juhendit Sünkroonimisaruanded: impordi, BuyBoxi arvutuse ja eksporditulemuste ülevaade.

3. Kontrollige üht mõjutatud toodet

Kui ainult mõne hinna kuvamine hilineb, vaadake Product Checkeris konkreetset EAN-i. See aitab kinnitada selle toote arvutatud hinda ja viimast teadaolevat ekspordi olekut.

Selle kontrollimiseks avage oma kontol Product Checker.
Seal kuvatavate tooteandmete, arvutuste ja eksporditeabe kohta lisateabe saamiseks lugege juhendit Product Checker: tooteandmete, hinnarvutuste ja ekspordi ülevaade.

Aeglase API kaudu avaldamise levinumad põhjused

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

Näide

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

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õne toote aktiivsed turuplatsi hinnad näidata endiselt eelmist väärtust, samal ajal kui hilisemaid tooteid alles töödeldakse.

Müüja peaks esmalt kontrollima uusimat sünkroonimisaruannet. Üksiku hilinenud toote puhul saab ta seejärel kasutada Product Checkerit, et võrrelda selle arvutatud hinda ekspordi olekuga.

Mida edasi teha?

Avage Sünkroonimise seaded ja kinnitage, kas valitud väljund on API või XML.
Kontrollige teie allikasse kaasatud kõigi turuplatside 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 hilineb, võtke ühendust B2BLIXiga, et arutada, kas spetsiaalne suure mahu lahendus võiks olla sobiv.

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