Salta al contingut principal
Channable

API de Channable des d'Odoo: què necessita, què crida el connector i els seus errors

L'API de Channable necessita l'id numèric de la teva empresa, un token d'API que caduca al cap d'un any i, per a algunes crides, l'id del projecte. El connector de FlexigoTech per a Odoo comprova cada dia la caducitat del token. Importa comandes cada 15 minuts amb el cursor de l'API v2 i envia l'estoc en lots de 50 articles, el límit dur de l'API, a 4 peticions per segon.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 12 de novembre de 2026

L'essencial

Mòdul
Channable
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0
Lectura
4 min

Què necessita l'API de Channable per connectar-se

  • Channable Company ID: l'id numèric que mostra l'aplicació de Channable. Ha de ser un nombre positiu.
  • API token (FlexigoTech Cloud): el generes a l'aplicació de Channable (Company Settings > Channable API) i dura un any. S'envia una sola vegada, xifrat, a FlexigoTech Cloud i mai no es desa a Odoo.
  • Token Expires: un recordatori de quan el token farà un any.
  • L'id del projecte, també positiu, per als endpoints que exigeixen un abast de projecte.

Abans de desar el token, un administrador ha de marcar I accept that my Channable API token and my calls to Channable go through FlexigoTech Cloud. El relé de FlexigoTech Cloud guarda el token xifrat i l'afegeix a cada crida.

Quines crides fa el connector a l'API de Channable i amb quina freqüència

El connector treballa en els dos sentits sobre l'API de connexió de comandes de Channable (api.channable.com). Aquestes accions planificades són actives des de la instal·lació:

Acció planificadaFreqüència
Channable: import ordersCada 15 minuts
Channable: push pending shipmentsCada 15 minuts
Channable: import returnsCada 30 minuts
Channable: push stock updatesCada 30 minuts
Channable: publish feeds on FlexigoTech CloudCada hora
Channable: pull channel statisticsCada dia
Channable: API token expiry checkCada dia

Les comandes entren mitjançant una consulta incremental de l'API v2, amb el cursor last_modified_after. Cadascuna crea una comanda de venda amb impostos inclosos al preu derivats del canal, línies d'enviament i de descompte, comissió, despeses de transacció i la marca de comanda de prova. Les comandes d'Amazon tenen la seva pròpia guia de Channable i Amazon.

Llista de comandes de Channable a Odoo amb canal, comprador, total, comissió i estat de pagament i d'enviament
Comandes de Channable, amb dades de demostració.

Els moviments d'estoc reals marquen els articles com a pendents i el connector envia valors d'estoc absoluts. Una acció de conciliació compara l'estoc d'Odoo amb les ofertes en viu de Channable.

FlexigoTech Cloud allotja el feed de productes de cada projecte: Odoo el genera (XML, CSV o JSON), el comprimeix amb gzip i el puja cada hora si ha canviat, o amb Publish feed now. Channable l'importa des de l'URL allotjada que es mostra al projecte.

Tauler de Channable a Odoo amb articles al feed, comandes, devolucions, comissions dels canals i activitat de sincronització
El tauler de Channable amb dades de demostració.

Límits de l'API de Channable i com els respecta el connector

L'API accepta com a màxim 50 articles per actualització d'estoc. El connector envia lots de 50 mitjançant un client que respecta els límits de velocitat: un leaky bucket de 4 peticions per segon. Si una petició en portés més, el mòdul l'aturaria amb Channable stock updates accept at most … items per request.

Pel que fa al token, la comprovació de caducitat s'executa cada dia. Si Channable respon amb un 401 o un 403, el compte passa a l'estat Authentication error.

Errors de connexió amb l'API de Channable i què fer

MissatgeQuan apareixQuè fer
Channable refused the API token of account '…' saved in FlexigoTech Cloud (…): it is not valid, it has expired (tokens last 1 year) or it was revoked. Generate another one in the Channable app (Company Settings > Channable API) and type it in the account. Nothing was marked as failed.Channable respon amb un 401 o un 403.Genera un altre token i escriu-lo al compte.
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.El compte ja no té el consentiment per passar per FlexigoTech Cloud.Un administrador l'accepta de nou al compte.
The Channable company id must be a positive number.L'id d'empresa és zero o negatiu.Copia l'id que mostra l'aplicació de Channable.
The Channable project id must be a positive number.L'id del projecte és zero o negatiu.Corregeix l'id del projecte.
This Channable endpoint requires a project scope.Una crida que necessita un projecte s'envia sense.Revisa el projecte.
Before saving the API token, an administrator has to accept that the token and the calls to Channable go through FlexigoTech Cloud. Nothing was sent.El token es desa sense aquest consentiment.Un administrador l'accepta i tornes a desar.
The API token of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud no té el token d'aquest compte.Escriu el token de nou.

Preguntes sobre l'API de Channable a Odoo

Amb quina freqüència arriben a Odoo les comandes de Channable?

Cada 15 minuts, mitjançant l'acció Channable: import orders, que consulta l'API v2 amb el cursor last_modified_after.

Odoo guarda una còpia del token d'API?

No. El relé de FlexigoTech Cloud el guarda xifrat. Només un administrador pot esborrar el token de FlexigoTech Cloud.

Què necessito i amb quines versions d'Odoo funciona?

Funciona amb Odoo 17, 18, 19 i 20 i necessita la subscripció a FlexigoTech Cloud, pla Connector. Trobaràs el Channable Odoo Connector a Odoo Apps i els detalls a la seva pàgina de flexigotech.com.

Continua llegint

Channable Amazon a Odoo: comandes, factura del venedor i etiquetes EasyShipQuè passa a Odoo amb les comandes d'Amazon que porta Channable: la pujada de la INVOICE, les etiquetes EasyShip, el seguiment, cancel·lacions i devolucions.
Comprovat al codi del connector (versió 20.0)

Fonts

  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): README.md
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
  • Codi del mòdul: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml