El connector d'Octopia està publicat per a Odoo 17, 18, 19 i 20. Abans de començar convé saber dues coses de l'API d'Octopia: només admet credencials de tipus client credentials i no té un entorn de proves separat. Les proves es fan en producció, sobre un canal de venda de prova que Octopia ofereix dins de la mateixa API.
Passos
- Al back office d'Octopia, obre la gestió de credencials d'API i crea les teves o vincula les del teu integrador. Si connectes a través d'un integrador, l'has d'acceptar en aquesta pantalla.
- A Odoo, ves a Octopia › Configuration › Accounts i crea el compte. Escriu primer el Client ID i el Seller ID; el secret, després.
- Un administrador d'Odoo accepta l'avís que les credencials i les crides a Octopia passen per FlexigoTech Cloud. Sense aquesta acceptació el secret no es desa.
- A Configuration › Sales Channels tria el canal de venda per defecte. És el que es fa servir en publicar ofertes quan no n'indiques cap altre.
- Deixa que es descarreguin els referencials: categories, marques i transportistes. La tasca es repeteix cada setmana; la primera vegada la pots llançar a mà.
- Aparella els teus productes amb el catàleg d'Octopia. Per vendre a Cdiscount, el producte ha d'estar en francès.
- Publica les ofertes des d'Offers › Publication Packages.
- Activa les automatitzacions del compte que vulguis fer servir: acceptar comandes, confirmar vendes, declarar l'enviament en validar l'albarà.


Els errors del primer dia
| Missatge | Què passa | Solució |
|---|---|---|
The Octopia Seller ID must be numeric (e.g. 98979). | Has enganxat el nom de la botiga o un codi amb lletres. | Copia el Seller ID numèric del back office. |
Enter the Client ID and the Seller ID before the secret. Nothing was sent. | Has escrit el secret amb els altres camps buits. | Omple Client ID i Seller ID i desa el secret després. |
Before saving the secret, an administrator has to accept… | Falta acceptar l'avís del núvol. | Que un administrador l'accepti al compte. |
Account '…' has no default sales channel configured. | No hi ha canal per defecte. | Tria'n un al compte o a Sales Channels. |
Product … is not mapped to the Octopia catalog | El producte no està aparellat amb la seva fitxa d'Octopia. | Fes el mapatge abans de publicar l'oferta. |

Comandes i enviaments
L'API d'Octopia no avisa amb webhooks: cal preguntar-li. Per això el connector consulta les comandes cada 10 minuts i envia canvis de preu i d'estoc cada 15. Un detall que despista: Octopia no dona l'adreça del comprador fins que la comanda és en preparació. És normal veure comandes acabades d'arribar sense adreça; la consulta següent la completa.
Per declarar l'enviament, Octopia demana dimensions i pes en alguns modes de lliurament. Si en falten, Odoo t'ho diu abans d'enviar res.

Si també vendràs en altres canals d'Octopia, recorda que l'estoc d'un mateix producte i estat es comparteix entre tots. Actualitzar-lo en un l'actualitza a la resta.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): docs/api-ground-truth.md
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_account.py
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_fulfillment.py
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_ffm_setup.py
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): views/menu.xml
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_offer_views.xml
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_order_views.xml
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_referential_views.xml
- Codi del mòdul: flexigobe_octopia_connector 20.0 (dfba2acc): data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
