Criar uma cobrança avulsa à partir de uma linha no Google Sheets

Este template permite automatizar a criação de cobranças no Asaas a partir do preenchimento de uma linha em uma planilha do Google Sheets.

Sempre que uma nova linha for adicionada na planilha monitorada pelo Make, o cenário poderá localizar ou criar o cliente no Asaas e gerar automaticamente uma cobrança, incluindo configuração de split de pagamentos quando necessário.

Esse modelo é indicado para operações que desejam centralizar informações em planilhas e automatizar processos financeiros sem necessidade de desenvolvimento.

Quando utilizar

Este template é recomendado para:

• criação automática de cobranças a partir de formulários ou planilhas;
• operações que utilizam Google Sheets como origem dos dados;
• processos comerciais que necessitam de split de pagamentos;
• integrações sem necessidade de desenvolvimento próprio;
• automações que utilizam Make como plataforma principal.

Dependências para utilização

Antes de configurar o template, é necessário:

• possuir uma conta no Make;
• possuir uma conta Asaas ativa;
• possuir uma API Key válida;
• possuir uma conta Google;
• possuir acesso ao Google Drive;
• utilizar a planilha modelo;
• possuir os dados necessários para criação do cliente e da cobrança.

📘

Importante

O ambiente selecionado no Make deve corresponder à API Key utilizada. Chaves de Sandbox funcionam apenas no ambiente Sandbox e chaves de Produção funcionam apenas no ambiente Real.

Fluxo da integração

O cenário segue o fluxo abaixo:

Nova linha no Google Sheets
↓
Make identifica os dados
↓
Consulta cliente no Asaas
↓
Cliente existe?
↓
Sim → Criar cobrança
Não → Criar cliente → Criar cobrança
↓
Cobrança criada com split

Regras importantes

Para criação correta das cobranças, é importante observar que:

• o cliente deve possuir informações válidas;
• valores da cobrança devem ser válidos;
• o split deve respeitar as regras configuradas na conta;
• clientes duplicados são evitados através da consulta prévia pelo CPF/CNPJ;
• alterações na estrutura da planilha podem exigir ajustes no cenário;
• cobranças criadas em ambiente Real possuem efeito financeiro real.

Parâmetros importantes

A planilha utilizada pelo cenário deve conter informações necessárias para criação dos recursos.

Normalmente são utilizados campos como:

📘

Importante

A estrutura da planilha pode ser personalizada conforme a necessidade da integração.

Configuração do template

Para iniciar a construção do fluxo, faça o download da planilha modelo disponibilizada aqui e faça o upload para o seu Google Drive.

Caso prefira, é possível apenas realizar uma cópia direta da planilha.

1º Passo

Acesse o template do Make clicando aqui.

2º Passo

Caso ainda não possua uma conta no Make, realize o cadastro através do link:

https://www.make.com/en/register

Após acessar o template, clique em Start Guided Setup.

3º Passo

Conecte sua conta Google.

Selecione Create a Connection, informe um nome para a conexão e realize a autenticação utilizando sua conta Google.

4º Passo

Selecione a planilha hospedada no Google Drive.

5º Passo

Informe a localização da planilha e finalize a configuração do módulo Google Sheets.

6º Passo

Configure a conexão com o Asaas.

No campo Environment, selecione:

• Real (Produção); ou
• Sandbox.

Em seguida, informe sua API Key.

Após concluir esse processo, o cenário estará pronto para utilização.

Exemplo de utilização

Um fluxo comum consiste em:

Google Forms
↓
Google Sheets
↓
Make
↓
Asaas
↓
Cobrança criada
↓
Notificação no Slack

Outros módulos podem ser adicionados ao cenário para atender necessidades específicas.

Comportamentos importantes

A execução ocorre em sequência.

Durante o processamento:

• o Make consulta se o cliente já existe;
• caso o cliente não exista, ele será criado;
• somente após a criação ou localização do cliente a cobrança será criada;
• falhas em módulos intermediários interrompem o fluxo;
• chamadas repetidas podem gerar novas cobranças caso não existam validações adicionais.

🚧

Atenção

O cenário não implementa idempotência automaticamente. Recomenda-se utilizar referências internas ou validações adicionais para evitar cobranças duplicadas.

Módulos presentes na integração

Google Sheets (Watch New Rows)

Monitora novas linhas inseridas na planilha e inicia a execução do cenário.

Asaas - Listar clientes

Verifica se o cliente já está cadastrado no Asaas.

Asaas - Criar cliente

Realiza o cadastro quando o cliente ainda não existe.

Asaas - Criar cobrança com split

Cria a cobrança utilizando as configurações informadas.

Asaas - Fazer uma chamada API

Permite utilizar endpoints adicionais da API do Asaas.

Documentação:

https://docs.asaas.com/

Router

Controla o fluxo do cenário.

Caminho 1

Cliente já existe:

Google Sheets
↓
Listar cliente
↓
Criar cobrança

Caminho 2

Cliente não existe:

Google Sheets
↓
Criar cliente
↓
Criar cobrança

Impactos operacionais

Quando o ambiente Real é utilizado:

• cobranças reais serão criadas;
• notificações poderão ser enviadas aos clientes;
• splits financeiros serão processados normalmente;
• alterações incorretas podem gerar cobranças indevidas.

Por esse motivo, recomenda-se validar o cenário em Sandbox antes da publicação.

Boas práticas

• Teste inicialmente em Sandbox.
• Utilize uma planilha exclusiva para o cenário.
• Evite alterar a estrutura da planilha sem revisar os módulos.
• Monitore os logs do Make.
• Implemente validações para evitar duplicidades.
• Utilize referências internas para rastreamento.
• Revise periodicamente o funcionamento do cenário.

Conteúdos relacionados

• Templates do Make;
• Vantagens e funcionalidades do Make;
• Criar clientes;
• Criar cobranças;
• Split de pagamentos;
• Webhooks;
• Limites da API.