API-viennin rajoitukset, aikavälit ja suuren luettelon 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 nopeuteen vaikuttaa osittain käsiteltävien tuotteiden määrä. Pieni luettelo voidaan yleensä käsitellä useammin kuin luettelo, joka sisältää kymmeniä tai satoja tuhansia tuotteita.

Lyhyt vastaus

B2BLIX säätää API-viennin aikaväliä automaattisesti tilisi tuotteiden kokonaismäärän perusteella. Luettelon kasvaessa järjestelmä saattaa käyttää pidempää aikaväliä, jotta vienti voidaan käsitellä turvallisesti ja markkinapaikan API-rajoitusten puitteissa.

Tuotteiden määrä huomioidaan kaikissa yhdistetyissä Pigu Group -markkinapaikoissa, ei erikseen kunkin markkinapaikan osalta.

Jos luettelo kasvaa tuetun API-julkaisuprosessin kannalta liian suureksi, B2BLIX saattaa vaihtaa tulosteen takaisin muotoon XML. XML-laskennan tulokset voivat silti olla oikein, vaikka reaaliaikainen API-julkaisu viivästyisi tai ei olisi käytettävissä koko luettelolle.

Laskettu tai valmisteltu hinta ei välttämättä ole vielä käytössä markkinapaikassa. Hinta tulee voimaan vasta, kun se on viety, markkinapaikka on hyväksynyt sen ja se on otettu käyttöön markkinapaikassa. Tarkista synkronointiraportti, ennen kuin oletat lasketun hinnan onnistuneesti julkaistuksi.

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, ettei palvelu voi lähettää rajatonta määrää tuotepäivityksiä kerralla, vaikka monet hinnat olisivat valmiita julkaistaviksi.

Nämä rajoitukset auttavat suojaamaan markkinapaikan palvelua 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 luettelon koko, markkinapaikkojen määrä, markkinapaikan APIn vastausaika sekä julkaisujonossa odottavien päivitysten määrä.

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

Miten luettelon koko muuttaa vientiväliä?

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

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

• Pienempi luettelo voi käyttää lyhyempää API-vientiväliä.
• Kun tuotteiden kokonaismäärä kasvaa, B2BLIX valitsee automaattisesti pidemmän aikavälin.
• Kokonaismäärä sisältää tuotteet kaikista yhdistetyistä Pigu Group -markkinapaikoista.
• Erittäin suurten luetteloiden jokaisen julkaisujonon käsittely voi vaatia enemmän aikaa.
• Jos luettelo ylittää tuetun API-määrän, tuloste voidaan vaihtaa XML-muotoon.

Pidempi aikaväli ei välttämättä tarkoita virhettä. Se voi olla odotettu tulos, kun käsitellään suurempaa tuotemäärää 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.
Sivun kentät on kuvattu tarkemmin oppaassa Synkronointiasetukset: tuotetuonnin ja hintaviennin määrittäminen.

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

2. Tarkista viimeisin synkronointiraportti

Synkronointiraportin avulla voit erottaa laskennan ja julkaisun toisistaan. Tarkista, valmistuiko viimeisin suoritus, kuinka monta tuotetta käsiteltiin ja ilmoittiko vienti varoituksista tai virheistä.

Voit tarkistaa tämän tililtäsi avaamalla Synkronointiraportit.
Raporttien tilat ja kohdeyhteenvedot on kuvattu tarkemmin oppaassa Synkronointiraportit: tuonnin, BuyBox-laskennan ja vientitulosten tarkastelu.

3. Tarkista yksi ongelmallinen tuote

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

Voit tarkistaa tämän tililtäsi avaamalla Product Checkerin.
Product Checkerissä näkyvät tuotetiedot, laskenta- ja vientitiedot on kuvattu tarkemmin oppaassa Product Checker: tuotetietojen, hintalaskelmien ja vientien tarkastelu.

API-julkaisun hidastumisen yleisiä syitä

• Luettelon kokonaiskoko on kasvanut. Kaikkien yhdistettyjen markkinapaikkojen tuotteet vaikuttavat vientivälin valinnassa käytettävään määrään.
• Samassa synkronoinnissa muuttui suuri määrä hintoja. Useammat muutokset kasvattavat 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 luettelo ylittää tuetun API-määrän, suoran API-julkaisun sijaan voidaan käyttää XML:ää.
• Tarkistettiin vain reaaliaikainen markkinapaikkahinta. Tarkista Synkronointiraportit ja Product Checker selvittääksesi, tapahtuiko viive laskennan, viennin vai markkinapaikassa käyttöönoton aikana.

Esimerkki

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

B2BLIX viimeistelee BuyBox-laskelmat ja valmistelee päivitetyt hinnat. Koska yhdistetty luettelo on suuri, API-viennissä käytetään pidempää käsittelyväliä ja päivitykset julkaistaan jonossa. Joissakin markkinapaikoissa näkyvissä hinnoissa voi siksi edelleen olla aiempi arvo, kun myöhempiä tuotteita vielä käsitellään.

Myyjän kannattaa ensin tarkistaa viimeisin synkronointiraportti. Yksittäisen viivästyneen tuotteen kohdalla myyjä voi sen jälkeen käyttää Product Checkeriä vertaillakseen tuotteen laskettua hintaa ja vientitilaa.

Mitä seuraavaksi?

1. Avaa Synkronointiasetukset ja vahvista, onko valittu tulostemuoto API vai XML.
2. Tarkista lähteeseesi sisältyvien tuotteiden kokonaismäärä kaikissa markkinapaikoissa.
3. Avaa viimeisin synkronointiraportti ja tarkista sen käsittely- ja vientitulokset.
4. Käytä Product Checkeriä yhden tai useamman ongelmallisen EANin tarkistamiseen.
5. Älä muuta synkronointiasetuksia toistuvasti, jos suuri vienti saattaa olla vielä käynnissä.
6. Jos XML-tuloste on oikein, mutta API-julkaisu viivästyy jatkuvasti erittäin suuressa luettelossa, ota yhteyttä B2BLIXiin ja keskustele, voisiko erillinen suuren volyymin ratkaisu olla tarkoituksenmukainen.

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