Documentação em desenvolvimentoBeta Aberto clique aqui para participar
docs.cloudmes.ai
CloudMES Docs

Bling

Integração com o ERP Bling: autenticação OAuth, parâmetros, importações e relatório de eventos.

Rotas

  • Configuração: /dashboard/integracoes/bling
  • Relatório: /dashboard/integracoes/bling/relatorio

Objetivo

Conectar o CloudMES ao Bling via OAuth, configurar regras de sincronização (produtos, BOM, estoque), vincular depósitos do Bling a armazéns/endereços do WMS e auditar o histórico de sincronizações, importações e erros.

Pré-requisitos

  • Conta e credenciais do Bling (Client ID, Client Secret e Redirect URI configurados no app Bling)
  • Logística > Cadastros > Armazéns e Endereços para vínculos de depósito
  • Tipos de movimentação WMS definidos

Como usar

Acesso

  1. Acesse Sistema > Integrações e abra Bling (configuração · relatório).

Configuração

  1. Clique em Conectar para iniciar o fluxo OAuth com o Bling.
  2. Autorize o acesso na janela do Bling.
  3. Configure toggles de sincronização (produtos, BOM, estoque), vínculos depósito Bling ↔ endereço WMS (endereços cadastrados em Endereços) e tipos de movimentação.
  4. Salve com Atualizar e execute importações manuais pelos botões da tela.

Configuração Bling

ÁreaDescrição
OAuthConexão e renovação de token com o Bling.
SincronizaçãoLiga/desliga importação de produtos, BOM e estoque.
DepósitosMapeia depósitos do Bling para endereços WMS (Endereços).
Importação manualDispara carga sob demanda após configurar vínculos.

Relatório

  1. Abra Relatório no menu da integração ou use o link direto.
  2. Filtre por período, status e tipo; clique em Buscar.
  3. Expanda linhas para ver payload JSON e use Copiar para diagnóstico.

Relatório Bling

Dados e integrações

  • GET/PUT — /integrations/bling/
  • POST — /integrations/bling/oauth/start
  • POST — /integrations/bling/import/
  • GET/POST — /integrations/bling/location-links/
  • GET — /integrations/bling/events/

Erros comuns

  • OAuth falha: Redirect URI no Bling deve coincidir com o configurado no CloudMES.
  • Importação parcial: consulte o Relatório e corrija produtos/endereços no cadastro local (Produtos, Endereços).
  • Depósito não vinculado: configure vínculos na aba de depósitos antes de importar estoque.

Perguntas frequentes

Preciso importar tudo de uma vez?
Não — use importação por entidade (produtos, estoque, etc.) e valide no Relatório de eventos da integração.

Eventos do Bling vs. produção?
O relatório na aba Relatório mostra sincronizações; apontamentos de chão continuam no Cockpit.

Relacionado