Bling
Documentação Referência: https://developer.bling.com.br/referencia#/
Sobre o Bling
O Bling é um sistema de gestão empresarial (ERP) online voltado principalmente para pequenas e médias empresas.
A plataforma centraliza e automatiza diversos processos administrativos e operacionais, como vendas, compras, estoque, financeiro e notas fiscais, facilitando a gestão do negócio em um único ambiente.
A integração com a Kamino conecta o ERP Bling à gestão financeira, garantindo mais controle, consistência de dados e redução de tarefas manuais.
Visão geral da integração
A integração entre Bling e Kamino tem como objetivo manter contas a pagar e contas a receber sincronizadas entre as plataformas.
Com a integração ativa:
Títulos financeiros do Bling são refletidos automaticamente na Kamino;
Alterações de valor, vencimento ou status são atualizadas;
Pagamentos e recebimentos geram baixa automática;
O time financeiro passa a trabalhar com dados centralizados e atualizados.
A sincronização acontece de forma automática, por meio de rotinas executadas a cada 12 horas.
Como funciona a integração
1. Sincronização dos títulos
A Kamino identifica os títulos financeiros criados no Bling (contas a pagar e contas a receber) dentro do período de sincronização.
Esses títulos são analisados individualmente para criação ou atualização dos lançamentos financeiros correspondentes na Kamino.
2. Validação de clientes e fornecedores
Para cada título:
A Kamino verifica se o cliente ou fornecedor já está cadastrado;
Caso exista, o processo segue normalmente;
Caso não exista, o cadastro é criado automaticamente com os dados disponíveis no Bling, como:
Nome;
Documento (CPF ou CNPJ);
Nome fantasia;
E-mail;
Endereço.
O identificador do cliente ou fornecedor no Bling é utilizado como código externo, garantindo o vínculo entre os sistemas.
3. Criação ou atualização do título
Após a validação da pessoa:
Se o título ainda não existir na Kamino, ele é criado automaticamente;
Se já existir, a Kamino valida:
Valor;
Datas de vencimento e pagamento;
Status do título.
Quando o título é identificado como pago ou recebido no Bling, a Kamino realiza a baixa automática.
Caso o título seja cancelado no Bling, o cancelamento também é refletido na Kamino.
Mapeamento de informações (Bling → Kamino)
Durante a integração, os dados são utilizados da seguinte forma:
Pessoa (cliente ou fornecedor)
Nome no Bling → Nome da pessoa na Kamino
Número do documento → CPF ou CNPJ na Kamino
Nome fantasia → Nome fantasia na Kamino
E-mail → E-mail principal
Endereço → Endereço da pessoa na Kamino
ID da pessoa no Bling → Código Externo para controle da integração
Títulos financeiros
ID do título no Bling → Código Externo do título na Kamino
Descrição → Descrição do lançamento
Data de vencimento → Data de vencimento
Data de emissão → Data de competência
Valor → Valor do título
Categoria (Bling) → Plano de Contas (Kamino)
Centro de custo → Centro de custo na Kamino
Unidade de negócio → Unidade de negócio na Kamino
Status → Pendente, Pago, Recebido ou Cancelado
Pagamentos e recebimentos (baixa)
Data do pagamento/recebimento → Data de pagamento na Kamino
Valor pago/recebido → Valor do pagamento
Conta utilizada no Bling → Conta corrente na Kamino
Status pago/recebido → Baixa automática do título
Classificação financeira
Os títulos são classificados automaticamente na Kamino com base nas informações do Bling, respeitando:
Plano de contas;
Centro de custo;
Unidade de negócio;
Conta de pagamento ou recebimento.
Para que essa classificação funcione corretamente, é importante que os nomes estejam alinhados entre as plataformas.
Pré-requisitos
Para o correto funcionamento da integração:
A conta do Bling deve estar ativa;
A Kamino deve possuir planos de contas, centros de custo e contas correntes configurados;
As descrições de Categoria (Bling) e Plano de Contas (Kamino) devem ser idênticas;
As contas correntes de pagamento e recebimento devem ter o mesmo nome nos dois sistemas.
Boas práticas
Realize alterações de valores, datas e status preferencialmente no Bling;
Evite editar manualmente títulos sincronizados na Kamino;
Mantenha cadastros de clientes e fornecedores sempre atualizados;
Utilize a Kamino como base central para controle financeiro e conciliação.