Crie um parcelamento pelo Google Sheets com o Make

Use este template para criar parcelamentos no Asaas a partir de novas linhas adicionadas ao Google Sheets.

O cenário consulta o cliente antes da criação, cadastra-o quando necessário e cria as cobranças vinculadas ao parcelamento, incluindo Split de Pagamentos quando configurado.

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 o parcelamento.

No Make, utilize:

• Real para Produção;
• Sandbox para testes.

As chaves de Sandbox e Produção são diferentes.

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 o parcelamento"]
    E --> F

    F --> G["Gerar as parcelas"]
    G --> H["Validar as cobranças"]

    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,G validacao
    class H 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

Ao criar o parcelamento, o Asaas gera as cobranças correspondentes às parcelas. Cada uma possui seu próprio ID, vencimento, valor e ciclo de pagamento.

1. Prepare a planilha

Utilize a planilha modelo e faça uma cópia para o seu Google Drive.

A planilha fornece os dados utilizados pelo cenário, como:

Exemplo:

Se alterar a estrutura da planilha, revise também os campos mapeados no cenário.

2. Abra o template

Acesse:

Create an installment charge with Asaas from a new Google Sheets row

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 Google Sheets:

1. selecione Create a Connection;
2. informe um nome para a conexão;
3. autentique sua conta Google;
4. selecione a planilha armazenada no Google Drive;
5. configure a localização da planilha.

O módulo Google Sheets (Watch New Rows) inicia o cenário quando identifica uma nova linha.

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

O template utiliza os seguintes componentes:

O app atual do Asaas no Make também possui o módulo Criar uma cobrança parcelada. Porém, o template documentado nesta página utiliza Fazer uma chamada API nos ajustes necessários para o fluxo com Split.

6. Revise o parcelamento

Antes de executar o cenário, confirme:

• cliente;
• valor total;
• quantidade de parcelas;
• vencimento inicial;
• referência interna;
• configuração de Split, quando utilizada.

Na API do Asaas, uma cobrança parcelada utiliza duas ou mais parcelas. O valor pode ser definido pelo total da operação ou pelo valor individual das parcelas.

Para conhecer as regras completas, consulte Criar uma cobrança parcelada.

Split no parcelamento

O Split pode ser configurado de diferentes formas:

No Split percentual, o cálculo ocorre sobre o netValue de cada parcela.

Consulte Split em parcelamentos.

7. Valide o cenário

Antes de utilizar o ambiente Real:

1. configure a conexão em Sandbox;
2. adicione uma linha com dados controlados;
3. confirme se o cliente correto foi localizado ou criado;
4. valide o valor e a quantidade de parcelas;
5. confira o primeiro vencimento;
6. revise o Split, quando utilizado;
7. execute o cenário;
8. confirme as cobranças geradas no Asaas.

Resultado esperado

A linha deve resultar em um parcelamento vinculado ao cliente correspondente.

O Asaas deve gerar as cobranças das parcelas conforme a quantidade e os valores configurados.

Antes de reprocessar uma linha, confirme se o parcelamento já foi criado. Execuções repetidas podem gerar novos parcelamentos.

Acompanhe as parcelas por Webhooks

Cada parcela possui seu próprio ciclo de cobrança.

Use os Eventos para cobranças para acompanhar recebimentos, vencimentos, estornos e outras mudanças de status sem realizar consultas recorrentes à API.

Nos eventos de cobranças pertencentes a um parcelamento, o campo installment identifica o parcelamento de origem.

Quando houver Split, acompanhe:

PAYMENT_SPLIT_DONE

O evento é disparado individualmente para cada Split liquidado. Como cada parcela possui seu próprio processamento, um parcelamento pode gerar diferentes eventos conforme as parcelas forem recebidas.

Utilize additionalInfo.splitId para identificar o Split correspondente.

Erros comuns

Consulte o histórico de execução do Make para identificar em qual módulo ocorreu a falha.

Próximos passos

• Volte aos templates do Make
• Entenda como criar uma cobrança parcelada
• Configure Split em parcelamentos
• Acompanhe os eventos das cobranças
• Consulte o FAQ do Make