O que a API Channable exige para ligar
ID de Empresa Channable: o id numérico que aparece na aplicação Channable. Tem de ser um número positivo.Token da API (FlexigoTech Cloud): gera-o na aplicação Channable (Company Settings > Channable API) e dura um ano. É enviado uma vez, cifrado, para o FlexigoTech Cloud e nunca é guardado no Odoo.Expiração do Token: um lembrete de quando o token completa um ano.- O id do projeto, também positivo, para os endpoints que exigem um âmbito de projeto.
Antes de guardar o token, um administrador tem de marcar Aceito que o meu token da API do Channable e as minhas chamadas ao Channable passem pelo FlexigoTech Cloud. O relay do FlexigoTech Cloud guarda o token cifrado e acrescenta-o a cada chamada.
Que chamadas à API Channable faz o conector e com que frequência
O conector trabalha nos dois sentidos sobre a API de ligação de encomendas do Channable (api.channable.com). Estas ações agendadas estão ativas desde a instalação:
| Ação agendada | Frequência |
|---|---|
Channable: importar encomendas | A cada 15 minutos |
Channable: enviar expedições pendentes | A cada 15 minutos |
Channable: importar devoluções | A cada 30 minutos |
Channable: enviar atualizações de stock | A cada 30 minutos |
Channable: publicar os feeds no FlexigoTech Cloud | A cada hora |
Channable: obter estatísticas dos canais | Todos os dias |
Channable: verificação de expiração do token da API | Todos os dias |
As encomendas entram por sondagem incremental da API v2, com o cursor last_modified_after. Cada uma cria uma ordem de vendas com impostos incluídos no preço derivados do canal, linhas de expedição e de desconto, comissão, taxas de transação e a marca de encomenda de teste. As encomendas da Amazon têm o seu próprio guia do Channable e da Amazon.

Os movimentos reais de stock marcam os artigos como pendentes e o conector envia valores absolutos de stock. Uma ação de reconciliação compara o stock do Odoo com as ofertas em direto do Channable.
O FlexigoTech Cloud aloja o feed de produtos de cada projeto: o Odoo gera-o (XML, CSV ou JSON), comprime-o em gzip e carrega-o a cada hora se tiver mudado, ou com Publicar o feed agora. O Channable importa-o a partir do URL alojado que aparece no projeto.

Limites da API Channable e como o conector os respeita
A API aceita no máximo 50 artigos por atualização de stock. O conector envia lotes de 50 através de um cliente que respeita os limites de pedidos: um leaky bucket de 4 pedidos por segundo. Se um pedido levasse mais, o módulo bloqueava-o com As atualizações de stock Channable aceitam no máximo … artigos por pedido.
Quanto ao token, a verificação de expiração corre todos os dias. Se o Channable responder com um 401 ou um 403, a conta passa ao estado Erro de autenticação.
Erros de ligação da API Channable e o que fazer
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
O Channable recusou o token da API da conta '…' guardado no FlexigoTech Cloud (…): não é válido, expirou (os tokens duram 1 ano) ou foi revogado. Gere outro na aplicação Channable (Company Settings > Channable API) e escreva-o na conta. Nada foi marcado como falhado. | O Channable responde com um 401 ou um 403. | Gere outro token e escreva-o na conta. |
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. | A conta já não tem o consentimento para passar pelo FlexigoTech Cloud. | Um administrador aceita-o de novo na conta. |
O id de empresa Channable tem de ser um número positivo. | O id de empresa é zero ou negativo. | Copie o id que aparece na aplicação Channable. |
O id de projeto Channable tem de ser um número positivo. | O id de projeto é zero ou negativo. | Corrija o id do projeto. |
Este endpoint Channable requer um âmbito de projeto. | Uma chamada que precisa de projeto é feita sem ele. | Verifique o projeto. |
Antes de guardar o token da API, um administrador tem de aceitar que o token e as chamadas ao Channable passem pelo FlexigoTech Cloud. Nada foi enviado. | O token é guardado sem esse consentimento. | Um administrador aceita e guarda de novo. |
O token da API de … não está guardado no FlexigoTech Cloud: escreva-o de novo. | O FlexigoTech Cloud não tem o token dessa conta. | Escreva o token de novo. |
Perguntas sobre a API Channable no Odoo
Com que frequência chegam as encomendas do Channable ao Odoo?
A cada 15 minutos, através da ação Channable: importar encomendas, que sonda a API v2 com o cursor last_modified_after.
O Odoo guarda uma cópia do token da API?
Não. O relay do FlexigoTech Cloud guarda-o cifrado. Só um administrador pode apagar o token do FlexigoTech Cloud.
O que preciso e com que versões do Odoo funciona?
Funciona com o Odoo 17, 18, 19 e 20 e precisa da subscrição do FlexigoTech Cloud, plano Conector. Encontra o Conector Channable para Odoo no Odoo Apps e os detalhes na sua página em flexigotech.com.
Continue a ler
Verificado no código do conector (versão 20.0)
Fontes
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): README.md
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
- Código do módulo: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml
