Bling — Configuração

Configuração da integração com o ERP Bling: autenticação OAuth, parâmetros e importações.

Rota

/dashboard/integracoes/bling

Objetivo

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

Pré-requisitos

Conta e credenciais do Bling (Client ID, Client Secret e Redirect URI configurados no app Bling)
Armazéns e endereços WMS criados para vinculação
Tipos de movimentação WMS definidos

Como usar

Acesse /dashboard/integracoes/bling.
Clique em Conectar para iniciar o fluxo OAuth com o Bling.
Autorize o acesso na janela do Bling.
Após autenticação, configure os parâmetros:
- Toggles de sincronização (produtos, BOM, estoque)
- Vínculos de depósitos Bling ↔ endereços WMS
- Tipos de movimentação para entradas/saídas
Salve com Atualizar.
Execute importações manuais (produtos, BOM, estoque) pelos botões correspondentes.

Dados e integrações

GET/PUT /integrations/bling/: configuração salva
POST /integrations/bling/oauth/start: inicia fluxo OAuth
POST /integrations/bling/import/: importações manuais
GET/POST /integrations/bling/location-links/: vínculos de depósito
GET /wms/movement-types/: tipos de movimentação disponíveis

Erros comuns

OAuth falha: verifique Client ID, Client Secret e se o Redirect URI no Bling corresponde exatamente ao configurado.
Token expirado: reconecte via botão OAuth; tokens do Bling expiram periodicamente.
Importação parcial: alguns produtos podem falhar se o mapeamento estiver incompleto; verifique o relatório após a importação.
Depósito não vinculado: movimentações do Bling sem vínculo são ignoradas ou geram erro.

Print

Ainda não há screenshot versionado. Salve em public/images/cloudmes/telas/bling.png e substitua este bloco pela imagem.