Com o Asaas conectado, você cobra seus clientes por PIX, boleto e cartão de crédito direto do Coconut. Quando o cliente paga, o lançamento é quitado sozinho e o valor entra na conta. Dá também para criar assinaturas, trazer o que já existe no Asaas, acompanhar saldo e extrato e emitir NFS-e. O Asaas é uma instituição de pagamento autorizada pelo Banco Central: é ele quem processa o dinheiro, e o Coconut organiza tudo por cima.
Como funciona, em uma visão
- 1 Você cria a receita em Lançamentos e, no menu dela, clica em Criar cobrança.
- 2 O Coconut cadastra (ou reaproveita) o cliente no Asaas sozinho, pelo CPF/CNPJ.
- 3 A cobrança nasce no Asaas ligada àquele lançamento, com o link de pagamento pronto para enviar.
- 4 Quando o cliente paga, o Asaas avisa o Coconut, em geral em segundos: o lançamento vira Pago e o valor entra na conta.
- 5 Se quiser, a NFS-e sai junto: marcada na criação da cobrança, emitida depois pelo lançamento ou, na assinatura, sozinha a cada cobrança.
O caminho inverso também existe: clientes, cobranças e assinaturas que já estão no Asaas podem ser trazidos para o Coconut.
Antes de começar
- Um plano pago ativo no Coconut. No teste grátis, a aba Asaas e a tela de Notas Fiscais mostram Disponível em planos pagos.
- Uma conta no Asaas já aprovada, com os dados bancários configurados lá. O Asaas faz a verificação de identidade dele; o Coconut não cria nem aprova conta.
- A chave de API do ambiente que você vai usar (começa com
$aact_).
Ainda não tem conta no Asaas?
Em Configurações Asaas , clique em Não e depois em Criar conta no Asaas. Você vai para a página da parceria Coconut + Asaas, preenche o formulário e a equipe do Asaas entra em contato com as condições e taxas especiais. O formulário é um pedido de contato: conclua o cadastro com o Asaas e só depois volte para conectar.
Conectar sua conta
- 1 No painel do Asaas, gere a chave em Integrações → Chaves de API e copie inteira.
- 2 No Coconut, vá em Configurações Asaas e cole a chave no campo Chave de API.
- 3 Em Ambiente da chave, escolha Produção ou Sandbox (somente testes), igual ao painel de onde a chave saiu.
- 4 Clique em Conectar conta. Com a chave válida, a tela mostra a conta, o e-mail, o ambiente, a data da conexão e se a NFS-e está habilitada.
Ao conectar, o Coconut registra sozinho o canal por onde o Asaas avisa os pagamentos e confere se a NFS-e está ativa na conta. O passo a passo com mais detalhes, e o que fazer se der erro, está em Conectar sua conta Asaas.
O que tem em Configurações → Asaas
Depois de conectado, a aba reúne:
- Primeiros passos com o Asaas: um checklist com o que falta (vincular clientes, definir a categoria padrão, importar as cobranças que já existem e, com NFS-e habilitada, conferir a configuração das notas). Some sozinho quando tudo estiver feito.
- Saúde da integração: mostra o último evento recebido do Asaas e, se os avisos pararam de chegar, o botão Reativar recebimento (só para o dono e administradores).
- Categoria padrão das cobranças: a categoria de receita que os lançamentos vindos do Asaas usam.
- Conta que recebe do Asaas: a conta bancária onde entra o valor de uma cobrança paga quando o lançamento está sem conta (veja abaixo).
- Os botões Sincronizar cobranças, Importar assinaturas, Vincular clientes e Extrato.
- Cobranças sem lançamento: cobranças que estão no Asaas e ainda não têm lançamento no Coconut.
Categoria das cobranças
Defina a Categoria padrão das cobranças logo depois de conectar e clique em Salvar. Sem ela, o que entra do Asaas pode chegar sem categoria. A ordem é esta: a categoria que você escolhe na hora (no formulário ou na sincronização) vale primeiro; depois, a Categoria de receita do cadastro do cliente; por último, a padrão.
Conta que recebe do Asaas
No card Conta que recebe do Asaas, escolha a conta bancária que representa o dinheiro parado no Asaas e clique em Salvar. Quando uma cobrança é paga e o lançamento está sem conta, o valor entra nessa conta. Com Nenhuma, o lançamento fica pago sem somar em conta nenhuma.
Quem pode fazer o quê
- Conectar e desconectar a conta e usar Reativar recebimento: só o dono e administradores.
- Emitir cobranças, criar assinaturas e emitir notas: qualquer membro, depois que a conta estiver conectada.
- Visualizador: só consulta.
Vincular clientes
Você não precisa cadastrar ninguém no Asaas à mão. Na primeira cobrança de um cliente, o Coconut procura no Asaas alguém com o mesmo CPF/CNPJ. Se achar, reaproveita; se não, cria. Depois disso, as próximas cobranças usam o mesmo cadastro.
Vão para o Asaas o nome, e-mail, CPF ou CNPJ, celular e endereço. Se você editar um cliente que já está vinculado, a mudança também é enviada ao Asaas.
Já tinha clientes no Asaas?
Use o assistente Vincular clientes do Asaas. Ele abre pelo botão Vincular do Asaas, em Clientes , ou por Vincular clientes, em Configurações Asaas . O assistente separa os clientes em três grupos:
- Automáticos (casados por CPF/CNPJ): o documento bate dos dois lados. Já vêm marcados.
- Confirmar (nomes parecidos, sem CPF/CNPJ para casar): o assistente sugere o par e você decide um por um. “João da Silva” e “Joao Silva ME” podem ou não ser a mesma pessoa.
- Sem correspondência: clientes do Asaas sem par no Coconut. Para cada um, você escolhe Criar novo no Coconut ou vincula a um cliente seu.
Confira e clique em Aplicar. Ao vincular, o assistente completa o cadastro nos dois sentidos: campo vazio de um lado é preenchido com o que está do outro (Asaas para Coconut ou Coconut para Asaas). Nada que já está preenchido é sobrescrito sem você decidir: quando um campo está preenchido diferente nos dois lados, o assistente mostra a divergência e você escolhe qual valor vale (ou mantém os dois). Ele também cria os clientes que você mandar criar.
Cobrança avulsa
A cobrança sempre sai de um lançamento de receita em aberto ou vencido. Dois jeitos de começar:
- Ao criar a receita, marque Cobrar pela Asaas depois de salvar.
- Numa receita que já existe, abra o menu da linha em Lançamentos Contas a Receber e clique em Criar cobrança.
O Coconut abre o diálogo certo conforme o lançamento:
- Lançamento sozinho (à vista, ou parcela sem outras em aberto): abre Criar cobrança avulsa.
- Lançamento com outros relacionados em aberto (como as parcelas seguintes): abre Criar cobrança e pergunta se é Só este lançamento ou Este e os relacionados em aberto.
- Recorrente: abre Criar cobrança recorrente, que vira uma assinatura (veja Assinatura).
- 1 Confira Cliente, Valor e Vencimento, que vêm do lançamento.
- 2 Escolha a Forma de pagamento: PIX, Boleto ou Cartão de crédito.
- 3 Se quiser, ajuste a Descrição e as notificações ao cliente. Com a NFS-e habilitada, dá para marcar Emitir nota fiscal desta cobrança.
- 4 Clique em Criar cobrança.
Para ver a cobrança depois, abra o menu do lançamento e clique em Ver cobrança Asaas. Em Detalhes da cobrança estão o status, o botão Copiar link da fatura para mandar ao cliente e as ações da cobrança. Na lista de Lançamentos, a receita cobrada ganha o selo Asaas, e o filtro Origem → Cobrança da Asaas mostra só essas. O que o cliente vê ao abrir o link está em Link de pagamento.
Quando o cliente paga
O lançamento vira Pago com a data do pagamento, e o valor entra na conta bancária do lançamento (ou, se ele estiver sem conta, na Conta que recebe do Asaas). Sem baixa manual.
No cartão de crédito, a data que vale é a do repasse, o dia em que o Asaas põe o dinheiro na sua conta, e não o dia em que o cliente passou o cartão. Por isso a receita pode cair no mês seguinte ao da compra. Cartão parcelado: cada parcela cai no mês do próprio repasse.
Se o cliente pagou por fora de outro jeito (outro banco, espécie), veja Cancelar, estornar e receber em dinheiro.
Assinatura
Para mensalidade e outras cobranças que se repetem, o Coconut cria uma assinatura no Asaas, e o Asaas passa a gerar a cobrança de cada período sozinho. A assinatura sempre nasce de um lançamento recorrente de receita.
Criar a assinatura
- 1 No lançamento recorrente, abra o menu e clique em Criar cobrança. Abre Criar cobrança recorrente.
- 2 Confira Cliente, Valor por cobrança, Periodicidade e Descrição, que vêm do lançamento.
- 3 Escolha a Forma de pagamento. É o único campo obrigatório.
- 4 Se quiser, abra Juros, multa e desconto (opcional) e as notificações ao cliente.
- 5 Clique em Criar assinatura.
As periodicidades aceitas são semanal, quinzenal, mensal, trimestral, semestral e anual, sempre a mesma do lançamento.
A assinatura só cobra vencimentos daqui para a frente: o diálogo lista as datas que ela vai cobrar e avisa quando algum vencimento da série já passou. Esses ficam fora da assinatura; para cobrá-los, crie uma cobrança avulsa no lançamento. Se a série não tem nenhum vencimento futuro, não dá para criar a assinatura.
Em Juros, multa e desconto (opcional) você define Juros ao mês (%), Multa por atraso (Percentual ou Valor fixo) e Desconto (Percentual ou Valor fixo), com um prazo de até 30 dias antes do vencimento para o desconto valer.
O que aparece no Coconut
A assinatura vira uma série de lançamentos recorrentes. Cada cobrança que o Asaas gera cai no lançamento do mês correspondente, sem duplicar. Na página do cliente, o card Assinaturas do Asaas mostra as assinaturas dele.
Assinatura criada direto no painel do Asaas também entra sozinha: o Coconut a transforma numa série em Lançamentos.
Gerenciar a assinatura
Com a assinatura ativa, o menu do lançamento troca Criar cobrança por Gerenciar assinatura, com:
- Nota fiscal automática: Ligar nota automática (ou Alterar nota automática), para o Asaas emitir sozinho a nota de cada cobrança. Veja Nota fiscal automática.
- Pausar.
- Reativar, escolhendo o Próximo vencimento.
- Editar valor, com a opção Aplicar também às cobranças pendentes já geradas.
- Cancelar assinatura, que encerra a série.
- Desvincular do lançamento, que só desfaz a ligação e não cancela a assinatura no Asaas.
Usar Encerrar recorrência no lançamento também cancela a assinatura no Asaas: o cliente para de receber cobranças novas, e as já emitidas continuam valendo.
Já tinha a assinatura no Asaas?
Ao abrir Criar cobrança recorrente, o Coconut confere se o cliente já tem assinatura ativa no Asaas. Se tiver, ela aparece em Assinaturas já ativas no Asaas com o botão Importar e vincular. Use esse botão em vez de criar outra. Para trazer várias de uma vez, use Importar assinaturas em Configurações Asaas .
Sincronizar cobranças
A sincronização traz para o Coconut cobranças que estão no Asaas, como o histórico de antes da integração. Ela fica em Configurações Asaas , no botão Sincronizar cobranças.
- 1 Clique em Sincronizar cobranças. Se houver clientes do Asaas ainda sem vínculo, aparece um aviso com Revisar vínculos (abre o assistente) ou Continuar.
- 2 Escolha Quantidade, Ordem e, se quiser, Status e Período de vencimento. Clique em Analisar.
- 3 A prévia mostra quantas cobranças são novas (viram lançamento) e quantas já existem (só atualizam status e valor).
- 4 Escolha a Categoria para todos os novos lançamentos. Em cada linha, dá para trocar a categoria, ligar a um lançamento que você já tem ou desmarcar o que não quer trazer.
- 5 Clique em Sincronizar para aplicar.
Rodar de novo não duplica nada. E o Coconut tenta ligar cada cobrança a um lançamento seu antes de criar outro: procura receita em aberto do mesmo cliente no mesmo mês, com preferência para o mesmo valor (aceita até 5% de diferença quando só existe um candidato). Se dois lançamentos batem, desempata pelo dia do vencimento; se ainda assim não der para saber qual é, não liga nenhum e avisa você.
Cobranças sem lançamento
Cobrança criada direto no painel do Asaas chega ao Coconut sozinha. O Coconut liga a cobrança a uma receita em aberto do cliente no mês ou cria o lançamento. Quando não dá para ligar com segurança (por exemplo, o cliente já tem outra receita naquele mês), ela fica no card Cobranças sem lançamento, em Configurações Asaas .
Em cada cobrança do card, escolha o lançamento que já existe e clique em Ligar. Enquanto não for ligada, essa cobrança não aparece no seu fluxo de caixa.
Notificações ao cliente
O Asaas pode avisar o cliente por E-mail, WhatsApp e SMS quando a cobrança é gerada, antes do vencimento, quando o pagamento é confirmado e quando a cobrança vence. Você configura isso ao criar a cobrança ou depois, no botão Notificações de Detalhes da cobrança.
Os eventos e prazos estão em Avisos de cobrança ao cliente.
Cancelar, estornar e receber em dinheiro
Em Detalhes da cobrança (menu do lançamento → Ver cobrança Asaas), as ações aparecem conforme o status:
| Ação | Quando aparece | O que acontece |
|---|---|---|
| Receber em dinheiro | Cobrança em aberto ou vencida | A cobrança fica como recebida em dinheiro no Asaas e o lançamento vira Pago, com o valor na conta de dinheiro em espécie. |
| Editar | Só cobrança pendente | Muda Valor e Data de vencimento; o lançamento acompanha. |
| Estornar | Só cobrança paga | O Asaas devolve o dinheiro ao cliente, a cobrança fica Estornado e o lançamento volta a ficar em aberto, com o valor saindo da conta. |
| Cancelar cobrança | Cobrança em aberto ou vencida | Cancela no Asaas (o link para de aceitar pagamento) e o lançamento fica Cancelado. |
| Notificações | Cobrança em aberto, vencida ou paga (não aparece em cancelada nem estornada) | Ajusta os avisos do cliente. |
Outras situações:
- Quer manter a cobrança no Asaas, mas soltar do lançamento? Use Desvincular cobrança no menu do lançamento (só com cobrança ainda não paga).
- Excluir um lançamento com cobrança não apaga o lançamento: o diálogo vira Cancelar Lançamento, o botão Cancelar no Asaas cancela a cobrança lá e o lançamento fica Cancelado, não é excluído. Com assinatura, a assinatura para de gerar cobranças e a série é encerrada.
- Quitou no Coconut um lançamento com cobrança em aberto? A cobrança também fica como recebida em dinheiro no Asaas (exceto quando você usa Quitar com este PIX). Entenda em Quitar lançamento com cobrança no Asaas.
Cobrança com nota fiscal
Ao cancelar uma cobrança que tem NFS-e (por Cancelar cobrança ou excluindo o lançamento), o Coconut abre antes o passo Esta cobrança tem nota fiscal, com as notas ligadas a ela e o status de cada uma. Você escolhe:
- Manter a cobrança: não muda nada.
- Cancelar só no Coconut: o lançamento fica cancelado e a cobrança continua valendo no Asaas, com a nota. Se o cliente pagar, você recebe um aviso para decidir o que fazer com a receita. Ao excluir um lançamento, essa opção não aparece quando há assinatura envolvida.
- Cancelar cobrança e nota: cancela a cobrança no Asaas, e o Asaas cancela a nota junto.
Extrato e saldo
O botão Extrato fica em Relatórios Asaas e em Configurações Asaas . Ele abre o Extrato da conta Asaas, com as entradas e saídas e o saldo em cada linha. A aba Asaas de Relatórios mostra ainda o saldo e a situação atual das cobranças. Mais detalhes em Extrato e saldo da conta Asaas.
NFS-e (nota fiscal de serviço)
A NFS-e tem tela própria: Notas Fiscais, no menu, com as abas Notas e Configurações. Antes da primeira nota, preencha os dados fiscais e o serviço padrão em Notas Fiscais Configurações . Os campos, a emissão avulsa, em lote e o status das notas estão em Notas fiscais.
Com o Asaas, a nota pode sair de três jeitos:
- Na criação da cobrança: ao criar a cobrança avulsa, marque Emitir nota fiscal desta cobrança (ou Emitir nota fiscal de cada cobrança, quando são várias) e escolha Quando emitir. A nota fica agendada junto com a cobrança. Detalhes em Nota fiscal automática.
- Na assinatura: em Gerenciar assinatura, ligue a Nota fiscal automática e o Asaas emite a nota de cada cobrança sozinho. Veja Nota fiscal automática.
- Depois, pelo lançamento: no menu de uma receita, Emitir nota fiscal, para emitir agora ou agendar. Depois de emitida, o menu mostra Visualizar nota fiscal. Em Detalhes da cobrança ficam também Atualizar status, Cancelar NFS-e e Reemitir NFS-e (quando a nota anterior deu erro ou foi cancelada).
Desde 01/10/2026, empresas fora do Simples Nacional precisam informar os códigos da reforma tributária (IBS/CBS) na nota. Veja Reforma tributária (IBS/CBS) na NFS-e.
Status da cobrança
Em Detalhes da cobrança você vê um destes status:
- Pendente: emitida, aguardando pagamento.
- Pago: pagamento confirmado.
- Vencido: passou do vencimento sem pagamento.
- Cancelado: cancelada pelo Coconut ou no Asaas.
- Estornado: o valor foi devolvido ao cliente.
- Estorno em andamento: o estorno foi pedido e ainda não terminou.
- Chargeback: o cliente contestou o pagamento no cartão.
Cobrança de assinatura mostra também o selo Recorrente.
Limitações
- Split de pagamento e antecipação de recebíveis são feitos no painel do Asaas.
- A taxa do Asaas não vira despesa sozinha: o lançamento fica pelo valor bruto.
- NFS-e é só para serviço (não emite nota de produto).
- Saque e transferência nunca são feitos pelo Coconut.
Custos
O Coconut não cobra nada a mais por transação. As taxas são as da sua conta Asaas, conforme o plano que você tem com eles.