Naar hoofdinhoud
Shopee Marketplace Connector

Shopee Marketplace Connector (APAC) instellen in Odoo: velden, koppelingen en de eerste week

Om Shopee Marketplace Connector (APAC) in gebruik te nemen maak je in Odoo een marketplace-account aan met het bedrijf, het magazijn, de Partner ID / App Key, de Shop ID en de Partner Key van je Shopee-app, kies je de omgeving en leg je vast vanaf welk moment orders offertes worden. Daarna koppel je Odoo-categorieën en -attributen aan die van Shopee en controleer je in de eerste week de synchronisatielogs, de conflicten en de wachtrij. Hieronder vind je de stappen op volgorde en wat elk veld betekent.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de module, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

Wat je klaar moet hebben voordat je Odoo opent

Het marketplace-account van de module vraagt om gegevens van Shopee en gegevens uit je eigen organisatie. Het helpt om ze vooraf bij elkaar te zetten:

  • De partner_id van je Shopee-app en de bijbehorende partner key, te vinden onder Shopee Open Platform > App list.
  • De shop_id van de winkel die je gaat koppelen.
  • Wil je eerst testen: de test-partner-ID en testsleutel van je app en een testwinkel van Shopee.
  • Het Odoo-bedrijf dat eigenaar wordt van het account en het magazijn van waaruit je de voorraad synchroniseert.
  • De e-mailadressen die de meldingen moeten ontvangen.

De module staat in Odoo Apps voor 17, 18, 19 en 20 en is volgens de pagina van elke versie in alle versies gratis (eenmalige betaling per versie, excl. btw). Je vindt hem op de pagina in Odoo Apps en op de modulepagina.

Stappen om het Shopee-account aan te maken

Elke stap hoort bij een veld van het marketplace-account. De namen staan zoals ze in de module verschijnen.

  1. Vul de Account Name in, de naam van het account.
  2. Kies de Company. De module scheidt accounts per bedrijf: elk bedrijf is eigenaar van zijn eigen marketplace-configuraties.
  3. Geef het Default Fulfillment Warehouse op. Dit is het standaardmagazijn voor de voorraadsynchronisatie en je kunt het per product aanpassen.
  4. Selecteer de Shopee Environment. Met Sandbox gebruik je de test-partner-ID en testsleutel van je app en de testwinkels van Shopee.
  5. Vul bij Partner ID / App Key de partner_id van Shopee in en bij Shop ID de shop_id van je winkel.
  6. Plak de partner key van je app in Partner Key. Volgens de veldbeschrijving ondertekent die elke aanroep.
  7. Gebruik de link Connect Shopee shop. De module slaat in Authorization State een willekeurige waarde van de laatst gegenereerde link op en controleert die wanneer Shopee de verkoper terugstuurt. Het account heeft daarnaast de velden OAuth Access Token, OAuth Refresh Token en Access Token Expires.
  8. Stel Create Sales Orders From in. Orders die vóór dat moment in Shopee zijn geplaatst, worden vastgehouden (Held Orders) in plaats van offertes te worden.
  9. Pas Sync Frequency (minutes) aan, het opvraaginterval voor orders en voorraad, tussen 5 en 60 minuten.
  10. Stel een Low Stock Threshold (units) in: onder dat niveau geeft de module een melding van lage voorraad. Vink je ook Auto-Create PO on Low Stock aan, dan maakt de module een concept-inkooporder aan zodra de voorraad onder de drempel zakt.
  11. Vul in Alert Email Recipients de door komma's gescheiden adressen in die de synchronisatiemeldingen, de samenvatting en de foutmeldingen ontvangen.
  12. Kies de strategie voor Auto-Conflict Resolution bij gedetecteerde conflicten en de Conflict Detection Threshold (%), het verschilpercentage vanaf waar een conflict wordt gedetecteerd.
  13. Heb je alles hierboven gecontroleerd, vink dan Enable Sync aan. Daarmee zet je alle synchronisaties van het account aan of uit.

Het veld API Key staat op het account, maar volgens de eigen beschrijving gebruikt Shopee het niet.

Categorieën, attributen en producten koppelen

Het account kent drie koppelingen tussen Odoo en Shopee: Category Mappings, Attribute Mappings en Product Mappings.

Categorieën

In Category Mappings koppel je een Odoo-categorie aan een Shopee-categorie. Elke regel bevat Marketplace Account, Odoo Category, Marketplace Category ID (de category_id van Shopee) en Marketplace Category Name, een leesbare naam die de module opslaat om op het scherm te tonen. De kolom Created legt vast wanneer de regel is aangemaakt.

Lijst met categoriekoppelingen met de kolommen Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name en Created
De lijst met categoriekoppelingen, nog zonder records, met de knop Nieuw en de zoekbalk.

Attributen

In Attribute Mappings koppel je een Odoo-attribuut (Odoo Attribute, bijvoorbeeld kleur, maat of merk) aan de attribuutsleutel van de marketplace in Marketplace Attribute Key. Elke regel heeft ook een Marketplace Account en een Created-datum.

Producten

In Product Mappings staan de koppelingen tussen elk Odoo-product en zijn product-ID op de marketplace. In de volgende reeks zie je een voorbeeldrecord van het account Shopee SG met status Synced.

Lijst met productkoppelingen met een record van Shopee SG in status Synced, lijst met marketplace-accounts en lege lijst met attribuutkoppelingen
Rondgang langs de voorbeeldkoppeling van een product, de accountlijst met testgegevens en de lijst met attribuutkoppelingen, nog zonder records.

Wil je zien hoe deze onderdelen onder de motorkap samenhangen, dan leggen we dat uit in hoe de connector intern werkt.

Wat je de eerste week controleert

Met de synchronisatie aan zijn dit de onderdelen van het account die je in het begin het best dagelijks bekijkt:

  • Sync Logs: het auditlog van de interacties met de API.
  • Sync Conflicts: de gedetecteerde conflicten die op een oplossing wachten. Bekijk de openstaande conflicten en pas zo nodig de strategie van Auto-Conflict Resolution of de Conflict Detection Threshold (%) aan.
  • Sync Queue: de interne wachtrij met asynchrone synchronisatietaken.
  • Vastgehouden orders: zie je orders in Held Orders, controleer dan of de datum bij Create Sales Orders From de datum is die je bedoelde.
  • Token: controleer de datum van Access Token Expires op het account.
  • Lage voorraad: heb je Auto-Create PO on Low Stock aangezet, zoek dan de concept-inkooporders op en kijk of de Low Stock Threshold (units) klopt voor je producten.
  • E-mail: controleer of de adressen in Alert Email Recipients goed gespeld zijn en door komma's gescheiden.

De module bevat ook overzichtslijsten en lijsten met prestatierapporten. Op de schermafbeeldingen staan ze nog zonder gegevens:

Overzichtslijst van het marketplace-dashboard met de kolommen Company, Total Reve…, Total Or…, Critical… en Major E…
De overzichtslijst van het dashboard, nog zonder gegevens.
Lijst met prestatierapporten met de kolommen Company, Marketplace, Product Category, Date From en Date To
De lijst met prestatierapporten, nog zonder records.

Krijg je in die dagen een melding die je niet begrijpt, dan vind je de letterlijke teksten en de oplossing in de foutmeldingen van de connector.

Hoe FlexigoTech je helpt

Bij FlexigoTech implementeren we Odoo 17, 18, 19 en 20 en ontwikkelen we connectoren en integraties op maat. Wil je dat we de configuratie van je Shopee-account, je koppelingen of een integratie die de module niet dekt nalopen, neem dan contact op via de modulepagina.

Lees verder

Foutmeldingen van Shopee Marketplace Connector (APAC): wanneer je ze ziet en wat je doetWat elke foutmelding van Shopee Marketplace Connector (APAC) in Odoo betekent, wanneer je hem ziet en wat je doet, met een verzonnen case en de letterlijke teksten.Hoe Leroy Merlin Connector werkt in Odoo: menu's, geplande acties en rondleidingWelke menu's Leroy Merlin Connector aan Odoo toevoegt, welke tien geplande acties draaien en hoe vaak, en wat via FlexigoTech Cloud loopt.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen