Documentação referencia: https://docs.asaas.com/reference/comece-por-aqui
Sobre o Asaas
O Asaas é uma plataforma de pagamentos e cobranças que permite emitir boletos, Pix, links de pagamento e gerenciar recebimentos de forma centralizada.
A integração com a Kamino permite que todas essas cobranças sejam automaticamente sincronizadas, trazendo mais controle, visibilidade financeira e previsibilidade de fluxo de caixa.
Visão geral da integração
A integração entre Asaas e Kamino tem como objetivo sincronizar automaticamente os recebimentos realizados no Asaas com a Kamino.
Com a integração ativa:
As cobranças criadas no Asaas aparecem automaticamente na Kamino;
Atualizações de status (como recebimentos confirmados) são refletidas na plataforma;
O fluxo de caixa fica sempre atualizado;
O trabalho manual de controle e conciliação é reduzido.
A integração funciona em via de mão única, ou seja, os dados fluem do Asaas para a Kamino.
Como funciona a sincronização
A Kamino utiliza dois processos complementares para garantir que os dados estejam sempre atualizados:
1. Atualização automática em lote
Diariamente, a Kamino verifica os recebimentos do Asaas e:
Cria cobranças que ainda não existem na Kamino;
Atualiza valores ou datas caso haja divergência;
Dá baixa automática quando a cobrança é identificada como recebida.
O Asaas é considerado a fonte de verdade. Qualquer alteração feita no Asaas será refletida na Kamino.
2. Atualização em tempo real
Sempre que uma cobrança é criada, atualizada, recebida ou excluída no Asaas, a Kamino recebe essa informação automaticamente e atualiza os dados em tempo próximo ao real.
Importação do extrato do Asaas (opcional)
Além das cobranças, a Kamino também pode importar o extrato da conta Asaas.
Com essa funcionalidade ativada, você passa a visualizar:
Entradas financeiras;
Taxas cobradas pelo Asaas (Pix, boleto, notificações, entre outras);
Movimentações financeiras vinculadas à conta Asaas.
A importação do extrato acontece diariamente e facilita a conciliação financeira.
💡 Recomendamos criar regras de classificação para taxas antes da primeira importação do extrato.
O que é sincronizado
Cobranças
Cliente ou pagador;
Valor da cobrança;
Data de vencimento;
Data de competência;
Status da cobrança;
Data e valor do recebimento;
Informações complementares da cobrança.
Extrato (quando habilitado)
Data do lançamento;
Descrição;
Valor;
Identificação da transação;
Conta Asaas vinculada.
Pré-requisitos
Para que a integração funcione corretamente:
A conta Asaas deve estar ativa;
É necessário gerar uma chave de API no Asaas;
A Kamino deve ter contas e classificações financeiras configuradas;
Para empresas com múltiplos CNPJs, cada conta Asaas deve ser integrada separadamente.
Boas práticas
Realize ajustes e alterações sempre no Asaas;
Evite editar manualmente cobranças sincronizadas na Kamino;
Configure previamente contas, classificações e centros de custo;
Ative a importação do extrato para maior visibilidade das taxas.