Criar um parcelamento a partir de uma linha no Google Sheets

Este template permite automatizar a criação de cobranças parceladas no Asaas utilizando informações inseridas em uma planilha do Google Sheets.

Sempre que uma nova linha for adicionada à planilha monitorada pelo Make, o cenário poderá localizar ou criar o cliente e criar automaticamente um parcelamento, inclusive com split de pagamentos quando necessário.

Essa abordagem é indicada para operações que desejam automatizar vendas parceladas sem necessidade de desenvolvimento.

Quando utilizar

Este template é recomendado para:

• vendas parceladas;
• operações recorrentes de cadastro de cobranças;
• integrações entre Google Sheets e Asaas;
• parcelamentos com split de pagamentos;
• fluxos automatizados sem desenvolvimento.

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 acesso ao Google Drive;
• possuir uma conta Google;
• utilizar a planilha modelo;
• possuir os dados necessários para criação do cliente e do parcelamento.

📘

Importante

O ambiente configurado no Make deve corresponder à API Key utilizada.

Fluxo da integração

Nova linha no Google Sheets
↓
Make identifica os dados
↓
Consultar cliente
↓
Cliente existe?
↓
Sim → Criar parcelamento
Não → Criar cliente → Criar parcelamento
↓
Parcelamento criado
↓
Cobranças são geradas automaticamente

Regras importantes

Para criação correta do parcelamento:

• o cliente deve possuir dados válidos;
• os valores informados devem ser consistentes;
• o número de parcelas deve estar dentro das regras permitidas;
• alterações na estrutura da planilha podem exigir ajustes no cenário;
• parcelamentos criados em ambiente Real possuem efeito financeiro real.

🚧

Atenção

Parcelamentos criados em Produção podem gerar notificações e cobranças reais aos clientes.

Parâmetros importantes

A planilha normalmente contém:

Exemplo de preenchimento

Configuração do template

Faça o download da planilha modelo:

https://docs.google.com/spreadsheets/d/1tQXPy4h04JACJWHR3gO_vNaxvSx0EsgTaIuHrKuyt-U/edit?gid=0#gid=0

Caso prefira, faça uma cópia para o Google Drive.

1º Passo

Acesse o template:

https://us1.make.com/templates/11919-create-a-installment-charge-with-asaas-from-a-new-google-sheets-row

2º Passo

Caso ainda não possua conta no Make, realize o cadastro:

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 e realize o login.

4º Passo

Selecione a planilha hospedada no Google Drive.

5º Passo

Configure a localização da planilha.

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 isso, o cenário estará pronto para utilização.

Comportamentos importantes

Durante a execução:

• o Make verifica se o cliente já existe;
• caso o cliente não exista, ele será criado;
• o parcelamento é criado apenas após a identificação do cliente;
• falhas em módulos interrompem o fluxo;
• execuções repetidas podem gerar parcelamentos duplicados.

🚧

Atenção

Recomenda-se utilizar referências internas para evitar operações duplicadas.

Módulos presentes na integração

Google Sheets (Watch New Rows)

Monitora novas linhas adicionadas na planilha.

Asaas - Listar clientes

Verifica se o cliente já está cadastrado.

Asaas - Criar cliente

Realiza o cadastro caso o cliente ainda não exista.

Asaas - Fazer uma chamada API

Atualmente, para criação de parcelamentos com split de pagamentos, alguns ajustes exigem chamadas diretas à API do Asaas.

Documentação:

https://docs.asaas.com/

Router

Controla o fluxo da integração.

Caminho 1

Cliente já cadastrado:

Google Sheets
↓
Localizar cliente
↓
Criar parcelamento

Caminho 2

Cliente não cadastrado:

Google Sheets
↓
Criar cliente
↓
Criar parcelamento

Impactos operacionais

Quando utilizado em ambiente Real:

• parcelamentos reais serão criados;
• notificações poderão ser enviadas aos clientes;
• cobranças futuras serão geradas automaticamente;
• erros de configuração podem gerar cobranças indevidas.

Por esse motivo, recomenda-se testar inicialmente em Sandbox.

Erros comuns

API Key inválida

A chave utilizada não corresponde ao ambiente selecionado.

Cliente não encontrado

Pode ocorrer quando os dados informados estão incorretos.

Parcelamentos duplicados

Pode ocorrer devido à ausência de validações adicionais.

Erros no split

Podem ocorrer quando a configuração de distribuição é inválida.

Problemas na planilha

Alterações na estrutura das colunas podem impedir o funcionamento correto do cenário.

Boas práticas

• Teste inicialmente em Sandbox.
• Monitore os logs do Make.
• Utilize referências internas para evitar duplicidades.
• Revise periodicamente os cenários.
• Evite alterar a estrutura da planilha sem revisar os módulos.
• Documente customizações realizadas.

Conteúdos relacionados

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