Eventos de Webhook — NF-e e NFC-e#
| Evento | documento | status | Quando ocorre |
|---|
| NF-e autorizada | nfe/nfce | AUTORIZADA | Quando a NF-e é autorizada pela SEFAZ |
| NF-e cancelada | nfe/nfce | CANCELADA | Quando o cancelamento é autorizado pela SEFAZ |
| Envio rejeitado ou denegado | nfe/nfce | FALHA_EMISSAO ou DENEGADA | Quando a SEFAZ rejeita ou denega a NF-e |
| Cancelamento rejeitado | nfe/nfce | AUTORIZADA | Quando o pedido de cancelamento é recusado, a nota permanece autorizada porém com um objeto a mais chamado cancelamento que contém as informações do cancelamento |
Exemplos de body — NF-e e NFC-e#
Quando um evento se tratar de NFe o campo documento será nfe e quando for NFCe será nfce respectivamente.
NF-e autorizada#
{
"documento": "nfe",
"id": "64f1a7c8e9b123456789abcd",
"idExterno": "pedido-1001",
"dataEmissao": "2026-05-20T14:30:00Z",
"status": "AUTORIZADA",
"emitente": "12345678000199",
"destinatario": "98765432000188",
"valorTotal": 259.90,
"numero": 12345,
"serie": "1",
"chave": "43260512345678000199550010000123451000123456",
"mensagem": "NFe autorizada com sucesso",
"pdf": "https://api.digisan.com.br/api/v1/nfe/64f1a7c8e9b123456789abcd/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfe/64f1a7c8e9b123456789abcd/xml"
}
NF-e cancelada#
{
"documento": "nfe",
"id": "6a0ef6c0e8f90b3df7ffd5ae",
"idExterno": "a6039ac0-9c9b-4eca-91d9-7c7bf026f42c",
"dataEmissao": "2026-05-21T12:12:47Z",
"status": "CANCELADA",
"emitente": "03610650000147",
"destinatario": "03610650000147",
"valorTotal": 10,
"numero": 5693,
"serie": "0",
"chave": "53260503610650000147550000000056931182540335",
"mensagem": "NFe cancelada com sucesso",
"pdf": "https://api.digisan.com.br/api/v1/nfe/6a0ef6c0e8f90b3df7ffd5ae/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfe/6a0ef6c0e8f90b3df7ffd5ae/xml",
"cancelamento": {
"status": "CANCELADO",
"data": "2026-05-21T12:15:34Z",
"protocolo": "353260000038035",
"motivo": "nota emitida para testes"
}
}
Envio rejeitado#
{
"documento": "nfe",
"id": "64f1a7c8e9b123456789abcd",
"idExterno": "pedido-1001",
"dataEmissao": "2026-05-20T14:30:00Z",
"status": "FALHA_EMISSAO",
"emitente": "12345678000199",
"destinatario": "98765432000188",
"mensagem": "Rejeição: total da NF difere do somatório dos itens"
}
NF-e denegada#
{
"documento": "nfe",
"id": "64f1a7c8e9b123456789abcd",
"idExterno": "pedido-1001",
"dataEmissao": "2026-05-20T14:30:00Z",
"status": "DENEGADA",
"emitente": "12345678000199",
"destinatario": "98765432000188",
"mensagem": "Uso denegado: irregularidade fiscal do emitente"
}
Cancelamento rejeitado#
{
"documento": "nfe",
"id": "69fd2e6bc8cc1248a89acfd0",
"idExterno": "ord926g0g5",
"dataEmissao": "2026-05-08T00:29:14Z",
"status": "AUTORIZADA",
"emitente": "03610650000147",
"destinatario": "03610650000147",
"valorTotal": 46.75,
"numero": 5684,
"serie": "0",
"chave": "53260503610650000147550000000056841062023709",
"mensagem": "Cancelamento rejeitado",
"pdf": "https://api.digisan.com.br/api/v1/nfe/69fd2e6bc8cc1248a89acfd0/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfe/69fd2e6bc8cc1248a89acfd0/xml",
"cancelamento": {
"status": "REJEITADO",
"mensagemRejeicao": "501 - Rejeicao: Prazo de Cancelamento Superior ao Previsto na Legislacao"
}
Eventos de Webhook — NFS-e#
| Evento | documento | status | Quando ocorre |
|---|
| NFS-e autorizada | nfse | AUTORIZADA | Quando a NFS-e é autorizada pela prefeitura |
| NFS-e cancelada | nfse | CANCELADA | Quando o cancelamento é autorizado |
| Envio rejeitado | nfse | FALHA_EMISSAO | Quando a prefeitura rejeita a NFS-e |
| Cancelamento rejeitado | nfse | FALHA_CANCELAMENTO | Quando o pedido de cancelamento é recusado, a nota permanece autorizada porém com um objeto a mais chamado cancelamento que contém as informações do cancelamento |
Exemplos de body — NFS-e#
NFS-e autorizada#
{
"documento": "nfse",
"id": "7b2c9d8e11445522881133b2",
"idExterno": "ab12cd34-ef56-7890-ab12-cd34ef567890",
"emissao": "2026-05-21T13:56:29Z",
"status": "AUTORIZADA",
"prestador": "12345678000195",
"tomador": "98765432000110",
"valorLiquido": 219.72,
"numero": "20231",
"serie": "1",
"lote": "570",
"codigoVerificacao": "ZXCVBNMAS",
"mensagem": "NFSe autorizada com sucesso",
"pdf": "https://api.digisan.com.br/api/v1/nfse/7b2c9d8e11445522881133b2/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfse/7b2c9d8e11445522881133b2/xml"
}
NFS-e cancelada#
{
"documento": "nfse",
"id": "6a0ef6c0e8f90b3df7ffd5ae",
"idExterno": "a6039ac0-9c9b-4eca-91d9-7c7bf026f42c",
"dataEmissao": "2026-05-21T12:12:47Z",
"status": "CANCELADA",
"emitente": "03610650000147",
"tomador": "03610650000147",
"valorTotal": 10,
"numero": 5693,
"serie": "0",
"chave": "53260503610650000147550000000056931182540335",
"mensagem": "NFe cancelada com sucesso",
"pdf": "https://api.digisan.com.br/api/v1/nfse/6a0ef6c0e8f90b3df7ffd5ae/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfse/6a0ef6c0e8f90b3df7ffd5ae/xml",
"cancelamento": {
"status": "CANCELADO",
"data": "2026-05-21T12:15:34Z",
"protocolo": "353260000038035",
"motivo": "nota emitida para testes"
}
}
Envio rejeitado#
{
"documento": "nfse",
"id": "65a2b8d9e9b123456789abcd",
"idExterno": "os-2001",
"emissao": "2026-05-20T14:30:00Z",
"status": "FALHA_EMISSAO",
"prestador": "12345678000199",
"tomador": "98765432000188",
"mensagem": "Rejeição: código de serviço inválido para o município",
"metadados": {
"origem": "integracao",
"pedido": "2001"
}
}
Cancelamento rejeitado#
{
"documento": "nfse",
"id": "69fd2e6bc8cc1248a89acfd0",
"idExterno": "ord926g0g5",
"dataEmissao": "2026-05-08T00:29:14Z",
"status": "AUTORIZADA",
"emitente": "03610650000147",
"tomador": "03610650000147",
"valorTotal": 46.75,
"numero": 5684,
"serie": "0",
"chave": "53260503610650000147550000000056841062023709",
"mensagem": "Cancelamento rejeitado",
"pdf": "https://api.digisan.com.br/api/v1/nfse/69fd2e6bc8cc1248a89acfd0/pdf",
"xml": "https://api.digisan.com.br/api/v1/nfse/69fd2e6bc8cc1248a89acfd0/xml",
"cancelamento": {
"status": "REJEITADO",
"mensagemRejeicao": "501 - Rejeicao: Prazo de Cancelamento Superior ao Previsto na Legislacao"
}
Modificado em 2026-05-21 14:32:54
