Saltar para o conteúdo principal
Channable

API Channable a partir do Odoo: o que exige, o que o conector chama e os seus erros

A API Channable exige o id numérico da sua empresa, um token da API que expira ao fim de um ano e, em algumas chamadas, o id do projeto. O conector da FlexigoTech para Odoo verifica todos os dias a expiração do token. Obtém as encomendas a cada 15 minutos com o cursor da API v2 e envia o stock em lotes de 50 artigos, o limite estrito da API, a 4 pedidos por segundo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 12 de novembro de 2026

O essencial

Módulo
Channable
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0
Leitura
4 min

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 agendadaFrequência
Channable: importar encomendasA cada 15 minutos
Channable: enviar expedições pendentesA cada 15 minutos
Channable: importar devoluçõesA cada 30 minutos
Channable: enviar atualizações de stockA cada 30 minutos
Channable: publicar os feeds no FlexigoTech CloudA cada hora
Channable: obter estatísticas dos canaisTodos os dias
Channable: verificação de expiração do token da APITodos 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.

Lista de encomendas Channable no Odoo com canal, comprador, total, comissão e estado de pagamento e de expedição
Encomendas Channable, com dados de demonstração.

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.

Painel do Channable no Odoo com artigos no feed, encomendas, devoluções, comissões dos canais e atividade de sincronização
O painel do Channable com dados de demonstração.

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

MensagemQuando apareceO 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

Channable Amazon no Odoo: encomendas, fatura do vendedor e etiquetas EasyShipO que acontece no Odoo às encomendas Amazon que o Channable traz: envio da fatura INVOICE, etiquetas EasyShip, rastreio, cancelamentos e devoluções.
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