FAQ - Pluga

Este FAQ reúne dúvidas frequentes sobre a integração entre o Asaas e a Pluga, com foco em configuração de automações, uso da chave de API, mapeamento de campos, criação de cobranças, envio de informações entre sistemas e cuidados operacionais após a ativação dos fluxos.

A Pluga permite conectar o Asaas a outras ferramentas utilizadas pela empresa, como planilhas, CRMs, ERPs, plataformas de e-commerce, ferramentas de marketing, atendimento e comunicação, sem necessidade de desenvolver uma integração própria.

A integração funciona a partir da lógica de gatilhos e ações:

Quando algo acontecer em uma ferramenta
↓
Executar uma ação em outra ferramenta

Por exemplo, é possível criar uma cobrança no Asaas a partir de uma nova linha em uma planilha ou enviar os dados de uma cobrança recebida no Asaas para outra ferramenta.

Quando utilizar este FAQ

Utilize esta página quando precisar esclarecer dúvidas sobre:

• configuração de automações entre Asaas e Pluga;
• uso da chave de API do Asaas na Pluga;
• criação de cobranças por meio de automações;
• envio de dados de cobranças do Asaas para outras ferramentas;
• mapeamento de campos entre sistemas;
• cuidados para evitar cobranças duplicadas;
• uso de split de pagamento em automações;
• falhas comuns durante a execução dos fluxos;
• impactos operacionais da integração.

Para o passo a passo completo de configuração, consulte também as páginas específicas da seção Pluga.

Regras importantes da integração

Antes de utilizar a integração entre Asaas e Pluga, considere que:

• a disponibilidade de ferramentas, gatilhos e ações é definida pela Pluga;
• cada automação deve ser configurada individualmente;
• a execução da automação depende do gatilho configurado;
• os dados enviados ao Asaas dependem do mapeamento realizado na Pluga;
• campos obrigatórios ausentes ou inválidos podem impedir a criação de cobranças;
• alterações em uma automação afetam apenas novas execuções;
• recursos disponíveis na API do Asaas podem não estar disponíveis em todos os modelos da Pluga;
• a chave de API utilizada na Pluga permite executar ações na conta Asaas conectada.

Configurações e parâmetros importantes

Durante a configuração da automação, alguns dados influenciam diretamente o comportamento da integração:

Essas configurações devem ser revisadas antes da ativação da automação, pois erros de mapeamento podem gerar registros incorretos ou impedir a execução do fluxo.

1. O que é a Pluga?

A Pluga é uma plataforma de automação que conecta diferentes ferramentas utilizadas por empresas, permitindo a troca de dados entre sistemas sem necessidade de programação.

Com a Pluga, é possível conectar o Asaas a ferramentas como planilhas, CRMs, ERPs, plataformas de e-commerce, ferramentas de comunicação e outros sistemas utilizados na operação.

2. Quando devo utilizar a integração entre Asaas e Pluga?

Utilize a integração quando sua operação precisar automatizar tarefas entre o Asaas e outras ferramentas sem desenvolver uma integração própria.

Alguns cenários comuns incluem:

• criar cobranças no Asaas a partir de uma planilha;
• criar cobranças no Asaas a partir de vendas registradas em outro sistema;
• enviar cobranças recebidas para uma planilha;
• notificar um time interno quando uma cobrança for paga, vencida ou estornada;
• sincronizar informações financeiras com ferramentas de gestão;
• automatizar processos simples ou intermediários com baixo esforço técnico.

Para fluxos mais complexos, com regras avançadas, alto volume ou tratamento customizado de erros, pode ser mais indicado utilizar a API do Asaas diretamente.

3. Preciso ter conhecimento técnico para usar a Pluga?

Não necessariamente.

A Pluga permite criar automações sem escrever código. No entanto, é importante entender quais dados serão enviados entre os sistemas e revisar o mapeamento dos campos antes de ativar a automação.

Mesmo sem programação, a configuração exige atenção em pontos como:

• chave de API;
• ferramenta de origem;
• gatilho;
• ação;
• filtros;
• campos obrigatórios;
• dados do cliente;
• dados da cobrança;
• regras de split, quando aplicável.

4. Quais contas preciso ter para configurar a integração?

Para configurar uma automação entre Asaas e Pluga, normalmente você precisará:

• ter uma conta ativa no Asaas;
• ter uma conta na Pluga;
• ter acesso à ferramenta que será conectada ao Asaas;
• possuir permissão para conectar a ferramenta externa;
• possuir uma chave de API válida da conta Asaas.

Caso a automação envolva split, os recebedores também precisam possuir contas Asaas aptas a receber os valores.

5. Onde encontro a chave de API do Asaas?

A chave de API pode ser gerada na área de integrações da conta Asaas.

Essa chave será utilizada pela Pluga para autenticar a conta e executar ações conforme a automação configurada.

6. Posso usar a mesma chave de API em mais de uma automação?

Sim. Uma mesma chave de API pode ser utilizada em mais de uma automação, desde que pertença à conta Asaas correta e esteja válida.

Ainda assim, recomenda-se utilizar chaves identificáveis sempre que possível, para facilitar a rastreabilidade.

Exemplo:

Chave API - Pluga

Caso uma chave seja revogada, expirada ou substituída, as automações que dependem dela poderão deixar de funcionar até que a credencial seja atualizada.

7. É possível usar Sandbox na integração com a Pluga?

A possibilidade de testar com Sandbox depende do modelo de automação, da forma de conexão disponível na Pluga e da credencial configurada.

Antes de considerar um fluxo como validado, confirme se a automação está utilizando o ambiente e a conta esperados.

8. Quais tipos de automação posso criar com o Asaas na Pluga?

A disponibilidade depende dos modelos oferecidos pela Pluga para cada ferramenta conectada.

De forma geral, os fluxos podem envolver:

• entrada de dados no Asaas, como criação de cobranças;
• saída de dados do Asaas, como envio de informações de cobranças para outras ferramentas;
• automações baseadas em mudanças de status de cobranças;
• criação de registros em planilhas, CRMs, ERPs ou ferramentas de comunicação;
• fluxos com split de pagamento, quando o modelo utilizado oferecer essa configuração.

Consulte a página do Asaas na Pluga para verificar as integrações e modelos disponíveis.

9. O que é gatilho na Pluga?

O gatilho é o evento que inicia a automação.

Exemplos:

• nova linha criada em uma planilha;
• nova venda registrada em um sistema externo;
• cobrança criada no Asaas;
• cobrança recebida no Asaas;
• cobrança vencida;
• cobrança estornada.

O gatilho deve ser escolhido conforme o momento em que você deseja que a automação seja executada.

10. O que é ação na Pluga?

A ação é o que será executado após o gatilho.

Exemplos:

• criar uma cobrança no Asaas;
• criar uma linha em uma planilha;
• enviar uma mensagem para uma ferramenta de comunicação;
• criar ou atualizar um registro em outro sistema;
• enviar dados de uma cobrança para uma ferramenta de gestão.

A ação depende da ferramenta de destino e dos modelos disponíveis na Pluga.

11. Quais campos preciso mapear para criar uma cobrança no Asaas?

Os campos podem variar conforme o modelo de automação escolhido. Em geral, para criação de cobranças, revise dados como:

• nome do cliente;
• e-mail;
• CPF/CNPJ;
• telefone;
• valor da cobrança;
• data de vencimento;
• descrição;
• forma de pagamento;
• referência externa ou identificador do pedido.

12. O que acontece se um campo obrigatório não for preenchido?

Se um campo obrigatório estiver ausente, inválido ou em formato incompatível, a automação poderá falhar e a ação esperada poderá não ser executada.

Exemplos:

• cobrança não criada no Asaas;
• cliente criado com dados incompletos;
• erro na execução da automação;
• divergência entre a ferramenta de origem e o Asaas.

Em caso de falha, revise o histórico de execução da Pluga, confira o mapeamento dos campos e valide os dados enviados ao Asaas.

13. Alterar o mapeamento afeta cobranças já criadas?

Não. Alterações no mapeamento da automação afetam apenas novas execuções realizadas após a atualização.

Cobranças, clientes ou registros já criados no Asaas não são alterados automaticamente quando você modifica uma automação na Pluga.

14. Como evitar cobranças duplicadas?

Duplicidades podem ocorrer quando o mesmo evento é processado mais de uma vez ou quando a automação é acionada repetidamente com os mesmos dados.

Para reduzir esse risco, recomenda-se:

• utilizar uma referência externa ou ID do pedido;
• criar uma coluna de controle na planilha de origem;
• registrar o ID da cobrança criada no Asaas;
• evitar reprocessar linhas já enviadas;
• revisar filtros e gatilhos;
• acompanhar o histórico de execução da Pluga.

Exemplo de controle em planilha:

15. É possível usar split de pagamento pela Pluga?

Sim, desde que o modelo de automação utilizado permita configurar split de pagamento.

Nesse cenário, a cobrança pode ser criada no Asaas já com a divisão de valores entre diferentes recebedores.

Para isso, normalmente será necessário informar:

• walletId do recebedor;
• tipo de split;
• valor fixo ou percentual;
• dados da cobrança;
• dados do cliente.

Consulte a página Split Asaas no Pluga para o passo a passo completo.

16. O split é calculado sobre o valor bruto ou líquido da cobrança?

O split do Asaas é calculado sobre o valor líquido da cobrança, ou seja, após o desconto das taxas aplicáveis.

Por isso, se a sua operação calcula comissões ou repasses em outro sistema, é importante considerar que o valor efetivamente distribuído pode ser diferente de uma divisão feita sobre o valor bruto.

17. O que acontece se o walletId estiver incorreto?

Se o walletId estiver incorreto, inválido ou não corresponder ao recebedor esperado, a cobrança com split pode falhar ou o split pode não ser aplicado corretamente.

Antes de ativar uma automação com split, valide se todos os walletIds:

• existem;
• pertencem aos recebedores corretos;
• não pertencem à própria conta emissora da cobrança;
• estão associados a contas Asaas aptas a receber split.

18. Posso alterar o split depois que a cobrança foi criada?

A alteração de split após a criação da cobrança depende dos recursos disponíveis no Asaas e do modelo utilizado na Pluga.

Como boa prática, revise cuidadosamente a configuração de split antes de ativar a automação.

Caso a cobrança seja criada com split incorreto, pode ser necessário cancelar, ajustar ou recriar o fluxo conforme o cenário operacional.

19. O que acontece se uma cobrança com split for estornada?

Quando uma cobrança com split é estornada, o split também deve ser considerado no fluxo de estorno.

Isso pode impactar:

• conciliação financeira;
• relatórios internos;
• valores repassados aos recebedores;
• comunicação com parceiros;
• atualização da ferramenta de origem.

Por isso, acompanhe o status da cobrança e do split no Asaas após eventos de estorno.

20. A automação é executada imediatamente?

A execução depende do gatilho configurado, da ferramenta de origem, da Pluga e da ferramenta de destino.

Em alguns casos, a automação pode executar em poucos instantes. Em outros, pode haver intervalo entre o evento de origem e a conclusão da ação.

Por isso, evite criar fluxos que dependam de execução instantânea sem validação do comportamento real da automação.

21. Como saber se uma automação falhou?

Quando uma automação não executa como esperado, consulte o histórico ou log de execução na Pluga.

Também valide:

• se a automação está ativa;
• se o gatilho foi acionado;
• se os filtros permitiram a execução;
• se a chave de API está válida;
• se todos os campos obrigatórios foram enviados;
• se o Asaas retornou algum erro na criação da cobrança ou execução da ação.

22. Quais são os erros mais comuns?

Alguns problemas comuns em automações entre Asaas e Pluga incluem:

Boas práticas de configuração

Após criar ou alterar uma automação entre Asaas e Pluga, recomenda-se:

• revisar a chave de API utilizada;
• confirmar se a automação está conectada à conta Asaas correta;
• validar todos os campos obrigatórios;
• testar o fluxo com poucos registros;
• evitar dados reais sensíveis durante testes;
• utilizar referência externa ou ID do pedido;
• criar campos de controle para evitar duplicidade;
• revisar filtros antes de ativar a automação;
• acompanhar as primeiras execuções;
• documentar internamente quais automações estão ativas;
• revisar periodicamente os mapeamentos.

Impactos operacionais

Configurações incorretas em automações da Pluga podem impactar diretamente processos financeiros e operacionais.

Alguns impactos possíveis são:

• criação de cobranças com valor incorreto;
• cobrança associada ao cliente errado;
• ausência de cobranças esperadas;
• duplicidade de cobranças;
• falhas de conciliação financeira;
• envio de dados incompletos para outros sistemas;
• notificações internas incorretas;
• divergência entre Asaas, Pluga e a ferramenta conectada;
• repasses incorretos em fluxos com split.

Por isso, qualquer alteração relevante deve ser validada antes de períodos de alto volume operacional, campanhas comerciais ou rotinas críticas de cobrança.

Conteúdos relacionados

Consulte também:

• Pluga;
• Introdução - Pluga;
• Split Asaas no Pluga;
• Criar cobrança;
• Criar cliente;
• Split de Pagamentos;
• Webhooks;
• Chaves de API;
• Sandbox;
• Central de Ajuda da Pluga.