Lo que pide la API de Channable para conectar
ID de empresa de Channable: el id numérico que muestra la aplicación de Channable. Debe ser un número positivo.Token de API (FlexigoTech Cloud): se genera en la aplicación de Channable (Company Settings > Channable API) y dura un año. Se envía una vez, cifrado, a FlexigoTech Cloud y nunca se guarda en Odoo.Caducidad del token: un recordatorio de cuándo el token cumple un año.- El id del proyecto, también positivo, para los endpoints que exigen ámbito de proyecto.
Antes de guardar el token, un administrador tiene que marcar Acepto que mi token de API de Channable y mis llamadas a Channable pasen por FlexigoTech Cloud. El relay de FlexigoTech Cloud guarda el token cifrado y lo añade a cada llamada.
Qué llamadas hace el conector a la API de Channable y cada cuánto
El conector trabaja en los dos sentidos sobre la API de conexión de pedidos de Channable (api.channable.com). Estas tareas programadas quedan activas al instalarlo:
| Tarea programada | Frecuencia |
|---|---|
Channable: importar pedidos | Cada 15 minutos |
Channable: enviar expediciones pendientes | Cada 15 minutos |
Channable: importar devoluciones | Cada 30 minutos |
Channable: enviar actualizaciones de stock | Cada 30 minutos |
Channable: publicar los feeds en FlexigoTech Cloud | Cada hora |
Channable: obtener estadísticas de canal | Cada día |
Channable: comprobación de caducidad del token de API | Cada día |
Los pedidos entran por consulta incremental a la API v2, con el cursor last_modified_after. Cada uno crea un pedido de venta con impuestos incluidos según el canal, líneas de envío y descuento, comisión, tarifas de transacción y la marca de pedido de prueba. Los de Amazon tienen su guía de Channable y Amazon.

Los movimientos reales de stock marcan los artículos como pendientes y el conector envía el stock absoluto. Una acción de conciliación compara el stock de Odoo con las ofertas activas en Channable.
FlexigoTech Cloud aloja el feed de productos de cada proyecto: Odoo lo genera (XML, CSV o JSON), lo comprime y lo sube cada hora si ha cambiado, o con Publicar el feed ahora. Channable lo importa desde la URL alojada que se ve en el proyecto.

Límites de la API de Channable y cómo los respeta el conector
La API admite como máximo 50 artículos por actualización de stock. El conector envía lotes de 50 con un cliente que controla el ritmo: un leaky bucket de 4 peticiones por segundo. Si una petición llevara más, el módulo la para con Las actualizaciones de stock de Channable aceptan como máximo … artículos por petición.
Para el token, la tarea de comprobación de caducidad corre cada día. Si Channable responde con un 401 o un 403, la cuenta pasa al estado Error de autenticación.
Mensajes de error de la conexión con la API de Channable
| Mensaje | Cuándo sale | Qué hacer |
|---|---|---|
Channable ha rechazado el token de API de la cuenta '…' guardado en FlexigoTech Cloud (…): no es válido, ha caducado (los tokens duran 1 año) o se ha revocado. Genere otro en la aplicación de Channable (Company Settings > Channable API) y escríbalo en la cuenta. No se ha marcado nada como fallido. | Channable responde con un 401 o un 403. | Genera otro token y escríbelo en la cuenta. |
Channable account '…' no longer has the consent to go through FlexigoTech Cloud, so nothing was sent. Nothing was marked as failed: an administrator accepts it again on the account to resume. | La cuenta ya no tiene la aceptación de pasar por FlexigoTech Cloud. | Un administrador vuelve a aceptarlo en la cuenta. |
El id de empresa de Channable debe ser un número positivo. | El id de empresa es cero o negativo. | Copia el id que muestra la aplicación de Channable. |
El id de proyecto de Channable debe ser un número positivo. | El id de proyecto es cero o negativo. | Corrige el id del proyecto. |
Este endpoint de Channable requiere un ámbito de proyecto. | Una llamada que exige proyecto va sin él. | Revisa el proyecto. |
Antes de guardar el token de API, un administrador tiene que aceptar que el token y las llamadas a Channable pasen por FlexigoTech Cloud. No se ha enviado nada. | Se guarda el token sin esa aceptación. | Un administrador acepta y guardas otra vez. |
El token de API de … no está guardado en FlexigoTech Cloud: vuelva a escribirlo. | FlexigoTech Cloud no tiene el token de esa cuenta. | Escribe el token otra vez. |
Preguntas sobre la API de Channable en Odoo
¿Cada cuánto llegan los pedidos de Channable a Odoo?
Cada 15 minutos, con la tarea Channable: importar pedidos, que consulta la API v2 con el cursor last_modified_after.
¿Guarda Odoo una copia del token de API?
No. Lo guarda cifrado el relay de FlexigoTech Cloud. Solo un administrador puede borrar el token de FlexigoTech Cloud.
¿Qué necesito y con qué versiones de Odoo funciona?
Funciona con Odoo 17, 18, 19 y 20 y necesita la suscripción a FlexigoTech Cloud, plan Conector. Tienes el Conector de Channable para Odoo en Odoo Apps y los detalles en su página de flexigotech.com.
Sigue leyendo
Comprobado en el código del conector (versión 20.0)
Fuentes
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): README.md
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
- Código del módulo: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml
