Split Asaas no Pluga

Crie cobranças com Split no Asaas por meio de uma automação da Pluga, sem desenvolver uma integração própria.

A ferramenta de origem pode ser o Google Sheets ou outro sistema compatível com o modelo de automação escolhido.

Antes de começar

Tenha:

• uma conta ativa no Asaas;
• uma conta na Pluga;
• uma ferramenta de origem para os dados da cobrança;
• acesso à conta Asaas que criará as cobranças;
• os recebedores e a regra de divisão definidos;
• os walletIds dos recebedores, quando utilizados no modelo.

O Split pode utilizar valor fixo ou percentual. O percentual é calculado sobre o valor líquido da cobrança (netValue).

Se precisar recuperar o identificador de uma conta, consulte Recuperar WalletId.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Preparar os dados"] --> B["Configurar o gatilho"]
    B --> C["Conectar o Asaas"]
    C --> D["Mapear a cobrança"]
    D --> E["Configurar o Split"]
    E --> F["Finalizar a automação"]
    F --> G["Criar cobrança de teste"]
    G --> H["Validar os repasses"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,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

    class A inicio
    class B,C,D,E,F,G validacao
    class H sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

1. Prepare os dados

Organize as informações necessárias para criar a cobrança e configurar o Split.

Quando utilizar planilha como origem, separe cada informação em uma coluna própria.

2. Configure o gatilho

No painel da Pluga:

1. crie uma nova automação;
2. escolha a ferramenta de origem, como Google Sheets;
3. selecione a planilha ou recurso que contém os dados;
4. escolha o modelo que cria uma cobrança no Asaas;
5. defina quando a automação deve ser executada.

Configure o gatilho para disparar somente depois que todos os dados necessários estiverem preenchidos.

Por exemplo, uma coluna de controle pode iniciar a criação da cobrança somente quando receber um valor específico, como Sim.

3. Conecte o Asaas

Selecione o Asaas como ferramenta de destino e escolha a ação de criação de cobrança.

Conecte a conta conforme o fluxo de autenticação apresentado pela Pluga.

4. Mapeie a cobrança

Associe os dados da ferramenta de origem aos campos utilizados pelo modelo da Pluga.

Revise principalmente:

• cliente;
• valor;
• vencimento;
• forma de pagamento;
• descrição;
• referência da venda, quando utilizada.

Os campos disponíveis dependem da automação selecionada.

5. Configure o Split

Habilite Split de Pagamento na configuração da cobrança.

Escolha como identificar os recebedores conforme as opções disponíveis no modelo:

• subcontas já cadastradas; ou
• walletId.

Depois, defina o repasse por:

• valor fixo;
• percentual.

Valor fixo

Define um valor exato para o recebedor.

Exemplo:

Valor líquido da cobrança: R$ 100,00
Split fixo para parceiro: R$ 25,00
Valor repassado ao parceiro: R$ 25,00
Saldo restante para a conta emissora: R$ 75,00

Percentual

O percentual é aplicado ao netValue.

Exemplo:

Valor líquido da cobrança: R$ 100,00
Split para parceiro: 30%
Valor repassado ao parceiro: R$ 30,00
Saldo restante para a conta emissora: R$ 70,00

Para Splits exclusivamente percentuais, a soma não pode ultrapassar 100%. Os valores configurados também devem respeitar o valor líquido disponível na cobrança.

Consulte as regras completas em Split de Pagamentos.

6. Defina os recebedores

Confirme se cada walletId pertence à conta que deve receber o repasse.

Você só precisa configurar como recebedores as contas que receberão parte do valor. O saldo líquido restante permanece na conta que criou a cobrança.

7. Finalize e teste

Antes de ativar a automação:

1. revise os campos mapeados;
2. confira os recebedores;
3. valide os valores ou percentuais;
4. confirme o gatilho;
5. execute um teste com dados controlados.

Depois, finalize a automação na Pluga.

Resultado esperado

A Pluga deve criar a cobrança no Asaas com a configuração de Split definida na automação.

Após o recebimento da cobrança, o Asaas calcula o netValue e processa os repasses conforme as regras configuradas.

Evite duplicidades

Se a origem permitir, mantenha campos de controle para registrar o resultado da automação.

Por exemplo:

Antes de reprocessar uma linha ou evento:

• consulte o histórico da automação na Pluga;
• confirme se a cobrança já foi criada;
• utilize o ID do pedido ou referência externa para conciliação.

Acompanhe os Splits

Para validação manual, consulte os Splits pagos e recebidos diretamente pela interface Asaas:

Consulte os Splits pela interface.

Para acompanhamento automatizado, utilize Webhooks em vez de consultas recorrentes à API.

O evento:

PAYMENT_SPLIT_DONE

é enviado quando um Split específico é liquidado. Se uma cobrança possuir mais de um Split, cada liquidação pode gerar seu próprio evento.

Consulte os Eventos para cobranças.

Estornos

Quando uma cobrança com Split é estornada, os repasses relacionados também são estornados.

Considere esse comportamento na conciliação entre a conta emissora, os recebedores e a ferramenta de origem.

Erros comuns

Próximos passos

• Conheça as regras do Split de Pagamentos
• Consulte Splits pagos e recebidos
• Recupere o walletId de uma conta
• Consulte os eventos de cobranças
• Consulte o FAQ da Pluga