O que é a integração Bling

A integração com o Bling permite que o Fiscal.io busque automaticamente os XMLs das notas fiscais (NFe, NFC-e e NFSe) que estão no Bling e os importe para o Monitor. O sistema consulta a API do Bling em intervalos configurados, por tipo de documento e por período de emissão, e grava os arquivos no ambiente do Fiscal.io para consulta e exportação.

Pré-requisitos

• Conta ativa no Bling com as notas fiscais já enviadas/armazenadas na plataforma.
• Fiscal.io Monitor instalado e configurado, com permissão para o canal Integração via Bling.
• Uma filial (empresa) cadastrada no Fiscal.io, com CNPJ/CPF que será vinculado à autenticação no Bling.

Criando e configurando o canal Bling

• No Gerenciador de Canais, crie um novo canal ou edite um existente.
• Em Proposta, selecione "Receber".
• Em Tipo de Integração, selecione Integração via Bling.

Autenticação no Bling

Para o Fiscal.io acessar os dados do Bling em nome da sua empresa, é necessário autorizar o acesso. Há duas formas:

Opção 1 – Eu tenho acesso à conta do Bling

1. Selecione apenas uma filial (CNPJ/CPF) na lista de empresas do canal — a autenticação será vinculada a ela.
2. Clique em Autenticar no Bling.
3. Será aberta no navegador a página de autorização do Bling. Faça login (se necessário) e autorize o acesso ao Fiscal.io.
4. Após autorizar, volte ao Fiscal.io e clique em Testar conexão. O status deve passar a exibir Autenticado.

Opção 2 – Solicitar autenticação por e-mail

1. Informe o e-mail da pessoa que tem acesso à conta do Bling.
2. Selecione apenas uma filial na lista de empresas.
3. Clique em Solicitar autenticação.
4. O destinatário receberá um e-mail e, ao concluir a autorização no Bling, a conexão ficará disponível. Use Testar Conexão para verificar o status.
   

5. Configuração dos ponteiros (tipos de documento)

Na aba Ponteiros, são definidos quais tipos de documento serão buscados do Bling e a partir de qual data. Cada linha representa um “ponteiro” por tipo de documento.

Para cada tipo ativo, o sistema mantém um ponteiro de data (última data já processada). A busca é feita em blocos (ex.: por semana) e o ponteiro é atualizado para não reprocessar o mesmo período.

6. Como funciona o recebimento das notas

1. O serviço de integração (no servidor Fiscal.io) executa na frequência definida no canal (ex.: a cada X minutos).
2. Para cada tipo de documento configurado nos Ponteiros (NFe, NFC-e, NFSe), o sistema:
   • Obtém a lista de documentos no Bling no período (data inicial até data final), com paginação (lote de 50 registros).
   • Para cada chave de acesso da lista, busca o XML do documento na API do Bling.
   • Grava o XML no ambiente Fiscal.io e processa o arquivo como nos demais canais (validação, monitor, etc.).
3. O ponteiro de data de cada tipo é atualizado após cada bloco processado, para que na próxima execução a busca continue de onde parou.

A busca por período evita sobrecarga e permite retomar de forma segura. Em caso de erro (ex.: token expirado), o sistema pode tentar renovar o token e refazer a requisição.

7. Onde ver as notas recebidas (Monitor)

Após o processamento, as notas recebidas do Bling aparecem no Fiscal.io Monitor, na lista de documentos fiscais da empresa, junto com os demais canais (SEFAZ, e-mail, pasta, etc.). Você pode filtrar por tipo (NFe, NFC-e, NFSe), data, parceiro e utilizar as opções de visualização de XML/PDF e exportação.