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 pianificata | Frequenza |
|---|---|
Channable: importa ordini | Ogni 15 minuti |
Channable: invia spedizioni in sospeso | Ogni 15 minuti |
Channable: importa resi | Ogni 30 minuti |
Channable: invia aggiornamenti di giacenza | Ogni 30 minuti |
Channable: pubblica i feed su FlexigoTech Cloud | Ogni ora |
Channable: recupera statistiche di canale | Ogni giorno |
Channable: controllo scadenza token API | Ogni 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.

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.

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
| Messaggio | Quando compare | Cosa 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
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
