Salta al contingut principal
Shopee Marketplace Connector

Posada en marxa de Shopee Marketplace Connector (APAC) a Odoo: camps, mapatges i primera setmana

Per posar en marxa Shopee Marketplace Connector (APAC) crees a Odoo un compte de marketplace amb la seva empresa, el seu magatzem, el Partner ID / App Key, el Shop ID i la Partner Key de la teva app de Shopee, tries l'entorn i fixes des de quin moment les comandes es converteixen en pressupostos. Després relaciones categories i atributs d'Odoo amb els de Shopee i, la primera setmana, revises els registres de sincronització, els conflictes i la cua. Aquí tens els passos en ordre i què vol dir cada camp.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Què has de tenir preparat abans d'obrir Odoo

El compte de marketplace del mòdul demana dades que vénen de Shopee i dades que vénen de la teva pròpia organització. És millor tenir-les juntes abans de començar:

  • El partner_id de la teva app de Shopee i la seva partner key, que trobes a Shopee Open Platform > App list.
  • El shop_id de la botiga que connectaràs.
  • Si vols provar primer, el partner ID i la clau de prova de la teva app i una botiga de prova de Shopee.
  • L'empresa d'Odoo que serà propietària del compte i el magatzem des del qual sincronitzaràs l'inventari.
  • Les adreces de correu que han de rebre els avisos.

El mòdul es publica a Odoo Apps per a 17, 18, 19 i 20 i, segons la fitxa de cada versió, és gratuït en totes (pagament únic per versió, sense IVA). El tens a la fitxa d'Odoo Apps i a la pàgina del mòdul.

Passos per donar d'alta el compte de Shopee

Cada pas correspon a un camp del compte de marketplace. Els noms van tal com apareixen al mòdul.

  1. Escriu l'Account Name, el nom del compte.
  2. Tria la Company. El mòdul aïlla els comptes per empresa: cada empresa és propietària de les seves configuracions de marketplace.
  3. Indica el Default Fulfillment Warehouse. És el magatzem per defecte per a la sincronització d'inventari i es pot canviar producte a producte.
  4. Selecciona el Shopee Environment. Amb Sandbox s'utilitzen el partner ID i la clau de prova de la teva app i les botigues de prova de Shopee.
  5. Omple Partner ID / App Key amb el partner_id de Shopee i Shop ID amb el shop_id de la teva botiga.
  6. Enganxa a Partner Key la partner key de la teva app. Segons la descripció del camp, és la que signa cada crida.
  7. Fes servir l'enllaç Connect Shopee shop. El mòdul desa a Authorization State un valor aleatori de l'últim enllaç generat i el comprova quan Shopee retorna el venedor. El compte té, a més, els camps OAuth Access Token, OAuth Refresh Token i Access Token Expires.
  8. Fixa Create Sales Orders From. Les comandes fetes a Shopee abans d'aquell moment queden retingudes (Held Orders) en lloc de convertir-se en pressupostos.
  9. Ajusta Sync Frequency (minutes), l'interval de consulta per a comandes i inventari, entre 5 i 60 minuts.
  10. Posa un Low Stock Threshold (units): per sota d'aquest nivell el mòdul llança un avís d'estoc baix. Si a més marques Auto-Create PO on Low Stock, crea un esborrany de comanda de compra quan l'estoc baixa per sota del llindar.
  11. Escriu a Alert Email Recipients les adreces separades per comes que rebran les alertes de sincronització, el resum i les notificacions d'error.
  12. Tria l'estratègia d'Auto-Conflict Resolution per als conflictes detectats i el Conflict Detection Threshold (%), el percentatge de diferència a partir del qual es detecta un conflicte.
  13. Amb tot l'anterior revisat, marca Enable Sync, que activa o desactiva totes les sincronitzacions del compte.

El camp API Key apareix al compte, però la seva pròpia descripció indica que Shopee no l'utilitza.

Relacionar categories, atributs i productes

El compte té tres relacions entre Odoo i Shopee: Category Mappings, Attribute Mappings i Product Mappings.

Categories

A Category Mappings relaciones una categoria d'Odoo amb una de Shopee. Cada línia porta Marketplace Account, Odoo Category, Marketplace Category ID (el category_id de Shopee) i Marketplace Category Name, un nom llegible que el mòdul desa per mostrar-lo a la pantalla. La columna Created registra quan es va crear la línia.

Llista de mapatges de categories amb les columnes Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name i Created
La llista de mapatges de categories, encara sense registres, amb el botó Nou i la barra de cerca.

Atributs

A Attribute Mappings relaciones un atribut d'Odoo (Odoo Attribute, per exemple color, talla o marca) amb la clau d'atribut del marketplace a Marketplace Attribute Key. Cada línia també porta el seu Marketplace Account i la seva data Created.

Productes

A Product Mappings hi queden les relacions entre cada producte d'Odoo i el seu ID de producte al marketplace. A la seqüència següent es veu un registre d'exemple del compte Shopee SG amb l'estat Synced.

Llista de mapatges de producte amb un registre de Shopee SG en estat Synced, llista de comptes de marketplace i llista buida de mapatges d'atributs
Recorregut pel mapatge de producte d'exemple, la llista de comptes amb dades de prova i la llista de mapatges d'atributs, encara sense registres.

Si vols veure com encaixen aquestes peces per dins, ho expliquem a com funciona el connector per dins.

Què revisar la primera setmana

Amb la sincronització activada, aquests són els punts del compte que val la pena mirar cada dia al principi:

  • Sync Logs: el registre d'auditoria de les interaccions amb l'API.
  • Sync Conflicts: els conflictes detectats que esperen resolució. Revisa els conflictes pendents i ajusta l'estratègia d'Auto-Conflict Resolution o el Conflict Detection Threshold (%) si cal.
  • Sync Queue: la cua interna de tasques de sincronització asíncrones.
  • Comandes retingudes: si veus comandes a Held Orders, comprova que la data de Create Sales Orders From és la que volies.
  • Token: revisa la data d'Access Token Expires al compte.
  • Estoc baix: si vas activar Auto-Create PO on Low Stock, busca els esborranys de comanda de compra i confirma que el Low Stock Threshold (units) té sentit per als teus productes.
  • Correu: confirma que les adreces d'Alert Email Recipients estan ben escrites i separades per comes.

El mòdul inclou també llistes de resum i d'informe de rendiment. A les captures encara apareixen sense dades:

Llista de resum del tauler de marketplace amb les columnes Company, Total Reve…, Total Or…, Critical… i Major E…
La llista de resum del tauler, encara sense dades.
Llista d'informes de rendiment amb les columnes Company, Marketplace, Product Category, Date From i Date To
La llista d'informes de rendiment, encara sense registres.

Si aquells dies apareix un missatge que no entens, tens els textos literals i com resoldre'ls a els missatges d'error del connector.

Com t'ajuda FlexigoTech

A FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida. Si vols que revisem la configuració del compte de Shopee, els mapatges o una integració que el mòdul no cobreix, pots escriure'ns des de la pàgina del mòdul.

Continua llegint

Errors de Shopee Marketplace Connector (APAC): quan surt cada missatge i què ferQuè vol dir cada missatge d'error de Shopee Marketplace Connector (APAC) a Odoo, quan surt i què has de fer, amb un cas inventat i els textos literals.Com funciona Leroy Merlin Connector a Odoo: menús, accions planificades i recorregutQuins menús afegeix Leroy Merlin Connector a Odoo, quines deu accions planificades s'executen i cada quant, i què passa per FlexigoTech Cloud.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts