Il connettore Octopia è pubblicato per Odoo 17, 18, 19 e 20. Prima di iniziare conviene sapere due cose sull'API di Octopia: accetta solo client credentials e non ha un ambiente di test separato. I test si fanno in produzione, su un canale di vendita di prova che Octopia offre all'interno della stessa API.
Passaggi
- Nel back office di Octopia, apri la gestione delle credenziali API e crea le tue o collega quelle del tuo integratore. Se ti colleghi tramite un integratore, devi accettarlo in quella schermata.
- In Odoo, vai in Octopia › Configuration › Accounts e crea l'account. Inserisci prima il Client ID e il Seller ID; il secret, dopo.
- Un amministratore di Odoo accetta l'avviso che le credenziali e le chiamate a Octopia passano per FlexigoTech Cloud. Senza questa accettazione il secret non viene salvato.
- In Configuration › Sales Channels, scegli il canale di vendita predefinito. È quello usato per pubblicare le offerte quando non ne indichi un altro.
- Lascia che si scarichino i dati di riferimento: categorie, marchi e vettori. L'attività si ripete ogni settimana; la prima volta puoi lanciarla a mano.
- Abbina i tuoi prodotti al catalogo di Octopia. Per vendere su Cdiscount il prodotto deve essere in francese.
- Pubblica le offerte da Offers › Publication Packages.
- Attiva le automazioni dell'account che vuoi usare: accettare gli ordini, confermare le vendite, dichiarare la spedizione quando la consegna viene convalidata.


Errori del primo giorno
| Messaggio | Cosa succede | Soluzione |
|---|---|---|
The Octopia Seller ID must be numeric (e.g. 98979). | Hai incollato il nome del negozio o un codice con lettere. | Copia il Seller ID numerico dal back office. |
Enter the Client ID and the Seller ID before the secret. Nothing was sent. | Hai inserito il secret con gli altri campi vuoti. | Compila Client ID e Seller ID, poi salva il secret. |
Before saving the secret, an administrator has to accept… | L'avviso del cloud non è stato accettato. | Fallo accettare da un amministratore sull'account. |
Account '…' has no default sales channel configured. | Manca il canale predefinito. | Scegline uno sull'account o in Sales Channels. |
Product … is not mapped to the Octopia catalog | Il prodotto non è abbinato alla sua scheda Octopia. | Abbinalo prima di pubblicare l'offerta. |

Ordini e spedizioni
L'API di Octopia non avvisa tramite webhook: bisogna interrogarla. Per questo il connettore controlla gli ordini ogni 10 minuti e invia le variazioni di prezzo e giacenza ogni 15. Un dettaglio su cui molti inciampano: Octopia non rivela l'indirizzo dell'acquirente finché l'ordine non è in preparazione. È normale vedere ordini appena arrivati senza indirizzo; il controllo successivo lo completa.
Per dichiarare una spedizione, Octopia richiede dimensioni e peso per alcune modalità di consegna. Se mancano, Odoo te lo dice prima di inviare qualsiasi cosa.

Se vendi anche su altri canali Octopia, ricorda che la giacenza dello stesso prodotto nella stessa condizione è condivisa tra tutti. Se la aggiorni su uno, si aggiorna anche sugli altri.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): docs/api-ground-truth.md
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_account.py
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_fulfillment.py
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_ffm_setup.py
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/menu.xml
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_offer_views.xml
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_order_views.xml
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_referential_views.xml
- Codice del modulo: flexigobe_octopia_connector 20.0 (dfba2acc): data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
