English
Català
Deutsch
Français
Português
Italiano
Nederlands
PolskiEl conector de Octopia está publicado para Odoo 17, 18, 19 y 20. Antes de empezar conviene saber dos cosas de la API de Octopia: solo admite credenciales de tipo client credentials y no tiene un entorno de pruebas separado. Las pruebas se hacen en producción, sobre un canal de venta de prueba que Octopia ofrece dentro de la propia API.
Pasos
- En el back office de Octopia, abre la gestión de credenciales de API y crea las tuyas o vincula las de tu integrador. Si conectas a través de un integrador, tienes que aceptarlo en esa pantalla.
- En Odoo, ve a Octopia › Configuration › Accounts y crea la cuenta. Escribe primero el Client ID y el Seller ID; el secret, después.
- Un administrador de Odoo acepta el aviso de que las credenciales y las llamadas a Octopia pasan por FlexigoTech Cloud. Sin esa aceptación el secret no se guarda.
- En Configuration › Sales Channels elige el canal de venta por defecto. Es el que se usa al publicar ofertas cuando no indicas otro.
- Deja que se descarguen los referenciales: categorías, marcas y transportistas. La tarea se repite cada semana; la primera vez puedes lanzarla a mano.
- Casa tus productos con el catálogo de Octopia. Para vender en Cdiscount, el producto tiene que estar en francés.
- Publica las ofertas desde Offers › Publication Packages.
- Activa las automatizaciones de la cuenta que quieras usar: aceptar pedidos, confirmar ventas, declarar el envío al validar el albarán.
Los errores del primer día
| Mensaje | Qué pasa | Solución |
|---|---|---|
The Octopia Seller ID must be numeric (e.g. 98979). | Pegaste el nombre de la tienda o un código con letras. | Copia el Seller ID numérico del back office. |
Enter the Client ID and the Seller ID before the secret. Nothing was sent. | Escribiste el secret con los otros campos vacíos. | Rellena Client ID y Seller ID y guarda el secret después. |
Before saving the secret, an administrator has to accept… | Falta la aceptación del aviso de la nube. | Que un administrador lo acepte en la cuenta. |
Account '…' has no default sales channel configured. | No hay canal por defecto. | Elige uno en la cuenta o en Sales Channels. |
Product … is not mapped to the Octopia catalog | El producto no está casado con su ficha de Octopia. | Haz el mapeo antes de publicar la oferta. |
Pedidos y envíos
La API de Octopia no avisa con webhooks: hay que preguntarle. Por eso el conector consulta los pedidos cada 10 minutos y envía cambios de precio y stock cada 15. Un detalle que despista: Octopia no da la dirección del comprador hasta que el pedido está en preparación. Es normal ver pedidos recién llegados sin dirección; la siguiente consulta la completa.
Para declarar el envío, Octopia pide dimensiones y peso en algunos modos de entrega. Si faltan, Odoo te lo dice antes de mandar nada.
Si vas a vender también en otros canales de Octopia, recuerda que el stock de un mismo producto y estado se comparte entre todos ellos. Actualizarlo en uno lo actualiza en el resto.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): docs/api-ground-truth.md
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_account.py
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_fulfillment.py
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_ffm_setup.py
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/menu.xml
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_offer_views.xml
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_order_views.xml
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_referential_views.xml
- Código del módulo: flexigobe_octopia_connector 20.0 (dfba2acc): data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector