Referência: Eventos da NFS-e

Atualizado em 11/11/2026

Nesta página

O objeto evento
Tipos de evento
Status do evento
Listar eventos de uma nota
Regras que valem para todos os eventos
Próximos passos

Depois de autorizada, uma NFS-e só muda por eventos registrados na Sefin: cancelamento, cancelamento por substituição, análise fiscal e eventos do município. Esta rota mostra o histórico de eventos de uma nota.

Método	Rota	Escopo
`GET`	`/integracao/nfse/{id}/eventos`	`nfse:read`

Para criar eventos, use cancelar e substituir.

O objeto evento#

Evento

{
  "tipo": "101101",
  "descricao": "Cancelamento de NFS-e",
  "status": "accepted",
  "origem": "saas",
  "sequencial": 1,
  "motivo_codigo": "2",
  "motivo_texto": "Serviço cancelado pelo cliente antes da execução",
  "registrado_em": "2026-11-12T09:02:11-03:00",
  "erros": null,
  "created_at": "2026-11-12T09:02:05-03:00"
}

Campo	Descrição
`tipo`	Código do evento na Sefin (tabela abaixo)
`descricao`	Descrição oficial do tipo
`status`	`pending`, `sent`, `accepted`, `rejected` ou `error`
`origem`	Quem gerou: `saas` (a Emitra, a seu pedido), `sefin`, `municipio` ou `adn`
`sequencial`	Número sequencial do evento daquele tipo na nota (`nSeqEvento`)
`motivo_codigo`, `motivo_texto`	Justificativa informada
`registrado_em`	Quando a Sefin registrou o evento
`erros`	Lista `{codigo, descricao}` quando `status` é `rejected`

Tipos de evento#

`tipo`	Evento	Quem gera
`101101`	Cancelamento de NFS-e	Você, por `/cancelar`
`105102`	Cancelamento de NFS-e por substituição	Sefin, ao autorizar a substituta
`101103`	Solicitação de análise fiscal para cancelamento	Emitente (cancelamento fora do prazo)
`105104`	Cancelamento deferido por análise fiscal	Município
`105105`	Cancelamento indeferido por análise fiscal	Município
`305101`	Cancelamento de NFS-e por ofício	Município
`305102` / `305103`	Bloqueio e desbloqueio por ofício	Município

Status do evento#

`status`	Significa
`pending`	Pedido criado, aguardando envio
`sent`	Enviado à Sefin
`accepted`	Registrado pela Sefin. A nota mudou de status
`rejected`	Recusado pela Sefin (ex.: `E0822`, prazo de cancelamento expirado)
`error`	Falha técnica. A Emitra tenta de novo

Listar eventos de uma nota#

GET /integracao/nfse/{id}/eventos → 200, em ordem cronológica.

cURL

curl https://emitra.com.br/api/v1/integracao/nfse/3c9b7e1a-6d42-4f8e-a0b3-7e2f5d1c9a84/eventos \
  -H "Authorization: Bearer $EMITRA_API_KEY"

Python

eventos = requests.get(f"{API}/nfse/{nfse_id}/eventos", headers=H, timeout=30).json()["data"]["items"]

JavaScript

const { data } = await (await fetch(`${API}/nfse/${nfseId}/eventos`, { headers })).json();

PHP

<?php
$ch = curl_init("$api/nfse/$nfseId/eventos");
curl_setopt_array($ch, [CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true]);
$eventos = json_decode(curl_exec($ch), true)["data"]["items"];

Resposta 200

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "items": [
      {
        "tipo": "101101",
        "descricao": "Cancelamento de NFS-e",
        "status": "rejected",
        "origem": "saas",
        "sequencial": 1,
        "motivo_codigo": "2",
        "motivo_texto": "Serviço cancelado pelo cliente antes da execução",
        "registrado_em": null,
        "erros": [ { "codigo": "E0822", "descricao": "Prazo de cancelamento expirado" } ],
        "created_at": "2026-12-20T09:02:05-03:00"
      }
    ],
    "next_cursor": null,
    "has_more": false
  }
}

Regras que valem para todos os eventos#

Cancelamento e substituição são eventos únicos por nota.
Uma nota cancelada não aceita substituição.
Prazos de cancelamento e de substituição são parametrizados por cada município.

Próximos passos#

Esta página foi útil?