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.ufstringCódigo da UF (IBGE) onde o evento será registrado.
evento.evento.chNFestringChave de acesso da NF-e vinculada ao evento.
evento.evento.tpEventostringCódigo do tipo de evento.
evento.evento.nSeqEventostringNúmero sequencial do evento para a mesma NF-e.
evento.evento.detEventoobjetoEstrutura específica do evento (depende do tipo).
certificatestringCertificado digital A1 em Base64.
pass_certificatestringSenha 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..."

---