API-viennin rajoitukset, vientivälit ja suurten tuoteluetteloiden viiveet

Miksi API-hintapäivitykset voivat kestää kauemmin?

Tämä artikkeli koskee tilanteita, joissa B2BLIX on laskenut uudet hinnat, mutta muutokset näkyvät Pigu-palvelussa, 220.lv:ssä, Kaup24.ee:ssä tai HobbyHall.fi:ssä odotettua myöhemmin.

API-julkaisun nopeus riippuu osittain käsiteltävien tuotteiden määrästä. Pieni tuoteluettelo voidaan yleensä käsitellä useammin kuin tuoteluettelo, joka sisältää kymmeniä tai satoja tuhansia tuotteita.

Lyhyt vastaus

B2BLIX säätää API-vientivälin automaattisesti tililläsi olevien tuotteiden kokonaismäärän mukaan. Tuoteluettelon kasvaessa järjestelmä voi käyttää pidempää vientiväliä, jotta vienti voidaan käsitellä turvallisesti markkinapaikan API-rajojen puitteissa.

Tuotteiden määrä lasketaan kaikista yhdistetyistä Pigu Group -markkinapaikoista, ei erikseen jokaiselta markkinapaikalta.

Jos tuoteluettelo kasvaa tuetun API-julkaisuprosessin kannalta liian suureksi, B2BLIX voi vaihtaa tulosteen takaisin muotoon XML. XML-laskentatulokset voivat silti olla oikein, vaikka reaaliaikainen API-julkaisu olisi viivästynyt tai koko tuoteluettelon osalta tilapäisesti poissa käytöstä.

Laskettu tai valmisteltu hinta ei välttämättä ole vielä aktiivinen markkinapaikalla. Hinta tulee aktiiviseksi vasta, kun se on viety, markkinapaikka on hyväksynyt sen ja se on otettu käyttöön. Tarkista synkronointiraportti ennen kuin oletat, että laskettu hinta on julkaistu onnistuneesti.

Miten API-pyyntöjen rajoitukset vaikuttavat vientiin?

Pigu soveltaa APIinsa pyyntörajoituksia. Sen API-dokumentaatiossa on esimerkiksi kuvattu tarjouspäivitysprosessille rajoitus, joka on 500 pyyntöä 10 sekunnissa.

B2BLIX noudattaa markkinapaikan API-rajoituksia. Tämä tarkoittaa, että palvelu ei voi lähettää rajatonta määrää tuotepäivityksiä kerralla, vaikka monet hinnat olisivat valmiita julkaistaviksi.

Nämä rajoitukset auttavat suojaamaan markkinapaikkapalvelua liialliselta liikenteeltä. Ne eivät tarkoita, että jokainen tili voisi aina julkaista 500 tuotemuutosta 10 sekunnin välein. Todelliseen käsittelyaikaan voivat vaikuttaa myös tuoteluettelon koko, markkinapaikkojen määrä, markkinapaikan APIn vastausaika ja julkaisujonossa odottavien päivitysten määrä.

Markkinapaikan API-rajoitukset voivat muuttua. Ajantasaisia pyyntörajoituksia määritettäessä ensisijaisena lähteenä tulee käyttää Pigu API -dokumentaatiota.

Miten tuoteluettelon koko muuttaa vientiväliä?

B2BLIX käyttää tuotemäärän vaihteluvälejä sopivan API-vientivälin määrittämiseen. Tarkkoja sisäisiä raja-arvoja ei julkaista, koska niitä voidaan muuttaa palvelun ja markkinapaikkaintegraatioiden kehittyessä.

Käytännössä prosessi toimii seuraavasti:

Pienempi tuoteluettelo voi käyttää lyhyempää API-vientiväliä.
Kun tuotteiden kokonaismäärä kasvaa, B2BLIX valitsee automaattisesti pidemmän vientivälin.
Kokonaismäärään sisältyvät kaikkien yhdistettyjen Pigu Group -markkinapaikkojen tuotteet.
Erittäin suuret tuoteluettelot voivat vaatia enemmän aikaa jokaisen julkaisujonon käsittelyyn.
Jos tuoteluettelo ylittää tuetun API-määrän, tuloste voidaan vaihtaa XML-muotoon.

Pidempi vientiväli ei välttämättä tarkoita virhettä. Se voi olla odotettu seuraus suuremman tuotemäärän käsittelystä API-rajoituksia noudattaen.

Mitä tililtä kannattaa tarkistaa?

1. Vahvista nykyinen vientitapa

Tarkista, onko tilisi määritetty julkaisemaan hinnat API:n kautta vai luomaan XML-tuloste. Tarkista myös määritetty synkronointitiheys ja päivitysasetukset.

Voit tarkistaa tämän tililtäsi avaamalla synkronointiasetukset.
Lisätietoja kyseisen sivun kentistä on ohjeessa Synkronointiasetukset: tuotetuonnin ja hintaviennin määrittäminen.

Ennen kuin muutat vientitapaa tai -tiheyttä, tarkista lähteesi nykyinen tuotemäärä ja se, sisältääkö sama lähde tuotteita useille markkinapaikoille.

2. Tarkista uusin synkronointiraportti

Synkronointiraportin avulla voit erottaa laskennan ja julkaisun toisistaan. Tarkista, onko viimeisin suoritus valmistunut, kuinka monta tuotetta käsiteltiin ja ilmoitettiinko viennissä varoituksia tai virheitä.

Voit tarkistaa tämän tililtäsi avaamalla synkronointiraportit.
Raportin tiloista ja kohteiden yhteenvedoista kerrotaan ohjeessa Synkronointiraportit: tuonnin, BuyBox-laskennan ja vientitulosten tarkistaminen.

3. Tarkista yksi ongelmallinen tuote

Jos vain joidenkin hintojen näkyminen viivästyy, tarkista tietty EAN Product Checkerissä. Näin voit varmistaa kyseisen tuotteen lasketun hinnan ja viimeisimmän tunnetun vientitilan.

Voit tarkistaa tämän tililtäsi avaamalla Product Checkerin.
Product Checkerissä näkyvistä tuote-, laskenta- ja vientitiedoista kerrotaan ohjeessa Product Checker: tuotetietojen, hintalaskelmien ja vientien tarkistaminen.

API-julkaisun hidastumisen yleisiä syitä

Tuoteluettelon kokonaiskoko on kasvanut. Kaikkien yhdistettyjen markkinapaikkojen tuotteet vaikuttavat vientivälin valintaan käytettävään määrään.
Samassa synkronoinnissa muuttui suuri määrä hintoja. Muutosten suurempi määrä kasvattaa julkaisujonoa.
Markkinapaikan API käsittelee päivityksiä hitaammin. B2BLIXin on odotettava markkinapaikan APIn vastauksia ja noudatettava sen pyyntörajoituksia.
API-vienti on edelleen käynnissä. Laskenta on voinut valmistua ennen kuin kaikki valmistellut päivitykset on julkaistu.
Tuloste vaihdettiin XML-muotoon. Jos tuoteluettelo ylittää tuetun API-määrän, suoran API-julkaisun sijaan voidaan käyttää XML:ää.
Tarkistettiin vain aktiivinen markkinapaikkahinta. Tarkista synkronointiraportit ja Product Checker selvittääksesi, tapahtuiko viive laskennan, viennin vai markkinapaikan käyttöönoton aikana.

Esimerkki

Myyjä tuo tuotteita 220.lv:hen, Pigu.lt:hen ja Kaup24.ee:hen. Yhdistetty tuoteluettelo on huomattavasti suurempi kuin minkään yksittäisen markkinapaikan tuotemäärä.

B2BLIX suorittaa BuyBox-laskennat ja valmistelee päivitetyt hinnat. Koska yhdistetty tuoteluettelo on suuri, API-vienti käyttää pidempää käsittelyväliä ja päivitykset julkaistaan jonossa. Joidenkin tuotteiden aktiivisissa markkinapaikkahinnoissa voi siksi edelleen näkyä edellinen arvo, kun myöhempiä tuotteita vielä käsitellään.

Myyjän kannattaa ensin tarkistaa uusin synkronointiraportti. Yksittäisen viivästyneen tuotteen kohdalla myyjä voi sen jälkeen verrata Product Checkerissä laskettua hintaa tuotteen vientitilaan.

Mitä seuraavaksi?

Avaa synkronointiasetukset ja vahvista, onko valittu tulostemuoto API vai XML.
Tarkista lähteeseesi sisältyvien tuotteiden kokonaismäärä kaikilla markkinapaikoilla.
Avaa uusin synkronointiraportti ja tarkista sen käsittely- ja vientitulokset.
Käytä Product Checkeriä yhdelle tai useammalle ongelmalliselle EANille.
Älä muuta synkronointiasetuksia toistuvasti, kun suuri vienti saattaa vielä olla käynnissä.
Jos XML-tuloste on oikein, mutta API-julkaisu viivästyy jatkuvasti erittäin suuren tuoteluettelon kohdalla, ota yhteyttä B2BLIXiin ja keskustele siitä, voisiko erillinen suuren volyymin ratkaisu olla tarkoituksenmukainen.

Kun ilmoitat jatkuvasta viiveestä, kerro tuotteiden arvioitu kokonaismäärä, viiveen koskemat markkinapaikat, kyseisen synkronoinnin ajankohta ja muutama esimerkki-EAN. Älä ilmoita tilisi salasanoja tai API-tunnistetietoja.