Eventos para notas fiscais
É possível utilizar webhook para que seu sistema seja notificado sobre alterações que ocorram nas notas fiscais. Os eventos que o Asaas notifica são:
INVOICE_CREATED
- Geração de nova nota fiscal.INVOICE_UPDATED
- Alteração na nota fiscal.INVOICE_SYNCHRONIZED
- Nota fiscal enviada para prefeitura.INVOICE_AUTHORIZED
- Nota fiscal emitida.INVOICE_PROCESSING_CANCELLATION
- Nota fiscal processando cancelamento.INVOICE_CANCELED
- Nota fiscal cancelada.INVOICE_CANCELLATION_DENIED
- Recusado o cancelamento da nota fiscal.INVOICE_ERROR
- Nota fiscal com erro.
Exemplo de JSON a ser recebido [POST]
A notificação consiste em um POST contendo um JSON, conforme este exemplo:
{
"id": "evt_05b708f961d739ea7eba7e4db318f621&368604920",
"event": "INVOICE_CREATED",
"dateCreated": "2024-06-12 16:45:03",
"invoice": {
"object": "invoice",
"id": "inv_000000000232",
"status": "SCHEDULED",
"customer": "cus_000000002750",
"type": "NFS-e",
"statusDescription": null,
"serviceDescription": "Nota fiscal da Fatura 101940. \nDescrição dos Serviços: ANÁLISE E DESENVOLVIMENTO DE SISTEMAS",
"pdfUrl": null,
"xmlUrl": null,
"rpsSerie": null,
"rpsNumber": null,
"number": null,
"validationCode": null,
"value": 300,
"deductions": 0,
"effectiveDate": "2018-07-03",
"observations": "Mensal referente aos trabalhos de Junho.",
"estimatedTaxesDescription": "",
"payment": "pay_145059895800",
"installment": null,
"taxes": {
"retainIss": false,
"iss": 3,
"cofins": 3,
"csll": 1,
"inss": 0,
"ir": 1.5,
"pis": 0.65
},
"municipalServiceCode": "1.01",
"municipalServiceName": "Análise e desenvolvimento de sistemas"
}
}
Retorno do Webhook com tipagem e ENUMs
Caso você queira saber qual o tipo de cada campo e os retornos de ENUMs disponíveis, confira a resposta
200
no endpoint "Recuperar uma nota fiscal" na documentação.
- Com a entrada de novos produtos e funções dentro do Asaas, é possível que novos atributos sejam incluídos no Webhook. É muito importante que seu código esteja preparado para não gerar exceções caso o Asaas devolva novos atributos não tratados pela sua aplicação, pois isso poderá causar interrupção na fila de sincronização.
- Enviaremos um e-mail e avisaremos em nosso Discord quando novos campos forem incluídos no Webhook. O disparo será feito para o e-mail de notificação definido nas configurações do webhook
Updated 4 months ago