Skip to main content

Visão Geral

Método: POST
Endpoint: https://api.emitix.com.br/nfce/evento

Descrição Geral​

A rota de Eventos da NFC-e é responsável por enviar à SEFAZ os eventos relacionados a uma NFC-e previamente emitida, como:

  • Cancelamento de NFC-e (tpEvento = 110111)
  • Cancelamento de Conciliação Financeira (tpEvento = 240170)
  • Conciliação Financeira (tpEvento = 240170)
  • EPEC – Evento Prévio de Emissão em Contingência (tpEvento = 110140)

Os eventos são enviados de forma autenticada e assinada digitalmente, utilizando o certificado A1 do emitente.

Função da Rota​

Permitir o registro oficial de eventos na SEFAZ, mantendo a validade jurídica e a rastreabilidade da NFC-e.
Cada evento altera o estado ou complementa as informações de uma nota fiscal já existente.

Situações de Uso​

  • Cancelamento de NFC-e autorizada (dentro do prazo e condições definidas pela SEFAZ).
  • Registro de EPEC em caso de emissão em contingência.
  • Qualquer outro evento técnico ou administrativo vinculado a uma NFC-e.

Campos​

CampoTipoObrigatórioDescrição
eventoobject✅Objeto que contém os dados do evento a ser transmitido.
evento.ufstring✅Código da UF do emitente, conforme tabela do IBGE (ex: 35 para SP).
evento.eventoobject✅Estrutura com os dados do evento da NFC-e.
evento.evento.cOrgaostring✅Código do órgão da SEFAZ responsável pelo evento (ex: 35 para SP).
evento.evento.tpAmbstring✅Tipo de ambiente: 1 (Produção) ou 2 (Homologação).
evento.evento.CNPJstring⛔️ OpcionalCNPJ do emitente do evento (use apenas se não informar CPF).
evento.evento.CPFstring⛔️ OpcionalCPF do emitente do evento (use apenas se não informar CNPJ).
evento.evento.chNFestring✅Chave de acesso da NFC-e vinculada ao evento.
evento.evento.dhEventostring✅Data e hora do evento no formato UTC (AAAA-MM-DDThh:mm:ssTZD).
evento.evento.tpEventostring✅Código do tipo de evento (ex: 110111 para Cancelamento, 110110 para Carta de Correção).
evento.evento.nSeqEventostring✅Número sequencial do evento para o mesmo tipo (ex: 1, 2, etc.).
evento.evento.detEventoobject✅Detalhes específicos do evento (ex: motivo do cancelamento, texto da correção, etc.).
certificatestring✅Certificado digital A1 em Base64 utilizado para assinar o evento.
pass_certificatestring✅Senha do certificado digital A1.

Exemplo de Payload​

{
  "evento": {
    "uf": "35",
    "evento": {
      "cOrgao": "35",
      "tpAmb": "1",
      "CNPJ": "12345678000199",
      "chNFe": "35240712345678000199650010000000011234567890",
      "dhEvento": "2025-10-28T10:00:00-03:00",
      "tpEvento": "110111",
      "nSeqEvento": "1",
      "detEvento": {
        "descEvento": "Cancelamento",
        "nProt": "135250000987654",
        "xJust": "Erro de emissão. Nota cancelada."
      }
    }
  },
  "certificate": "MIIGgTCCBGmgAwIBAgIQ... (base64)",
  "pass_certificate": "senha_certificado"
}

Exemplo de Requisição Completa​

curl -X POST https://api.emitix.com.br/nfce/evento \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "api-key: SUA_API_KEY_AQUI..." \
  -d '{Payload}'

Exemplo de Resposta​

{
  "success": true,
  "message": "Evento feito com sucesso",
  "statusCode": 200,
  "data": {
    "response": {
      "idLote": "000000000000028",
      "tpAmb": "2",
      "cOrgao": "35",
      "cStat": "128",
      "xMotivo": "Lote de Evento Processado",
      "retEvento": {
        "infEvento": {
          "tpAmb": "2",
          "verAplic": "SP_EVENTOS_PL_100",
          "cOrgao": "35",
          "cStat": "135",
          "xMotivo": "Evento registrado e vinculado a NF-e",
          "chNFe": "352510743636150001...",
          "tpEvento": "110111",
          "xEvento": "Cancelamento registrado",
          "nSeqEvento": "1",
          "dhRegEvento": "2025-10-23T09:27:36-03:00",
          "nProt": "1352500000214523"
        },
        "@_versao": "1.00"
      }
    },
    "xml": "<envEvento versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\">...</envEvento>"
  }
}