Crie uma assinatura pelo Google Sheets com o Make

Use este template para criar assinaturas 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 a assinatura com as configurações definidas no fluxo, incluindo Split de Pagamentos quando utilizado.

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 assinatura.

No Make, utilize:

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

As credenciais dos dois ambientes 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 a assinatura"]
    E --> F

    F --> G["Gerar cobranças recorrentes"]

    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

Após a criação da assinatura, o Asaas gera novas cobranças conforme a periodicidade configurada. As cobranças futuras não são criadas todas de uma vez.

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:

Se alterar a estrutura da planilha, revise também os campos mapeados nos módulos do Make.

2. Abra o template

Acesse:

Criação de assinatura 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 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. informe a localização solicitada pelo módulo.

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 a credencial, consulte Chaves de API.

5. Revise os módulos

O template utiliza os seguintes componentes:

No template documentado atualmente, a criação da assinatura com Split utiliza Fazer uma chamada API.

A API do Asaas aceita split na criação da assinatura. Cada nova cobrança gerada pela recorrência recebe a configuração de Split definida na assinatura.

Consulte o endpoint Criar nova assinatura.

Entenda o Split em assinaturas.

6. 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 valor, periodicidade e primeiro vencimento;
5. revise os recebedores e valores do Split, quando utilizado;
6. execute o cenário;
7. confirme a assinatura criada no Asaas.

Resultado esperado

A linha deve resultar na criação de uma assinatura vinculada ao cliente correspondente.

A assinatura deve permanecer configurada para gerar novas cobranças conforme a periodicidade e o primeiro vencimento informados.

A criação da assinatura não confirma o recebimento de nenhuma cobrança.

Antes de reprocessar uma linha, confirme se a assinatura já foi criada. O Make não garante idempotência automaticamente.

Acompanhe a recorrência por Webhooks

A assinatura e as cobranças geradas possuem ciclos diferentes.

Use os Eventos para assinaturas para acompanhar alterações na recorrência, como criação, atualização, inativação ou remoção.

Use os Eventos para cobranças para acompanhar cada cobrança gerada e seu ciclo financeiro.

Quando uma cobrança da assinatura é criada, PAYMENT_CREATED contém o campo subscription, que identifica a recorrência de origem.

Se utilizar Split, acompanhe também PAYMENT_SPLIT_DONE para confirmar a liquidação de cada Split das cobranças geradas.

Prefira Webhooks a consultas recorrentes para sincronizar mudanças de estado.

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 o Split em assinaturas
• Acompanhe os eventos de assinaturas
• Acompanhe os eventos das cobranças
• Consulte o FAQ do Make