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ó planificada | Freqüència |
|---|---|
Channable: import orders | Cada 15 minuts |
Channable: push pending shipments | Cada 15 minuts |
Channable: import returns | Cada 30 minuts |
Channable: push stock updates | Cada 30 minuts |
Channable: publish feeds on FlexigoTech Cloud | Cada hora |
Channable: pull channel statistics | Cada dia |
Channable: API token expiry check | Cada 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.

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.

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
| Missatge | Quan apareix | Què 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
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
