Skip to main content

Visão Geral

Os eventos da NF-e são comunicações oficiais enviadas à SEFAZ após a autorização da nota fiscal, com o objetivo de alterar o status, complementar informações ou registrar ocorrências relacionadas à operação fiscal.

Cada evento é identificado por um código (tpEvento) e segue um modelo padronizado definido pela SEFAZ.
A Emitix API centraliza o envio de todos esses eventos através da rota única:

POST https://api.emitix.com.br/nfe/evento

Finalidade dos Eventos​

Os eventos são usados para registrar ações ou atualizações sobre uma NF-e já emitida, garantindo que qualquer alteração relevante seja formalmente comunicada e vinculada ao documento fiscal original.

Eles permitem:

  • Corrigir informações sem alterar valores fiscais;
  • Cancelar uma NF-e emitida incorretamente;
  • Manifestar o recebimento ou recusa de uma operação;
  • Emitir documentos em contingência (EPEC);
  • Registrar prorrogações ou participações de terceiros (ator interessado).

Tipos de Eventos Suportados​

Eventos Básicos​

Tipo de EventoNome InternoFinalidade
CancelamentoCancelamentoAnula uma NF-e autorizada que não será mais válida.
Carta de CorreçãoCarta_CorrecaoCorrige dados da NF-e que não alteram valores fiscais.
Manifestação do DestinatárioMani_DestPermite ao destinatário confirmar, desconhecer ou rejeitar a operação.
EPEC (Contingência)EpecRegistra uma emissão prévia em contingência.
Pedido de ProrrogaçãoPedido_ProrrogSolicita extensão do prazo de validade da nota fiscal.
Ator InteressadoAtorInteressadoAdiciona um participante adicional (ex.: transportadora, marketplace).

Eventos de Crédito Presumido​

Tipo de EventoNome InternoFinalidade
Solicitação de Crédito PresumidoSolic_Aprov_Cred_PresSolicita apropriação de crédito presumido de IBS/CBS.
Confirmação de Pagamento IntegralConfirm_Pag_Int_Cred_PresConfirma pagamento integral para liberar crédito presumido.

Eventos de Crédito​

Tipo de EventoNome InternoFinalidade
Crédito de CombustívelSolic_Aprov_Cred_CombustivelSolicita apropriação de crédito de combustível.
Crédito de Bens e ServiçosSolic_Aprov_Cred_Bens_ServSolicita crédito para bens/serviços que dependem de atividade do adquirente.
Aceite de Débito por Nota de CréditoAceite_Deb_Apur_Nota_CredAceita débito na apuração por emissão de nota de crédito.

Eventos de Controle de Estoque​

Tipo de EventoNome InternoFinalidade
Imobilização de ItemImobilizacao_ItemRegistra imobilização de item no ativo.
Consumo PessoalDest_Item_Cons_PessoalRegistra destinação de item para consumo pessoal.
Importação ALC/ZFMImport_Alc_Zfm_Nao_Conv_IsencRegistra importação em ALC/ZFM não convertida em isenção.

Eventos de Perda/Furto​

Tipo de EventoNome InternoFinalidade
Perda no Transporte (Fornecedor)Perda_Roubo_Furto_Transp_FornecRegistra perda/furto no transporte contratado pelo fornecedor.
Perda no Transporte (Adquirente)Perda_Roubo_Furto_Transp_AdquirenteRegistra perda/furto no transporte contratado pelo adquirente.
Fornecedor Não EntregouFornec_Nao_Realiz_Pag_AntRegistra não entrega de itens pagos antecipadamente.

Eventos de Atualização​

Tipo de EventoNome InternoFinalidade
Atualização de Data de EntregaAtual_Data_Prev_EntregaAtualiza a data prevista de entrega da operação.

Eventos de Sucessão (Transferência de Crédito)​

Tipo de EventoNome InternoFinalidade
Manifestação Transf. Crédito IBSMani_Transf_Cred_Ibs_SucessaoManifestação sobre transferência de crédito de IBS em sucessão.
Manifestação Transf. Crédito CBSMani_Transf_Cred_Cbs_SucessaoManifestação sobre transferência de crédito de CBS em sucessão.
Fisco - Transf. Crédito IBSFisco_Mani_Transf_Cred_Ibs_SucessaoManifestação do Fisco sobre transferência de IBS em sucessão.
Fisco - Transf. Crédito CBSFisco_Mani_Transf_Cred_Cbs_SucessaoManifestação do Fisco sobre transferência de CBS em sucessão.

Estrutura Padrão da Requisição​

Todos os eventos utilizam a mesma estrutura base, variando apenas o conteúdo do campo detEvento.

Campos principais do payload:​

CampoTipoObrigatórioDescrição
evento.ufstring✅Código da UF (IBGE) onde o evento será registrado.
evento.evento.chNFestring✅Chave de acesso da NF-e vinculada ao evento.
evento.evento.tpEventostring✅Código do tipo de evento.
evento.evento.nSeqEventostring⚙️ OpcionalNúmero sequencial do tipo de evento (tpEvento) na NF-e: cada tipo tem a sua própria sequência (ex.: carta de correção 1, 2, 3…; cancelamento sempre 1). Se omitido, a API calcula o próximo número do tipo. Se informado, o valor é respeitado e a SEFAZ valida.
evento.evento.detEventoobjeto✅Estrutura específica do evento (depende do tipo).
certificatestring✅Certificado digital A1 em Base64.
pass_certificatestring✅Senha do certificado digital.
"evento": {
    "uf": "35",
    "evento": {
        "cOrgao": "35",
        "tpAmb": "2",
        "CNPJ": "12345678901234",
        "chNFe": "3526017436361500...",
        "dhEvento": "2026-01-27T13:29:00-03:00",
        "tpEvento": "112110",
        "nSeqEvento": "1",
        "detEvento": [object]
    }
}

Autenticação​

Assim como em todas as rotas da API da Emitix, a autenticação é feita em duas camadas:

-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "api-key: SUA_API_KEY_AQUI..."

---