Marketplace Catalog Sync

• Rakentaa myyjäyhdistimen, jonka täytyy lähettää uusia SKU-yksiköitä VTEX-markkinapaikalle ja hallita ehdotuksen (lähetys → odottaa → hyväksytty/hylätty) elinkaarta.
• Toteuttaa Change Notification -työnkulun, jolla havaitaan, onko SKU jo olemassa markkinapaikalla (200 OK) vai tarvitaanko uusi ehdotus (404 Not Found).
• Synkronoi hinta- ja varastomuutokset /notificator/{sellerId}/changenotification/{sellerSkuId}/price- ja /inventory-päätepisteiden kautta.
• Toteuttaa myyjäpuolen Fulfillment Simulation -päätepiste (POST /pvt/orderForms/simulation), jonka täytyy vastata 2,5 sekunnin kuluessa.

• Suoritat marketplace-puolen kataloogioperaatioita, kuten suoria POST /api/catalog/pvt/product- tai POST /api/catalog/pvt/stockkeepingunit-kirjoituksia — ne eivät ole myyjä-yhdistinvirtoja.
• Tarvitset tilausten täyttämiseen tai laskujen käsittelyyn liittyvää logiikkaa (katso sen sijaan marketplace-fulfillment-taito).
• Tarvitset nopeuden rajoittamisen malleja erikseen, irrotettuna katalogin ilmoitusvirroista (katso sen sijaan marketplace-rate-limiting-taito).

Myyjäliittimien on käytettävä POST .../changenotification/{sellerId}/{sellerSkuId} — ei yksisegmenttistä changenotification/{skuId}-reittiä, joka odottaa markkinapaikan VTEX SKU ID:tä. Tämä taito dokumentoi eron näiden kahden reitin välillä, selittää miksi viralliset dokumentaatiot toisinaan sekoittavat nämä kaksi reittiä keskenään, ja tarjoaa konkreettisia TypeScript-esimerkkejä sekä 200 (päivitys)- että 404 (uusi ehdotus) -vastauspolkuja varten.

Uudet SKU:t on käytävä läpi ehdotus-/hyväksyntätyönkulun kautta PUT https://api.vtex.com/{accountName}/suggestions/{sellerId}/{sellerSkuId} — suorat Catalog API -kirjoitukset ovat kiellettyjä ulkoisille myyjille ja palauttavat virheen 403 Forbidden. Toiminto pakottaa tilantarkistuksen ennen jokaista ehdotuspäivitystä, koska ehdotuksia voidaan muokata vain Pending-tilassa; hyväksyttyjä tai hylättyjä ehdotuksia ei voi muuttaa.

Hinta- ja varastopäivitykset lähetetään erillisten POST /notificator/{sellerId}/changenotification/{sellerSkuId}/price- ja .../inventory-päätepisteiden kautta, joissa polun segmentti on myyjän SKU-tunnus (ei markkinapaikan VTEX SKU-tunnusta). Näiden ilmoitusten jälkeen markkinapaikka kutsuu myyjän Fulfillment Simulation -päätepistettä hakemaan ajantasaiset tiedot.

Marketplace kutsuu myyjän POST /pvt/orderForms/simulation -päätepistettä jokaisen hinta- tai varastopäivitysilmoituksen jälkeen. VTEX odottaa vastausta enintään 2,5 sekuntia; tämän rajan ylittäminen merkitsee tuotteen ei-saatavilla olevaksi verkkokaupassa. Tämä taito tarjoaa välimuisti ensin -toteutusmallin (muistissa tai Redis), jotta päätepiste vastaa alle 50 ms:ssä.

Massalähetysten lähettäminen Change Notification -pyyntöjä ilman hidastusta laukaisee 429-vastauksia, jotka estävät myyjän koko API-pääsyn. Tämä taito tarjoaa erissä käsitellyn, rinnakkaisuuden hallitun ilmoitussilmukan eräkohtaisilla viiveillä, retry-after-otsikon jäsentämisellä ja eksponentiaalisella peruutuksella 429-virheiden varalta.

Catalog System -reitit (esim. changenotification) käyttävät kaupan isäntänimeä ({account}.vtexcommercestable.com.br), kun taas SKU Suggestion -reitit käyttävät osoitetta https://api.vtex.com/{accountName}. Molemmissa pinnoissa todennus tapahtuu samoilla X-VTEX-API-AppKey- ja X-VTEX-API-AppToken-otsikoilla. Taito tarjoaa tyypitetyn SellerConnectorConfig-määrityksen sekä Axios-asiakastehdasfunktion, joka kattaa molemmat perus-URL-osoitteet.

Myyjä yhdistää VTEX-markkinapaikkaan ensimmäistä kertaa ja tarvitsee koko SKU-kataloginsA rekisteröinnin. Integraatio kutsuu changenotification/{sellerId}/{sellerSkuId} -päätepistettä jokaisen SKU:n kohdalla; jokainen 404-vastaus käynnistää PUT SKU Suggestion -kutsun, joka sijoittaa kunkin SKU:n markkinapaikan odottavaan tarkistusjonoon operaattorin hyväksyntää varten.

Myyjän varastojärjestelmä lähettää hinta- tai varastomuutostapahtumia. Yhdistin lähettää erämuodossa hinta- ja varastosaldon ilmoituksia /notificator/-päätepisteiden kautta, ja myyjän Fulfillment Simulation -päätepiste — jota tukee esilämmitetty välimuisti — vastaa markkinapaikan kyselyihin 2,5 sekunnin määräajan puitteissa.

Operaattorin on päivitettävä tuotetiedot ehdotukseen, joka on lähetetty mutta jota ei ole vielä tarkasteltu. Integraatio kutsuu ensin GET /suggestions/{sellerId}/{sellerSkuId} -päätepistettä vahvistaakseen, että ehdotus on edelleen Pending-tilassa, minkä jälkeen se lähettää PUT-pyynnön korjatuilla tiedoilla. Jo hyväksytyt tai hylätyt ehdotukset ohitetaan varoituksen kera.

Tuotetietojen migraation jälkeen sadat SKU-koodit tarvitsevat uudelleenilmoituksen. Integraatio käyttää eräilmoitusmallia — käsittelee SKU-koodeja viiden ryhmissä 200 ms:n eräväleillä ja 429-tietoisella uudelleenyrityslogiikalla — ilmoittaakseen markkinapaikalle uudelleen ilman, että nopeusrajaesteitä laukeaa.