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 Evento | Nome Interno | Finalidade |
|---|---|---|
| Cancelamento | Cancelamento | Anula uma NF-e autorizada que não será mais válida. |
| Carta de Correção | Carta_Correcao | Corrige dados da NF-e que não alteram valores fiscais. |
| Manifestação do Destinatário | Mani_Dest | Permite ao destinatário confirmar, desconhecer ou rejeitar a operação. |
| EPEC (Contingência) | Epec | Registra uma emissão prévia em contingência. |
| Pedido de Prorrogação | Pedido_Prorrog | Solicita extensão do prazo de validade da nota fiscal. |
| Ator Interessado | AtorInteressado | Adiciona um participante adicional (ex.: transportadora, marketplace). |
Eventos de Crédito Presumido
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Solicitação de Crédito Presumido | Solic_Aprov_Cred_Pres | Solicita apropriação de crédito presumido de IBS/CBS. |
| Confirmação de Pagamento Integral | Confirm_Pag_Int_Cred_Pres | Confirma pagamento integral para liberar crédito presumido. |
Eventos de Crédito
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Crédito de Combustível | Solic_Aprov_Cred_Combustivel | Solicita apropriação de crédito de combustível. |
| Crédito de Bens e Serviços | Solic_Aprov_Cred_Bens_Serv | Solicita crédito para bens/serviços que dependem de atividade do adquirente. |
| Aceite de Débito por Nota de Crédito | Aceite_Deb_Apur_Nota_Cred | Aceita débito na apuração por emissão de nota de crédito. |
Eventos de Controle de Estoque
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Imobilização de Item | Imobilizacao_Item | Registra imobilização de item no ativo. |
| Consumo Pessoal | Dest_Item_Cons_Pessoal | Registra destinação de item para consumo pessoal. |
| Importação ALC/ZFM | Import_Alc_Zfm_Nao_Conv_Isenc | Registra importação em ALC/ZFM não convertida em isenção. |
Eventos de Perda/Furto
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Perda no Transporte (Fornecedor) | Perda_Roubo_Furto_Transp_Fornec | Registra perda/furto no transporte contratado pelo fornecedor. |
| Perda no Transporte (Adquirente) | Perda_Roubo_Furto_Transp_Adquirente | Registra perda/furto no transporte contratado pelo adquirente. |
| Fornecedor Não Entregou | Fornec_Nao_Realiz_Pag_Ant | Registra não entrega de itens pagos antecipadamente. |
Eventos de Atualização
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Atualização de Data de Entrega | Atual_Data_Prev_Entrega | Atualiza a data prevista de entrega da operação. |
Eventos de Sucessão (Transferência de Crédito)
| Tipo de Evento | Nome Interno | Finalidade |
|---|---|---|
| Manifestação Transf. Crédito IBS | Mani_Transf_Cred_Ibs_Sucessao | Manifestação sobre transferência de crédito de IBS em sucessão. |
| Manifestação Transf. Crédito CBS | Mani_Transf_Cred_Cbs_Sucessao | Manifestação sobre transferência de crédito de CBS em sucessão. |
| Fisco - Transf. Crédito IBS | Fisco_Mani_Transf_Cred_Ibs_Sucessao | Manifestação do Fisco sobre transferência de IBS em sucessão. |
| Fisco - Transf. Crédito CBS | Fisco_Mani_Transf_Cred_Cbs_Sucessao | Manifestaçã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:
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
evento.uf | string | ✅ | Código da UF (IBGE) onde o evento será registrado. |
evento.evento.chNFe | string | ✅ | Chave de acesso da NF-e vinculada ao evento. |
evento.evento.tpEvento | string | ✅ | Código do tipo de evento. |
evento.evento.nSeqEvento | string | ✅ | Número sequencial do evento para a mesma NF-e. |
evento.evento.detEvento | objeto | ✅ | Estrutura específica do evento (depende do tipo). |
certificate | string | ✅ | Certificado digital A1 em Base64. |
pass_certificate | string | ✅ | 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..."
---