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 rodomi vėliau, nei tikėtasi.

API publikavimo sparta iš dalies priklauso nuo apdorojamų produktų skaičiaus. Nedidelį katalogą paprastai galima apdoroti dažniau nei katalogą, 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 taikyti ilgesnį intervalą, kad eksportas būtų saugiai apdorotas laikantis prekyviečių API apribojimų.

Produktų skaičius vertinamas visose prijungtose Pigu Group prekyvietėse, o ne atskirai kiekvienoje prekyvietėje.

Jei katalogas tampa per didelis palaikomam API publikavimo procesui, B2BLIX gali vėl pakeisti išvesties formatą į XML. XML skaičiavimo rezultatai vis tiek gali būti teisingi, net jei tiesioginis API publikavimas vėluoja arba nėra pasiekiamas visam katalogui.

Apskaičiuota arba paruošta kaina nebūtinai jau rodoma prekyvietėje. Kaina prekyvietėje pradedama rodyti tik tada, kai ji eksportuojama, priimama ir pritaikoma prekyvietėje. Prieš manydami, kad apskaičiuota kaina buvo 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 produktų atnaujinimų skaičiaus, net jei daug kainų yra paruošta publikuoti.

Šie apribojimai padeda apsaugoti prekyvietės paslaugą nuo per didelio srauto. Tai nereiškia, kad kiekviena paskyra visada gali paskelbti 500 produktų pakeitimų kas 10 sekundžių. Faktinė apdorojimo trukmė 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ą.
Bendras skaičius apima produktus 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švesties formatas gali būti pakeistas į XML.

Ilgesnis intervalas nebūtinai reiškia klaidą. Tai gali būti tikėtinas rezultatas, kai apdorojamas didesnis produktų skaičius laikantis API apribojimų.

Ką patikrinti savo paskyroje

1. Patvirtinkite dabartinį eksporto metodą

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

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

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

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 eksporte nurodyta įspėjimų arba klaidų.

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

3. Patikrinkite vieną paveiktą produktą

Jei vėluoja tik kai kurios 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 čia rodomus produktų duomenis, skaičiavimo ir eksporto informaciją, perskaitykite Produktų tikrintuvas: produktų duomenų, kainų skaičiavimų ir eksporto peržiūra.

Dažniausios lėtesnio publikavimo per API priežastys

Bendras katalogas padidėjo. Produktai iš visų prijungtų prekyviečių prisideda prie apimties, pagal kurią parenkamas eksporto intervalas.
Per vieną sinchronizavimą pasikeitė daug kainų. Dėl didesnio pakeitimų skaičiaus susidaro ilgesnė publikavimo eilė.
Prekyvietės API lėčiau apdoroja atnaujinimus. B2BLIX turi laukti prekyvietės API atsakymų ir laikytis jos atsako bei užklausų apribojimų.
API eksportas vis dar vykdomas. Skaičiavimas gali būti baigtas anksčiau, nei paskelbtas kiekvienas paruoštas atnaujinimas.
Išvesties formatas pakeistas į XML. Jei katalogas viršija 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 iš 220.lv, Pigu.lt ir Kaup24.ee. Bendras katalogas yra gerokai didesnis už produktų skaičių bet kurioje atskiroje prekyvietėje.

B2BLIX už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 kuriose prekyvietėse dar gali būti rodoma ankstesnė kaina, kol toliau apdorojami likę produktai.

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

Ką daryti toliau

Atidarykite Sinchronizavimo nustatymus ir patvirtinkite, ar pasirinkta API, ar XML išvestis.
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.
Kol dar gali būti apdorojamas esamas didelis eksportas, nekeiskite sinchronizavimo nustatymų pakartotinai.
Jei XML išvestis yra teisinga, tačiau labai didelio katalogo publikavimas per API nuolat vėluoja, susisiekite su B2BLIX ir aptarkite, ar galėtų būti tinkama speciali didelės apimties konfigūracija.

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