Eventos vinculados a uma NF-e ou NFC-e já autorizada. Cada evento é um registro legal que altera, complementa ou anula o documento fiscal original, sem substituí-lo.
Eventos disponíveis
- Carta de Correção (CC-e) – corrige erros formais da NF-e já emitida (ex.: descrição de mercadoria, códigos sem impacto fiscal). Não pode ser usada para alterar valores fiscais, partes envolvidas, datas ou número/série.
- Cancelamento – anula uma NF-e/NFC-e já autorizada, dentro do prazo legal e antes da circulação da mercadoria. Prazo de 24 horas para NF-e e 30 minutos para NFC-e após a autorização.
- Manifestação do Destinatário – permite ao destinatário confirmar, negar ou controlar a participação em uma NF-e emitida contra seu CNPJ, auxiliando no controle de fornecedores e evitando uso indevido.
- Inutilização de Numeração – comunica à SEFAZ números de NF-e que não serão utilizados, corrigindo quebras na sequência. Só pode ser usada para números nunca emitidos (não autorizados, cancelados ou denegados).
Atenção
Cada evento possui regras próprias - prazos, restrições de uso e requisitos específicos. Consulte a descrição de cada endpoint antes de utilizá-lo. Eventos expirados podem exigir alternativas como NF-e de devolução ou cancelamento extemporâneo, conforme a UF.
Carta de Correção
A Carta de Correção Eletrônica (CC-e) é um evento legal utilizado para corrigir informações específicas de uma NF-e já emitida.
O que NÃO pode ser corrigido pela CC-e?
- Valores fiscais como base de cálculo, alíquota, diferença de preço e quantidade.
- Dados cadastrais que impliquem mudança do remetente ou destinatário.
- Data de emissão ou data de saída.
- Série ou número da Nota Fiscal.
Quando NÃO é possível usar a CC-e?
Se a alteração desejada não se enquadrar nas regras permitidas, é necessário emitir uma NF de devolução para anular os efeitos fiscais da nota original. Após isso, emita uma nova NF-e com os dados corrigidos.
Como funciona na API
Este endpoint permite registrar uma Carta de Correção vinculada a uma NF-e previamente autorizada. A SEFAZ retornará o protocolo de autorização do evento.
Nota: Certifique-se de que o conteúdo da correção siga rigorosamente as regras previstas pela legislação para evitar rejeições pela SEFAZ.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Carta de Correção › Request Body
TipoAmbienteAmbiente de emissão do evento.
Ambiente de emissão
- 1 (Produção) - o documento emitido tem validade fiscal real e é reportado ao destinatário.
- 2 (Homologação) - ambiente de teste; a SEFAZ descarta o documento após alguns dias, sem efeito fiscal.
Use homologação durante o desenvolvimento e a integração; só alterne para produção depois que o fluxo estiver validado.
Valores Possíveis:
1: Produção
2: Homologação
ChaveNFChave de acesso da NF-e (44 dígitos).
CorrecaoDescrição da correção da NF-e.
NumeroSequencialNúmero sequencial dos eventos do documento.
Quando não informado o controle do sequencial e realizado pelo Brasil NFe
Lista de correções estruturadas. Uso exclusivo para CT-e (carta de correção eletrônica com grupo/campo/valor).
Carta de Correção › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).
Cancelamento
Este artigo explica como é efetuado o cancelamento de uma NF-e ou NFC-e.
Atenção!
Uma NF-e só pode ser cancelada se:
- Seu uso já tiver sido autorizado pelo Fisco.
- Não tiver ocorrido o fato gerador, ou seja, a mercadoria ainda não saiu do estabelecimento.
Prazos para cancelamento
- O prazo máximo para cancelamento de uma NF-e é de 24 horas após a autorização de uso.
- O prazo máximo para cancelamento de uma NFC-e é de 30 minutos após a autorização.
E se o prazo já tiver passado?
Caso o prazo de cancelamento tenha expirado ou a mercadoria já tenha circulado, deve-se emitir uma NF-e de devolução para anular os efeitos fiscais da nota original ou solicitar o cancelamento extemporâneo caso a UF permitir.
Como funciona na API
Este endpoint permite registrar o evento de cancelamento vinculado a uma NF-e ou NFC-e. A SEFAZ retornará o protocolo de autorização do cancelamento.
Nota: Verifique sempre os prazos de cada UF, pois a legislação pode definir regras específicas.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Cancelamento › Request Body
ChaveNFChave de acesso do Documento Fiscal (44 dígitos).
JustificativaJustificativa do cancelamento do documento fiscal.
NumeroProtocoloNúmero de protocolo de autorização do documento.
Obrigatório caso a nota foi emitida por outro sistema
NumeroSequencialNúmero sequencial do evento de correção.
Quando não informado o controle do sequencial e realizado pelo Brasil NFe
DataEventoData do evento de cancelamento. Quando não informado, é considerada a data e hora atual.
CpfCnpjRemetenteDCeCPF ou CNPJ do Usuário Emitente (Remetente) da DC-e original. Obrigatório no cancelamento de DC-e quando a nota não está cadastrada no sistema (caso esteja, o valor é lido da própria NotaFiscal).
Cancelamento › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).
Manifestação do Destinatário
Este artigo explica como é enviada a Manifestação do Destinatário referente a uma NF-e.
A Manifestação do Destinatário é um conjunto de eventos que permite ao destinatário confirmar, negar ou controlar sua participação comercial descrita no documento fiscal. Dessa forma, o destinatário pode validar as informações fornecidas pelo emissor, garantindo maior segurança e rastreabilidade nas operações.
Para que serve?
A manifestação possibilita ao destinatário:
- Confirmar a autenticidade da operação.
- Registrar que não reconhece a NF-e recebida.
- Informar que a operação não foi realizada.
- Auxiliar no controle de fornecedores e evitar uso indevido de seu CNPJ.
Como funciona na API
Este endpoint permite enviar um evento de manifestação associado a uma NF-e específica, retornando o protocolo de autorização da SEFAZ.
Nota: Cada tipo de manifestação segue regras próprias definidas pelo Ajuste SINIEF e deve ser utilizado conforme o cenário da operação.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Manifestação do Destinatário › Request Body
TipoAmbienteAmbiente de emissão do evento.
Ambiente de emissão
- 1 (Produção) - o documento emitido tem validade fiscal real e é reportado ao destinatário.
- 2 (Homologação) - ambiente de teste; a SEFAZ descarta o documento após alguns dias, sem efeito fiscal.
Use homologação durante o desenvolvimento e a integração; só alterne para produção depois que o fluxo estiver validado.
Valores Possíveis:
1: Produção
2: Homologação
TipoManifestacaoTipo da manifestação.
Valores Possíveis:
1: Confirmacao da Operacao
2: Ciência da Operacao
3: Desconhecimento da Operacao
4: Operacao não Realizada
ChaveChave de acesso da NF-e (44 dígitos).
JustificativaJustificativa da manifestação. Obrigatória quando TipoManifestacao = 4 (Operação não Realizada), mínimo de 15 caracteres. Para os demais tipos pode ser omitida.
NumeroSequencialNúmero sequencial dos eventos do documento.
Quando não informado o controle do sequencial e realizado pelo Brasil NFe
Manifestação do Destinatário › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).
Inutilizar Numeração
Este artigo explica como é efetuada a inutilização de numerações de documentos fiscais.
O endpoint aceita os modelos 55 (NF-e), 65 (NFC-e) e 57 (CT-e) no campo ModeloDocumento, e tem como finalidade permitir que o emissor comunique à SEFAZ os números que não serão utilizados, geralmente devido a uma quebra na sequência de numeração. Isso evita inconsistências fiscais e garante que a empresa mantenha um histórico numérico contínuo e regular.
Quando posso inutilizar uma numeração?
A inutilização só pode ser realizada quando:
- O número nunca foi utilizado em nenhum documento fiscal, seja autorizado, cancelado ou denegado.
- A comunicação é feita até o décimo dia do mês subsequente ao da ocorrência da falha na sequência.
Exemplos comuns de quebra de sequência
- Erros no sistema de emissão.
- Numeração pulada acidentalmente.
- Documento iniciado, mas não transmitido.
Por que inutilizar?
A inutilização garante:
- Regularidade fiscal perante a SEFAZ.
- Coerência na sequência numérica.
- Evita questionamentos sobre “documentos fiscais faltantes”.
Como funciona na API
Este endpoint permite enviar o evento de Inutilização de Numeração para NF-e, NFC-e ou CT-e, informando o modelo do documento, faixa inicial, faixa final, série e justificativa. A SEFAZ retornará o protocolo de autorização da inutilização.
Nota: A inutilização não substitui o cancelamento. Utilize-a apenas para números que não chegaram a gerar um documento fiscal, independentemente do motivo.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Inutilizar Numeração › Request Body
JustificativaJustificativa da inutilização.
TipoAmbienteAmbiente da inutilização.
Ambiente de emissão
- 1 (Produção) - o documento emitido tem validade fiscal real e é reportado ao destinatário.
- 2 (Homologação) - ambiente de teste; a SEFAZ descarta o documento após alguns dias, sem efeito fiscal.
Use homologação durante o desenvolvimento e a integração; só alterne para produção depois que o fluxo estiver validado.
Valores Possíveis:
1: Produção
2: Homologação
ModeloDocumentoCódigo do modelo do Documento Fiscal a inutilizar. Aceita 55 (NF-e), 65 (NFC-e) ou 57 (CT-e).
Valores Possíveis:
55: NF-e
65: NFC-e
57: CT-e
SerieSérie referente ao modelo do documento
NumeracaoInicialInicio da range numérico de inutilização
NumeracaoFinalFinal da range numérico de inutilização
Inutilizar Numeração › Responses
Successful operation
DsMotivoDescrição do status do evento emitido
DsEventoDescrição do evento emitido
DsAmbienteDescrição do ambiente em que foi emitido o evento
NuProtocoloNúmero de protocolo do evento
CodStatusRespostaSefazCódigo de status de resposta da SEFAZ
NumeroSequencialNúmero sequencial do evento
StatusStatus do evento
Valores Possíveis:
1: Evento Processado
2: Aguardando Processamento do Evento
3: Ocorreu um erro ao processar o evento
ErrorDescrição do erro quando ocorrer
AvisosLista de avisos não-bloqueantes do evento (vazia em sucesso sem ressalvas).

