Vai al contenuto principale
Shopee Marketplace Connector

Avviare Shopee Marketplace Connector (APAC) in Odoo: campi, mappature e prima settimana

Per avviare Shopee Marketplace Connector (APAC) crei in Odoo un account marketplace con la sua azienda, il suo magazzino, il Partner ID / App Key, lo Shop ID e la Partner Key della tua app Shopee, scegli l'ambiente e stabilisci da quale momento gli ordini diventano preventivi. Poi colleghi categorie e attributi di Odoo a quelli di Shopee e, la prima settimana, controlli i log di sincronizzazione, i conflitti e la coda. Qui trovi i passaggi in ordine e il significato di ogni campo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Cosa preparare prima di aprire Odoo

L'account marketplace del modulo chiede dati che arrivano da Shopee e dati della tua organizzazione. Conviene averli tutti a portata di mano prima di iniziare:

  • Il partner_id della tua app Shopee e la sua partner key, che trovi in Shopee Open Platform > App list.
  • Lo shop_id del negozio che vuoi collegare.
  • Se vuoi fare prima una prova, il partner ID e la chiave di test della tua app e un negozio di test di Shopee.
  • L'azienda Odoo a cui farà capo l'account e il magazzino da cui sincronizzerai l'inventario.
  • Gli indirizzi e-mail che devono ricevere gli avvisi.

Il modulo è pubblicato su Odoo Apps per le versioni 17, 18, 19 e 20 e, secondo la scheda di ogni versione, è gratuito in tutte (pagamento una tantum per versione, IVA esclusa). Lo trovi nella scheda di Odoo Apps e nella pagina del modulo.

Passaggi per creare l'account Shopee

Ogni passaggio corrisponde a un campo dell'account marketplace. I nomi sono riportati esattamente come compaiono nel modulo.

  1. Scrivi l'Account Name, il nome dell'account.
  2. Scegli la Company. Il modulo separa gli account per azienda: ogni azienda ha le proprie configurazioni marketplace.
  3. Indica il Default Fulfillment Warehouse. È il magazzino predefinito per la sincronizzazione dell'inventario e si può cambiare prodotto per prodotto.
  4. Seleziona lo Shopee Environment. Con Sandbox si usano il partner ID e la chiave di test della tua app e i negozi di test di Shopee.
  5. Compila Partner ID / App Key con il partner_id di Shopee e Shop ID con lo shop_id del tuo negozio.
  6. Incolla in Partner Key la partner key della tua app. Secondo la descrizione del campo, è quella che firma ogni chiamata.
  7. Usa il link Connect Shopee shop. Il modulo salva in Authorization State un valore casuale dell'ultimo link generato e lo verifica quando Shopee rimanda indietro il venditore. L'account ha inoltre i campi OAuth Access Token, OAuth Refresh Token e Access Token Expires.
  8. Imposta Create Sales Orders From. Gli ordini fatti su Shopee prima di quel momento restano trattenuti (Held Orders) invece di diventare preventivi.
  9. Regola Sync Frequency (minutes), l'intervallo di interrogazione per ordini e inventario, tra 5 e 60 minuti.
  10. Imposta una Low Stock Threshold (units): sotto quel livello il modulo invia un avviso di giacenza bassa. Se spunti anche Auto-Create PO on Low Stock, crea una bozza di ordine di acquisto quando la giacenza scende sotto la soglia.
  11. Inserisci in Alert Email Recipients gli indirizzi separati da virgole che riceveranno gli avvisi di sincronizzazione, il riepilogo e le notifiche di errore.
  12. Scegli la strategia di Auto-Conflict Resolution per i conflitti rilevati e la Conflict Detection Threshold (%), la percentuale di differenza oltre la quale viene rilevato un conflitto.
  13. Dopo aver controllato tutto quanto sopra, spunta Enable Sync, che attiva o disattiva tutte le sincronizzazioni dell'account.

Il campo API Key compare nell'account, ma la sua stessa descrizione indica che Shopee non lo usa.

Collegare categorie, attributi e prodotti

L'account ha tre relazioni tra Odoo e Shopee: Category Mappings, Attribute Mappings e Product Mappings.

Categorie

In Category Mappings colleghi una categoria di Odoo a una di Shopee. Ogni riga contiene Marketplace Account, Odoo Category, Marketplace Category ID (il category_id di Shopee) e Marketplace Category Name, un nome leggibile che il modulo memorizza per mostrarlo a schermo. La colonna Created registra quando è stata creata la riga.

Elenco delle mappature di categorie con le colonne Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name e Created
L'elenco delle mappature di categorie, ancora vuoto, con il pulsante Nuovo e la barra di ricerca.

Attributi

In Attribute Mappings colleghi un attributo di Odoo (Odoo Attribute, per esempio colore, taglia o marca) alla chiave di attributo del marketplace in Marketplace Attribute Key. Ogni riga riporta anche il suo Marketplace Account e la data Created.

Prodotti

In Product Mappings trovi le relazioni tra ogni prodotto di Odoo e il suo ID prodotto sul marketplace. Nella sequenza seguente si vede un record di esempio dell'account Shopee SG con stato Synced.

Elenco delle mappature prodotto con un record Shopee SG in stato Synced, elenco degli account marketplace ed elenco vuoto delle mappature di attributi
Panoramica della mappatura prodotto di esempio, dell'elenco degli account con dati di test e dell'elenco delle mappature di attributi, ancora vuoto.

Se vuoi vedere come si incastrano questi elementi dietro le quinte, lo spieghiamo in come funziona il connettore dall'interno.

Cosa controllare la prima settimana

Con la sincronizzazione attiva, ecco i punti dell'account che all'inizio vale la pena guardare ogni giorno:

  • Sync Logs: il registro di audit delle interazioni con l'API.
  • Sync Conflicts: i conflitti rilevati in attesa di risoluzione. Controlla i conflitti in sospeso e, se serve, modifica la strategia di Auto-Conflict Resolution o la Conflict Detection Threshold (%).
  • Sync Queue: la coda interna delle attività di sincronizzazione asincrone.
  • Ordini trattenuti: se vedi ordini in Held Orders, verifica che la data di Create Sales Orders From sia quella che volevi.
  • Token: controlla la data di Access Token Expires nell'account.
  • Giacenza bassa: se hai attivato Auto-Create PO on Low Stock, cerca le bozze di ordine di acquisto e verifica che la Low Stock Threshold (units) abbia senso per i tuoi prodotti.
  • E-mail: verifica che gli indirizzi in Alert Email Recipients siano scritti bene e separati da virgole.

Il modulo include anche elenchi di riepilogo e di report sulle prestazioni. Negli screenshot sono ancora senza dati:

Elenco di riepilogo della dashboard marketplace con le colonne Company, Total Reve…, Total Or…, Critical… e Major E…
L'elenco di riepilogo della dashboard, ancora senza dati.
Elenco dei report sulle prestazioni con le colonne Company, Marketplace, Product Category, Date From e Date To
L'elenco dei report sulle prestazioni, ancora vuoto.

Se in quei giorni compare un messaggio che non capisci, trovi i testi letterali e come risolverli in i messaggi di errore del connettore.

Come ti aiuta FlexigoTech

In FlexigoTech implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura. Se vuoi che controlliamo la configurazione del tuo account Shopee, le mappature o un'integrazione che il modulo non copre, puoi scriverci dalla pagina del modulo.

Continua a leggere

Errori di Shopee Marketplace Connector (APAC): quando compare ogni messaggio e cosa fareCosa significa ogni messaggio di errore di Shopee Marketplace Connector (APAC) in Odoo, quando compare e cosa fare, con un caso inventato e i testi letterali.Come funziona Leroy Merlin Connector in Odoo: menu, azioni pianificate e percorsoQuali menu aggiunge Leroy Merlin Connector in Odoo, quali dieci azioni pianificate girano e con che frequenza, e cosa passa da FlexigoTech Cloud.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti