Vai al contenuto principale
Channable

API Channable da Odoo: cosa richiede, cosa chiama il connettore e i suoi errori

L'API Channable richiede l'id numerico della tua azienda, un token API che scade dopo un anno e, per alcune chiamate, l'id del progetto. Il connettore FlexigoTech per Odoo controlla ogni giorno la scadenza del token. Recupera gli ordini ogni 15 minuti con il cursore dell'API v2 e invia la giacenza in lotti da 50 articoli, il limite rigido dell'API, a 4 richieste al secondo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 12 novembre 2026

In breve

Modulo
Channable
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0
Lettura
4 min

Cosa richiede l'API Channable per connettersi

  • ID azienda Channable: l'id numerico mostrato nell'app Channable. Deve essere un numero positivo.
  • Token API (FlexigoTech Cloud): lo generi nell'app Channable (Company Settings > Channable API) e dura un anno. Viene inviato una sola volta, cifrato, a FlexigoTech Cloud e non viene mai salvato in Odoo.
  • Scadenza token: un promemoria di quando il token compie un anno.
  • L'id del progetto, anch'esso positivo, per gli endpoint che richiedono l'ambito di un progetto.

Prima di salvare il token, un amministratore deve spuntare Accetto che il mio token API Channable e le mie chiamate a Channable passino per FlexigoTech Cloud. Il relay di FlexigoTech Cloud conserva il token cifrato e lo aggiunge a ogni chiamata.

Quali chiamate all'API Channable esegue il connettore e con quale frequenza

Il connettore lavora nei due sensi sull'API di connessione degli ordini di Channable (api.channable.com). Queste azioni pianificate sono attive fin dall'installazione:

Azione pianificataFrequenza
Channable: importa ordiniOgni 15 minuti
Channable: invia spedizioni in sospesoOgni 15 minuti
Channable: importa resiOgni 30 minuti
Channable: invia aggiornamenti di giacenzaOgni 30 minuti
Channable: pubblica i feed su FlexigoTech CloudOgni ora
Channable: recupera statistiche di canaleOgni giorno
Channable: controllo scadenza token APIOgni giorno

Gli ordini arrivano tramite polling incrementale dell'API v2, con il cursore last_modified_after. Ognuno crea un ordine di vendita con imposte incluse nel prezzo ricavate dal canale, righe di spedizione e sconto, commissione, costi di transazione e il flag di ordine di prova. Gli ordini Amazon hanno una loro guida a Channable e Amazon.

Elenco degli ordini Channable in Odoo con canale, acquirente, totale, commissione e stato di pagamento e spedizione
Ordini Channable, con dati dimostrativi.

I movimenti reali di giacenza segnalano gli articoli come in sospeso e il connettore invia valori assoluti di giacenza. Un'azione di riconciliazione confronta la giacenza di Odoo con le offerte attive di Channable.

FlexigoTech Cloud ospita il feed prodotti di ogni progetto: Odoo lo genera (XML, CSV o JSON), lo comprime in gzip e lo carica ogni ora quando cambia, oppure con Pubblica il feed ora. Channable lo importa dall'URL ospitato mostrato nel progetto.

Dashboard Channable in Odoo con articoli nel feed, ordini, resi, commissioni di canale e attività di sincronizzazione
La dashboard Channable con dati dimostrativi.

Limiti dell'API Channable e come li rispetta il connettore

L'API accetta al massimo 50 articoli per aggiornamento di giacenza. Il connettore invia lotti da 50 tramite un client che rispetta i limiti di frequenza: un leaky bucket di 4 richieste al secondo. Se una richiesta ne contenesse di più, il modulo la fermerebbe con Gli aggiornamenti di giacenza Channable accettano al massimo … articoli per richiesta.

Per il token, il controllo di scadenza viene eseguito ogni giorno. Se Channable risponde con un 401 o un 403, l'account passa allo stato Errore di autenticazione.

Errori di connessione all'API Channable e cosa fare

MessaggioQuando compareCosa fare
Channable ha rifiutato il token API dell'account '…' salvato in FlexigoTech Cloud (…): non è valido, è scaduto (i token durano 1 anno) o è stato revocato. Generane un altro nell'app Channable (Company Settings > Channable API) e inseriscilo nell'account. Nulla è stato segnato come non riuscito.Channable risponde con un 401 o un 403.Genera un altro token e inseriscilo nell'account.
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.L'account non ha più il consenso a passare per FlexigoTech Cloud.Un amministratore lo accetta di nuovo sull'account.
L'id azienda Channable deve essere un numero positivo.L'id azienda è zero o negativo.Copia l'id mostrato nell'app Channable.
L'id progetto Channable deve essere un numero positivo.L'id progetto è zero o negativo.Correggi l'id del progetto.
Questo endpoint Channable richiede l'ambito di un progetto.Una chiamata che richiede un progetto viene fatta senza.Controlla il progetto.
Prima di salvare il token API, un amministratore deve accettare che il token e le chiamate a Channable passino per FlexigoTech Cloud. Non è stato inviato nulla.Il token viene salvato senza quel consenso.Un amministratore accetta e tu salvi di nuovo.
Il token API di … non è salvato in FlexigoTech Cloud: inseriscilo di nuovo.FlexigoTech Cloud non conserva il token di quell'account.Inserisci di nuovo il token.

Domande sull'API Channable in Odoo

Ogni quanto arrivano in Odoo gli ordini di Channable?

Ogni 15 minuti, tramite l'azione Channable: importa ordini, che interroga l'API v2 con il cursore last_modified_after.

Odoo conserva una copia del token API?

No. Il relay di FlexigoTech Cloud lo conserva cifrato. Solo un amministratore può eliminare il token da FlexigoTech Cloud.

Cosa mi serve e con quali versioni di Odoo funziona?

Funziona con Odoo 17, 18, 19 e 20 e richiede l'abbonamento a FlexigoTech Cloud, piano Connettore. Trovi il Connettore Channable per Odoo su Odoo Apps e i dettagli nella sua pagina su flexigotech.com.

Continua a leggere

Channable Amazon in Odoo: ordini, fattura del venditore ed etichette EasyShipCosa succede in Odoo agli ordini Amazon che porta Channable: caricamento della fattura INVOICE, etichette EasyShip, tracking, annullamenti e resi.
Verificato nel codice del connettore (versione 20.0)

Fonti

  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): README.md
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
  • Codice del modulo: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml