Saltar al contenido principal
Channable

Channable API desde Odoo: qué pide, qué llamadas hace el conector y sus errores

La API de Channable pide el id numérico de tu empresa, un token de API que caduca al año y, en algunas llamadas, el id del proyecto. El conector de FlexigoTech para Odoo comprueba la caducidad del token cada día. Trae los pedidos cada 15 minutos con el cursor de la API v2 y envía el stock en lotes de 50 artículos, el tope de la API, a 4 peticiones por segundo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 12 de noviembre de 2026

Lo esencial

Módulo
Channable
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0
Lectura
4 min

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 programadaFrecuencia
Channable: importar pedidosCada 15 minutos
Channable: enviar expediciones pendientesCada 15 minutos
Channable: importar devolucionesCada 30 minutos
Channable: enviar actualizaciones de stockCada 30 minutos
Channable: publicar los feeds en FlexigoTech CloudCada hora
Channable: obtener estadísticas de canalCada día
Channable: comprobación de caducidad del token de APICada 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.

Lista de pedidos de Channable en Odoo con canal, comprador, total, comisión y estados de pago y de envío
Los pedidos de Channable, con datos de demostración.

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.

Panel de Channable en Odoo con artículos en el feed, pedidos, devoluciones, comisiones y actividad de sincronización
El panel de Channable con datos de demostración.

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

MensajeCuándo saleQué 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

Channable y Amazon en Odoo: pedidos, factura del vendedor y etiquetas EasyShipQué pasa en Odoo con los pedidos de Amazon que trae Channable: la factura INVOICE, las etiquetas EasyShip, el seguimiento y las devoluciones.
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