Split Asaas no Pluga

A funcionalidade de Split de Pagamento do Asaas permite dividir automaticamente o valor líquido de uma cobrança entre diferentes contas Asaas, como vendedores, parceiros, prestadores de serviço, subcontas ou carteiras vinculadas à operação.

Na integração com a Pluga, essa configuração pode ser realizada sem desenvolvimento próprio, utilizando uma automação para criar cobranças no Asaas já com as regras de divisão configuradas.

Esse fluxo é indicado para operações que precisam automatizar repasses financeiros sem implementar diretamente a API do Asaas.

Quando utilizar o Split Asaas no Pluga

Utilize o Split Asaas no Pluga quando sua operação precisar:

• dividir automaticamente o valor de uma cobrança entre diferentes recebedores;
• repassar comissões para parceiros, vendedores ou prestadores de serviço;
• criar cobranças com split a partir de dados de uma planilha;
• automatizar repasses em fluxos de marketplace, franquias, plataformas, representantes ou operações com múltiplos beneficiários;
• utilizar split sem desenvolver uma integração própria com a API do Asaas;
• reduzir controles manuais de repasse após o recebimento da cobrança.

Alguns exemplos de uso:

Quando considerar uma integração direta via API

A Pluga é recomendada para automações sem código e fluxos padronizados. No entanto, uma integração direta com a API do Asaas pode ser mais indicada quando sua operação exigir:

• regras avançadas de cálculo de comissão;
• alto volume de cobranças;
• validações próprias antes da criação da cobrança;
• controle de filas, retentativas e logs;
• atualização automática de split após a criação da cobrança;
• tratamento customizado de erros;
• conciliação detalhada por recebedor;
• uso de recursos de split que não estejam disponíveis no modelo da Pluga.

Nesses casos, consulte também a documentação de Split de Pagamentos da API do Asaas.

Conceitos importantes

Antes de configurar o split na Pluga, entenda os principais conceitos envolvidos:

Pré-requisitos

Antes de configurar o Split Asaas no Pluga, verifique se você possui:

1. Uma conta ativa no Asaas.

2. Uma conta na Pluga.

3. Uma ferramenta de origem dos dados, como Google Sheets ou outro sistema compatível.

4. A chave de API da conta Asaas que criará as cobranças.

5. Os walletIds das contas Asaas que receberão os repasses.

6. Definição clara da regra de divisão, como valor fixo ou percentual.

7. Dados suficientes para criar a cobrança, como cliente, valor, vencimento e descrição.

8. Validação de que os recebedores possuem contas Asaas aptas a receber split.

Campos importantes para a configuração

A configuração exata pode variar conforme a ferramenta de origem e o modelo de automação escolhido na Pluga. Em geral, revise os seguintes grupos de campos:

Quando utilizar planilha como origem, recomenda-se separar os dados em colunas claras para facilitar o mapeamento.

Exemplo de estrutura de planilha

Um exemplo de planilha para criação de cobrança com split pode conter as seguintes colunas:

Neste exemplo:

• valorCobranca representa o valor da cobrança;
• walletIdParceiro identifica a conta Asaas que receberá o repasse;
• tipoSplit define se a divisão será por percentual ou valor fixo;
• valorSplit representa o percentual ou valor que será configurado no split.

Valor fixo e percentual

O split pode ser configurado de duas formas principais:

Exemplo com percentual:

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

Exemplo com valor fixo:

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

Fluxo geral da automação

Em uma configuração típica com Google Sheets como origem dos dados, o fluxo ocorre assim:

Linha preenchida na planilha
↓
Pluga identifica o gatilho configurado
↓
Pluga coleta os dados da linha
↓
Pluga envia os dados para o Asaas
↓
Cobrança é criada com as regras de split
↓
Cliente realiza o pagamento
↓
Asaas calcula o valor líquido
↓
Split é executado automaticamente
↓
Valores são direcionados aos recebedores configurados

O split não representa uma transferência manual agendada. Ele é executado automaticamente conforme o fluxo de recebimento da cobrança.

Passo a passo de configuração

1. Prepare a origem dos dados

Utilize uma planilha ou ferramenta de origem com as informações necessárias para criar a cobrança e configurar o split.

Organize os dados em três grupos:

1. Informações do cliente:

   • nome;
   • e-mail;
   • telefone;
   • CPF/CNPJ, quando necessário.

2. Informações da cobrança:

   • valor;
   • vencimento;
   • descrição;
   • forma de pagamento;
   • referência externa ou ID do pedido.

3. Informações do split:

   • walletId do recebedor;
   • tipo de split, fixo ou percentual;
   • valor fixo ou percentual;
   • quantidade de recebedores, quando aplicável.

2. Crie ou acesse sua conta na Pluga

Acesse a Pluga e faça login.

Caso ainda não possua uma conta, crie uma conta antes de iniciar a automação.

3. Configure a automação

No painel da Pluga:

1. Clique em Criar automatização.
2. Escolha a ferramenta de origem dos dados, como Google Sheets.
3. Defina o nome da automação, por exemplo:

Split de Pagamentos - Asaas

4. Escolha o modelo de automação que cria cobrança no Asaas.

4. Selecione a planilha e defina o gatilho

Escolha a planilha e a aba que contêm os dados da cobrança.

Depois, defina a coluna ou condição que irá disparar a automação.

Exemplo:

Quando a coluna "Gerar cobrança" for preenchida com "Sim"
↓
Criar cobrança no Asaas com split

Essa etapa é importante para evitar que cobranças sejam criadas antes de todos os dados estarem preenchidos.

5. Conecte a conta Asaas

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

Conecte a conta Asaas informando a chave de API.

6. Mapeie os dados da cobrança

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

Revise especialmente:

• nome do cliente;
• e-mail;
• telefone;
• valor da cobrança;
• data de vencimento;
• descrição;
• forma de pagamento;
• referência externa, se disponível.

Caso algum campo obrigatório esteja vazio ou em formato inválido, a cobrança poderá não ser criada.

7. Ative o split de pagamento

Na configuração da cobrança, habilite a opção de Split de Pagamento.

Em seguida, escolha como o repasse será definido:

• subcontas já cadastradas;
• walletIds informados manualmente;
• walletIds importados da ferramenta de origem, quando o modelo permitir.

Defina também se o repasse será por:

• valor fixo;
• percentual.

8. Defina os recebedores

Configure quem receberá parte do valor da cobrança.

Se utilizar subcontas cadastradas, selecione a subconta disponível na configuração.

Se utilizar walletId, informe ou mapeie o identificador da carteira de destino.

9. Revise e finalize a automação

Antes de finalizar:

• confira se todos os campos obrigatórios foram mapeados;
• valide se o valor ou percentual do split está correto;
• verifique se os walletIds pertencem aos recebedores esperados;
• confirme se a coluna de gatilho evita execuções antecipadas;
• realize um teste com dados controlados.

Após validar as configurações, clique em Continuar e depois em Finalizar automatização.

A partir desse momento, sempre que o gatilho configurado for acionado, a Pluga tentará criar uma cobrança no Asaas com as regras de split definidas.

Comportamentos relevantes

Ao utilizar Split Asaas no Pluga, considere os seguintes comportamentos:

• o split é executado sobre o valor líquido da cobrança;
• o valor líquido considera o desconto das taxas aplicáveis;
• o saldo líquido não direcionado via split permanece na conta emissora;
• o split é executado automaticamente no momento do recebimento;
• não é possível definir uma data futura personalizada para execução do split;
• se a cobrança for estornada, o split também será estornado;
• cobranças criadas sem split não terão divisão automática de valores;
• cobranças criadas com split incorreto podem exigir cancelamento, ajuste ou recriação, conforme o caso;
• se o valor total do split exceder o valor líquido da cobrança, a divisão pode não ser executada corretamente;
• a disponibilidade dos campos de split depende do modelo de automação da Pluga utilizado.

Status do split

Após a criação e pagamento da cobrança, o split pode assumir diferentes status.

Caso o status seja REFUSED, consulte o motivo da recusa e avalie se será necessário corrigir a operação, revisar a cobrança ou acionar suporte.

Estornos e cancelamentos

Quando uma cobrança com split é estornada, o split também é estornado.

Isso significa que as contas que receberam saldo daquela cobrança terão o repasse revertido conforme o fluxo de estorno.

Por isso, sua operação deve considerar:

• como registrar o estorno no controle financeiro;
• se o repasse já havia sido conciliado internamente;
• se será necessário comunicar o recebedor;
• como atualizar relatórios ou planilhas externas;
• como tratar cobranças estornadas na ferramenta de origem.

Cuidados com cobranças parceladas

Caso a automação envolva cobranças parceladas, valide se o modelo da Pluga utilizado permite configurar o split da forma desejada.

Em cenários de parcelamento, o split pode exigir atenção especial para definir se o repasse será aplicado por parcela ou sobre o valor total do parcelamento, conforme o recurso disponível na integração.

Antes de operar em produção, realize testes com:

• cobrança à vista;
• cobrança parcelada;
• split fixo;
• split percentual;
• múltiplos recebedores.

Cuidados com duplicidade

Como a automação depende de um gatilho, é importante evitar que a mesma cobrança seja criada mais de uma vez.

Duplicidades podem ocorrer quando:

• a mesma linha da planilha é processada novamente;
• o gatilho é acionado antes da conclusão dos dados;
• a automação é testada com dados reais;
• a linha é editada após já ter criado uma cobrança;
• não existe uma coluna de controle indicando que a cobrança já foi gerada.

Para reduzir esse risco, recomenda-se:

• criar uma coluna de status na planilha;
• registrar o ID da cobrança criada no Asaas;
• utilizar referência externa ou número do pedido;
• evitar reprocessar linhas sem validação;
• acompanhar o histórico de execução da Pluga.

Exemplo de colunas de controle:

Erros comuns

Alguns erros comuns ao configurar Split Asaas no Pluga incluem:

Impactos operacionais

A configuração de split impacta diretamente a conciliação financeira da operação.

Uma configuração incorreta pode causar:

• repasse para recebedor errado;
• valor de comissão incorreto;
• falha na criação da cobrança;
• bloqueio ou recusa do split;
• divergência entre planilha, Pluga e Asaas;
• duplicidade de cobranças;
• necessidade de ajustes manuais;
• inconsistência em relatórios financeiros;
• dificuldade para conciliar estornos.

Por isso, antes de ativar a automação em produção, valide todo o fluxo com dados de teste e acompanhe as primeiras execuções.

Boas práticas

Ao configurar Split Asaas no Pluga, recomenda-se:

• validar previamente todos os walletIds dos recebedores;
• não informar o walletId da conta emissora;
• calcular os repasses considerando o valor líquido da cobrança;
• usar valor fixo apenas quando houver previsibilidade suficiente sobre o valor líquido;
• usar percentual quando o repasse deve variar conforme o valor recebido;
• manter uma coluna com o ID da cobrança criada no Asaas;
• utilizar referência externa ou número do pedido para conciliação;
• testar o fluxo antes de operar em produção;
• revisar a configuração sempre que houver alteração na planilha ou ferramenta de origem;
• acompanhar o histórico de execução da Pluga;
• acompanhar o status da cobrança e do split no Asaas;
• documentar internamente quais regras de divisão estão sendo utilizadas.

Checklist antes de ativar em produção

Antes de finalizar a automação, confirme:

• a conta Asaas está conectada corretamente?
• a chave de API utilizada é a correta?
• a planilha possui todos os campos obrigatórios?
• o gatilho está configurado para executar apenas no momento certo?
• os walletIds pertencem aos recebedores corretos?
• nenhum walletId pertence à conta emissora?
• a soma dos percentuais não ultrapassa 100%?
• a soma dos valores fixos não ultrapassa o valor líquido esperado?
• existe coluna de controle para evitar duplicidade?
• foi realizado teste com cobrança de baixo valor?
• o status da cobrança e do split será acompanhado após o pagamento?

Conteúdos relacionados

Consulte também:

• Pluga;
• Introdução - Pluga;
• FAQ - Pluga;
• Introdução - Split de pagamento;
• Usando o split sem API;
• Split em cobranças avulsas;
• Split em parcelamentos;
• Split em assinaturas;
• Criar cobrança;
• Criar subconta;
• Recuperar walletId;
• Webhooks para cobranças.