n8n-nodes-bling

Community Node para n8n com suporte à API v3 do Bling.

Este pacote gera recursos, operações, parâmetros e campos de requisição a partir da especificação OpenAPI do Bling, reduzindo a necessidade de manutenção manual endpoint por endpoint.

Recursos

• Credencial OAuth2 nativa do n8n
• Recursos dinâmicos baseados nas tags da documentação do Bling
• Operações dinâmicas baseadas nos paths e métodos da OpenAPI
• Campos de query, path e body gerados a partir dos parâmetros e schemas da OpenAPI
• Paginação automática para operações de listagem usando pagina e limite
• Camada única de transporte HTTP com NodeApiError

Instalação

No n8n, instale este Community Node pelo nome:

n8n-nodes-bling

Ou instale manualmente no diretório de custom nodes do n8n:

npm install n8n-nodes-bling

Depois reinicie o n8n.

Configuração OAuth2

Crie um aplicativo no portal de desenvolvedores do Bling e configure a URL de redirecionamento OAuth exibida pelo n8n.

Em uma instalação padrão do n8n com domínio próprio, a URL geralmente fica assim:

https://SEU_DOMINIO_N8N/rest/oauth2-credential/callback

A URL cadastrada no Bling precisa ser exatamente igual à URL exibida pelo n8n.

No n8n, crie uma credencial Bling OAuth2 API e informe:

• Client ID
• Client Secret

O n8n cuida automaticamente do armazenamento do access token, refresh token e renovação do token expirado.

Como usar

Adicione o node Bling no workflow e escolha:

• Resource: segue os grupos da documentação do Bling, como Contatos, Pedidos - Vendas, Produtos e Notas Fiscais Eletrônicas
• Operation: segue os resumos das operações presentes na especificação OpenAPI

Observações

Este node é gerado a partir da especificação OpenAPI v3 fornecida pelo Bling. Alguns payloads complexos ou muito aninhados podem aparecer como campos JSON quando a representação em formulário não for clara.

Licença

MIT