Automatize o envio de dados da PagTrust para o eNotas usando Pluga Webhooks e gere notas fiscais automaticamente a partir de boletos gerados.
Neste passo a passo vamos te ensinar a automatizar o recebimento de informações da sua conta PagTrust através do Pluga Webhooks e enviar para o eNotas. Vamos lá?
Como integrar PagTrust com eNotas usando Pluga Webhooks
Para configurar essa integração, você precisará criar uma automatização na Pluga, configurar o webhook na PagTrust e mapear os dados para o eNotas. Siga os passos abaixo:
1. Crie uma nova automatização na Pluga
Acesse sua conta na Pluga e clique em "Criar automatização":
2. Nomeie sua automatização
Dê um nome à sua automatização que te ajude a identificar qual é o fluxo que passará por ela:
3. Selecione Pluga Webhooks como ferramenta de gatilho
No campo "Ferramenta" selecione "Pluga Webhooks" e no gatilho selecione "Notificação recebida". Depois clique em "Continuar":
4. Conecte uma nova conta Webhooks
Conecte uma nova conta e dê o nome da ferramenta que está sendo conectada:
5. Copie a URL gerada pelo Pluga Webhooks
Copie a URL gerada e configure na PagTrust conforme o passo a passo:
6. Acesse o painel de integrações da PagTrust
Acesse seu painel da PagTrust e clique em "Integrações" depois em "Webhooks":
7. Adicione um novo webhook na PagTrust
Nessa tela, clique no botão central "Clique aqui para adicionar um novo webhook":
8. Nomeie o webhook na PagTrust
Dê um nome ao seu webhook:
9. Selecione os produtos para integração
Selecione os produtos que deseja que sejam enviados pela integração:
10. Cole a URL do webhook da Pluga
Cole a URL que você copiou da Pluga no devido campo:
11. Mantenha a versão 2 do webhook
Mantenha a "Versão 2" selecionada:
12. Configure os gatilhos de envio
Selecione quais dos gatilhos devem enviar as informações para a Pluga:
Atenção
Aqui você deve selecionar em que momento a PagTrust deve enviar as informações para a Pluga e é fundamental você selecionar com cuidado essas opções para evitar problemas em suas automatizações! Por exemplo, caso queira capturar os boletos gerados, selecione apenas essa opção. Caso queira capturar as informações em mais de um momento dessa lista, por exemplo, o "boleto gerado" e a "compra cancelada", o ideal é criar uma automatização para cada um desses gatilhos.
13. Salve as configurações na PagTrust
Depois clique em "Salvar":
14. Continue a configuração na Pluga
Feito isso, volte na Pluga e clique em "Continuar":
15. Configure o modelo JSON do webhook
Em seguida, indique o nome da ferramenta integrada e configure o modelo JSON que devemos receber da ferramenta de origem, depois clique em continuar:
Para o gatilho de "Boleto gerado", o JSON utilizado deve ser:
{
"creation_date":1752637982680,
"data":{
"buyer":{
"address":{
"address":"",
"city":"",
"complement":"",
"country":"",
"country_iso":"BR",
"neighborhood":"",
"number":"",
"state":"",
"zipcode":""
},
"checkout_phone":"11111111111",
"document":"1111111",
"email":"email@email.com",
"name":"Usuário Teste"
},
"commissions":[
{
"currency_value":"BRL",
"source":"MARKETPLACE",
"value":0.28
},
{
"currency_value":"BRL",
"source":"PRODUCER",
"value":6.65
}
],
"producer":{
"name":"Pagtrust"
},
"product":{
"has_co_production":false,
"id":1,
"name":"Produto Teste"
},
"purchase":{
"approved_date":1752637982686,
"checkout_country":{
"iso":"BR",
"name":"Brasil"
},
"date_next_charge":"",
"full_price":{
"currency_value":"BRL",
"value":7
},
"offer":{
"code":"11111"
},
"order_bump":{
"is_order_bump":false,
"parent_purchase_transaction":123456
},
"order_date":1752637982686,
"origin":{
"content":"content",
"sck":"",
"src":"",
"term":"",
"utmcampaign":"utm_campaign",
"utmmedium":"utm_medium",
"utmsource":"FB",
"xcod":""
},
"original_offer_price":{
"currency_value":"BRL",
"value":7
},
"payment":{
"installments_number":1,
"pix_code":"pix.url.com",
"pix_expiration_date":1752724382686,
"pix_qrcode":"https://api.pagar.me/core/v5/transactions/teste/qrcode?payment_method=pix",
"type":"billet"
},
"price":{
"currency_value":"BRL",
"value":6.65
},
"recurrence_number":1,
"status":"BILLET_PRINTED",
"subscription_anticipation_purchase":false,
"transaction":"123456"
}
},
"event":"PURCHASE_BILLET_PRINTED",
"id":"1",
"orderId":"1"
}
16. Configure filtros personalizados (opcional)
Depois há uma etapa de filtro personalizado opcional, que só deve ser configurado caso você queira filtrar os eventos com base em alguma informação dos eventos:
Caso não queira filtrar, basta deixar os campos em branco e clicar em "Continuar".
17. Conecte o eNotas como ferramenta de ação
Clique em "Conectar nova ferramenta" para selecionar a ferramenta que receberá as informações:
18. Selecione a ação de gerar NF-e no eNotas
Selecione a ferramenta "eNotas" e a ação de "Gerar NF-e de serviço ou produto", depois clique em "Continuar":
19. Conecte sua conta do eNotas
Conecte sua conta do eNotas colando o API Key de acesso à sua conta. Caso não saiba onde encontrar, você pode clicar em "Veja o passo a passo para encontrar suas chaves de acesso":
20. Mapeie os campos da nota fiscal
Preencha os campos conforme fizer sentido para o seu caso. Você pode clicar em "Inserir infos" para trazer informações da PagTrust ou pode preencher informações fixas, quando for o caso. Por exemplo, na imagem abaixo, a data, nome e CPF serão preenchidos com informações que virão da PagTrust. Mas, o nome do produto será preenchido com uma informação fixa:
21. Finalize sua automatização
Depois de ter feito o mapeamento é só clicar em "Continuar" e em "Finalizar automatização" e prontinho! Agora é só dar tchau ao trabalho manual e deixar os robôs da Pluga trabalharem para você. 😎
Dúvidas?
Caso ainda tenha dúvidas, é só solicitar um atendimento que nosso time de suporte entrará em contato dentro de algumas horas ;)