Pular para o conteúdo principal

Registrar um evento de autoridade (NT 2025.002-RTC) para uma Nota Fiscal Eletrônica (NFE)

POST 
/v2/companies/:companyId/productinvoices/:invoiceId/authority-events

Informações adicionais​

⛔ Indisponível no momento. Este recurso está implementado na API, mas protegido por uma feature flag que ainda não foi habilitada — qualquer chamada responde 503 Service Unavailable com a mensagem DFe events surface is currently disabled in this environment.. A liberação será comunicada; até lá o contrato pode mudar.

Registra um evento da NT 2025.002-RTC (Reforma Tributária do Consumo) numa NF-e já autorizada. Um único endpoint atende os 7 eventos do escopo do emitente; o tipo é escolhido pelo campo type (case-sensitive) e os campos do evento vão na raiz do body. | type | tpEvento | Uso | |---|---|---| | ExpectedDeliveryUpdate | 112150 | Atualizar a data de previsão de entrega | | IntegralPayment | 112110 | Informar pagamento integral (libera crédito presumido do adquirente) | | Spoilage | 112130 | Perecimento, perda, roubo ou furto em transporte contratado pelo fornecedor (CIF) | | UnfulfilledSupply | 112140 | Itens pagos antecipadamente que não foram fornecidos | | AlcZfmImport | 112120 | Importação em ALC/ZFM não convertida em isenção | | PersonalUseAllocation | 211120 | Destinação de item de NF-e de importação para consumo pessoal | | CancelDFeEvent | 110001 | Cancelar um evento já registrado |

ATENÇÃO: o envio ao SEFAZ é assíncrono. O retorno 202 confirma apenas o registro e o enfileiramento — o resultado final chega por WebHook (dfe_event_successfully, dfe_event_error, dfe_event_failed, dfe_event_cancelled) ou por consulta ao evento.

Cancelamento usa este mesmo endpoint com type: "CancelDFeEvent" — não existe rota /cancel. Informe o targetEventId (o id do evento obtido na consulta) e a justificativa (15 a 1000 caracteres). Só é possível cancelar evento com status igual a Merged e que ainda não tenha sido cancelado.

Válido apenas para NF-e (modelo 55); NFC-e está fora do escopo da NT.

Request​

Responses​

Evento registrado e enfileirado para envio ao SEFAZ

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.