Criar uma cobrança avulsa à partir de uma linha no Google Sheets
Crie uma cobrança pelo Google Sheets com o Make
Use este template para criar cobranças no Asaas a partir de novas linhas adicionadas ao Google Sheets.
O cenário consulta o cliente antes da criação e pode criar o cadastro quando ele ainda não existir. A cobrança também pode incluir Split de Pagamentos conforme os dados configurados.
Antes de começar
Tenha:
- uma conta no Make;
- uma conta Asaas ativa;
- uma API Key válida;
- uma conta Google com acesso ao Google Drive;
- a planilha modelo;
- os dados necessários para criar o cliente e a cobrança.
ImportanteO 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.
Durante a configuração, utilize:
- Sandbox para testes;
- Real para Produção.
Como funciona
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Adicionar linha no Google Sheets"] --> B["Consultar cliente no Asaas"]
B --> C{"Cliente encontrado?"}
C --> Sim(("Sim"))
C --> Nao(("Não"))
Sim --> D["Utilizar o ID existente"]
Nao --> E["Criar o cliente"]
D --> F["Criar a cobrança com Split"]
E --> F
F --> G["Validar a cobrança criada"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px
class A inicio
class C decisao
class B,D,E,F validacao
class G sucesso
class Sim respostaSim
class Nao respostaNao
linkStyle default stroke:#94A3B8,stroke-width:2px
linkStyle 2 stroke:#22C55E,stroke-width:4px
linkStyle 3 stroke:#EF4444,stroke-width:4px
O cenário consulta o cliente antes de criar um novo cadastro. Se encontrar um cliente correspondente, reutiliza o ID; caso contrário, cria o cliente antes da cobrança.
1. Prepare a planilha
Utilize a planilha modelo e faça uma cópia no seu Google Drive.
A planilha deve fornecer os dados utilizados pelo cenário, como:
| Informação | Finalidade |
|---|---|
| Nome do cliente | Cadastro do pagador |
| CPF/CNPJ | Identificação e consulta do cliente |
| Dados do cliente e notificações | |
| Valor da cobrança | Valor a ser cobrado |
| Vencimento | Data de vencimento |
| Dados de Split | Distribuição dos valores |
| Referência interna | Controle da operação |
Se alterar colunas, nomes ou posições utilizadas pelo template, revise também o mapeamento dos módulos no Make.
2. Abra o template no Make
Acesse o template:
Criação de cobrança única com Split de Pagamentos
Caso ainda não possua uma conta, cadastre-se no Make.
Depois de abrir o template, clique em Start Guided Setup.
3. Conecte o Google Sheets
Na configuração do módulo Google Sheets:
- selecione Create a Connection;
- informe um nome para a conexão;
- autentique sua conta Google;
- selecione a planilha armazenada no Google Drive;
- informe a localização da planilha solicitada pelo módulo.
O módulo Google Sheets (Watch New Rows) monitora novas linhas e inicia o cenário.
4. Configure a conexão com o Asaas
No campo Environment, selecione:
- Real para Produção; ou
- Sandbox para testes.
Depois, informe a API Key correspondente ao ambiente.
Se precisar criar ou gerenciar uma credencial, consulte Chaves de API.
5. Revise os módulos do cenário
O template utiliza os seguintes componentes:
| Módulo | Função |
|---|---|
| Google Sheets (Watch New Rows) | Inicia o cenário quando uma nova linha é identificada |
| Asaas - Listar clientes | Consulta se o cliente já está cadastrado |
| Router | Direciona o fluxo conforme o resultado da consulta |
| Asaas - Criar cliente | Cria o cliente quando nenhum cadastro correspondente é encontrado |
| Asaas - Criar cobrança com split | Cria a cobrança com os dados mapeados |
| Asaas - Fazer uma chamada API | Permite acessar endpoints adicionais quando necessário |
O cenário consulta o cliente previamente pelo CPF/CNPJ para decidir se utiliza um cadastro existente ou cria um novo.
6. Valide o cenário
Antes de utilizar o ambiente Real:
- configure a conexão em Sandbox;
- adicione uma linha com dados controlados na planilha;
- confirme se o cliente correto foi localizado ou criado;
- valide os dados da cobrança;
- confira as regras de Split, quando utilizadas;
- confirme a cobrança criada no Asaas.
Resultado esperado
A nova linha deve resultar em uma cobrança no Asaas vinculada ao cliente correspondente.
Se o cliente ainda não existir, o cenário deve criá-lo antes da cobrança.
AtençãoO cenário não implementa idempotência automaticamente. Recomenda-se utilizar referências internas ou validações adicionais para evitar cobranças duplicadas.
Antes de reprocessar uma linha, confirme se a cobrança já foi criada. Execuções repetidas podem gerar novas cobranças.
Erros comuns
| Situação | O que verificar |
|---|---|
| Falha de autenticação | Environment e API Key utilizada |
| Cliente não localizado corretamente | CPF/CNPJ e dados mapeados |
| Cobrança não criada | Campos obrigatórios e execução dos módulos anteriores |
| Cobrança duplicada | Reprocessamento da mesma linha e controles internos |
| Erro no Split | Dados de distribuição e regras aplicáveis ao Split |
| Cenário parou após alteração da planilha | Colunas e mapeamentos utilizados pelos módulos |
Consulte o histórico de execução do Make para identificar em qual módulo ocorreu a falha.
Acompanhe o pagamento
A criação da cobrança encerra o fluxo deste template.
Se você estender o cenário para reagir a recebimentos, vencimentos, estornos ou outras mudanças da cobrança, utilize Webhooks em vez de consultas recorrentes à API.
Próximos passos
Updated 10 days ago