API.UniNFemd

Como autorizar documentos fiscais eletrônicos

Envie documentos fiscais eletrônicos para autorização pela API DFe e valide o retorno da SEFAZ. Este tutorial apresenta o fluxo padrão de autorização para documentos fiscais eletrônicos. O mesmo processo é usado para NF-e, NFC-e, CT-e, CT-e OS, MDF-e, NFCom, NFGas e DC-e.

#autorização fiscal#documentos fiscais eletrônicos#API DFe#NF-e#NFC-e#CT-e#CT-e OS#MDF-e#NFCom#NFGas#DC-e#SEFAZ#DANFE

Como autorizar documentos fiscais eletrônicos

NFS-e Municipal e NFS-e Nacional possuem fluxos próprios e devem ser consultadas em suas documentações específicas.

Pré-requisitos

Antes de iniciar, confirme que você possui:

Token de acesso válido;
Certificado digital A1 cadastrado para o CPF ou CNPJ do emitente;
XML do documento fiscal conforme o layout oficial aplicável;
Ambiente definido corretamente no XML: homologação ou produção.

Utilize o ambiente de homologação para validar toda a integração antes de enviar documentos em produção.

Entenda a rota de autorização

Os endpoints seguem o mesmo padrão:

POST /api/v1/{CPF_CNPJ}/{tipoDFe}/Autorizar

Substitua:

{CPF_CNPJ} pelo CPF ou CNPJ do emitente;
{tipoDFe} pelo tipo de documento fiscal.

Documento	Valor de `{tipoDFe}`
NF-e	`NFe`
NFC-e	`NFCe`
CT-e	`CTe`
CT-e OS	`CTeOS`
MDF-e	`MDFe`
NFCom	`NFCom`
NFGas	`NFGas`
DC-e	`DCe`

Exemplo para NF-e:

POST /api/v1/12345678000199/NFe/Autorizar

Etapa 1: monte o XML do documento

Crie o XML de acordo com o layout oficial do documento fiscal que será autorizado.

Envie somente os dados fiscais exigidos pelo layout. A assinatura digital e as estruturas técnicas de comunicação são processadas pela API com o certificado cadastrado para o emitente.

Consulte os modelos de XML e as regras específicas do documento no Swagger e na documentação da SEFAZ.

Etapa 2: envie o pedido de autorização

Envie uma requisição POST para a rota correspondente, com:

Header Authorization: Bearer {seu_token};
Corpo da requisição contendo o XML do documento;
Content-Type compatível com XML.

Exemplo conceitual:

POST /api/v1/12345678000199/NFe/Autorizar
Authorization: Bearer {seu_token}
Content-Type: application/xml

<NFe>...</NFe>

Etapa 3: valide o retorno

A resposta contém o retorno do processamento da SEFAZ. Verifique principalmente:

O status retornado;
A mensagem de processamento;
O protocolo de autorização, quando o documento for autorizado;
As rejeições, quando houver inconsistências no XML ou nas regras fiscais.

Armazene o XML de retorno e o protocolo junto ao documento emitido. Eles são necessários para auditoria, consulta e operações posteriores, como cancelamento ou carta de correção.

Autorizar e obter o DANFE na mesma chamada

Para os documentos que oferecem essa opção, utilize a variação da rota com DANFE:

POST /api/v1/{CPF_CNPJ}/{tipoDFe}/AutorizarComDanfe

Essa operação autoriza o documento e retorna o conteúdo necessário para gerar ou exibir o DANFE, evitando uma chamada adicional após a autorização.

Erros comuns

Credenciais inválidas: verifique o token de acesso. Uma resposta 401 com Invalid client or Invalid client credentials é uma falha de autenticação.
Certificado não encontrado ou inválido: confirme se há um certificado A1 válido associado ao mesmo CPF ou CNPJ da rota.
Rejeição da SEFAZ: revise o XML, o ambiente informado e as regras fiscais do documento.
Documento duplicado: consulte a situação pela chave de acesso antes de reenviar uma autorização cuja resposta não foi recebida.

Próximos passos

Após a autorização, você pode consultar o documento, baixar ou gerar o DANFE e enviar eventos posteriores, como cancelamento ou carta de correção, quando aplicável.