Consulta de Eventos da NFS-e

Método: GET

Endpoint: https://api.emitix.com.br/nfse/eventos

Descrição Geral

Permite consultar os eventos associados a uma Nota Fiscal de Serviço Eletrônica (NFS-e) diretamente na SEFIN Nacional. A consulta permite buscar eventos relacionados pela chave de acesso da nota. Podem ser aplicados filtros como o tipo de evento e número sequencial.

Função da Rota

• Consultar todos os eventos vinculados a uma NFS-e específica.
• Obter detalhes de um tipo de evento específico vinculado à nota.
• Obter um evento em sua sequência específica.

Situações de Uso

• Verificar se um evento de cancelamento ou substituição foi de fato registrado e processado com sucesso.
• Sincronizar os eventos de uma nota fiscal com sistemas ERP ou contábeis internos.
• Obter garantias e informações oficiais de eventos para auditoria.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
chaveAcesso	string	✅	Chave de acesso da NFS-e a ser consultada. (44 caracteres)
tipoEvento	string	✅	Tipo de evento a ser consultado (ex: '101101', '101103', '202201', etc).
numSeqEvento	string	✅	Número sequencial do evento.
cnpj	string	⚙️ Opcional*	CNPJ do prestador (obrigatório se CPF não for informado).
cpf	string	⚙️ Opcional*	CPF do prestador (obrigatório se CNPJ não for informado).
certificate	string	⚙️ Opcional	Certificado digital A1 em base64. Se não enviado, utiliza-se o cadastrado no sistema.
pass_certificate	string	⚙️ Opcional	Senha do certificado digital A1.

Observação: Deve ser informado obrigatoriamente apenas um dos identificadores do prestador: cnpj ou cpf.

Autenticação

A rota exige autenticação dupla através dos cabeçalhos:

• Bearer Token
  • Authorization: Bearer <seu_token_de_acesso>
• API Key
  • api-key: <sua_api_key>

Exemplo de Payload

{
  "chaveAcesso": "12345678901234567890123456789012345678901234",
  "tipoEvento": "101101",
  "numSeqEvento": "1",
  "cnpj": "12345678000199"
}

Exemplo de Requisição Completa

curl -X GET https://api.emitix.com.br/nfse/eventos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <seu_token_de_acesso>" \
  -H "api-key: <sua_api_key>" \
  -d '{
    "chaveAcesso": "12345678901234567890123456789012345678901234",
    "tipoEvento": "101101",
    "numSeqEvento": "1",
    "cnpj": "12345678000199"
  }'

Exemplo de Resposta

{
  "success": true,
  "message": "NFS-e consultada com sucesso",
  "statusCode": 200,
  "data": {
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><retConsStatServ><tpAmb>1</tpAmb><verAplic>SP_NFE_PL009_V4</verAplic><cStat>107</cStat><xMotivo>Serviço em Operação</xMotivo><cUF>35</cUF><dhRecbto>2025-03-19T10:00:00-03:00</dhRecbto></retConsStatServ>",
    "response": {
      "tpAmb": "1",
      "verAplic": "1.0.0",
      "cStat": "100",
      "xMotivo": "Autorizado o uso da NF-e",
      "cUF": "35",
      "dhRecbto": "2025-03-19T10:00:00-03:00",
      "eventos": [
        {
          "tipoEvento": "101101",
          "descEvento": "Cancelamento",
          "dataHora": "2025-03-19T09:30:00-03:00",
          "numSeqEvento": "1"
        }
      ]
    }
  }
}