v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFe

Importar NFe

Importa uma NFe a partir de seu XML.

Na importação é feita apenas a validação da empresa emitente, esta empresa deve estar cadastrada previamente para aceitar as importações. Não há necessidade de ter um certificado digital instalado para aceitar a importação.

Caso a nota seja validada corretamente, a nota será importada e estará disponível para receber outras operações como cancelamento ou carta de correção.

post/nfe/importacao

Query parameters

refstring

Example:12345

Referência única da NFe. Se não informado, será utilizada a chave da nota.

Response

NFe importada com sucesso

cnpj_emitentestring

CNPJ do emitente

refstring

Referência da emissão

status'processando_autorizacao' | 'autorizado' | 'cancelado' | 'erro_autorizacao' | 'denegado'

Status da NFe:

processando_autorizacao: A nota ainda está em processamento
autorizado: A nota foi autorizada
cancelado: O documento foi cancelado
erro_autorizacao: Houve um erro de autorização
denegado: O documento foi denegado

status_sefazstring

Status na SEFAZ

mensagem_sefazstring

Mensagem descritiva da SEFAZ

chave_nfestring

Chave da NFe

numerostring

Número da nota fiscal

seriestring

Série da nota fiscal

caminho_xml_nota_fiscalstring

Caminho para download do XML

caminho_danfestring

Caminho para download do DANFe

caminho_xml_cancelamentostring

Caminho para download do XML de cancelamento

caminho_xml_carta_correcaostring

Caminho para download do XML da carta de correção

caminho_pdf_carta_correcaostring

Caminho para download do PDF da carta de correção

numero_carta_correcaointeger

Número da carta de correção

requisicao_nota_fiscalobject

Dados completos da requisição (quando completa=1)

protocolo_nota_fiscalobject

Dados completos do protocolo (quando completa=1)

requisicao_cancelamentoobject

Dados da requisição de cancelamento (quando completa=1)

protocolo_cancelamentoobject

Dados do protocolo de cancelamento (quando completa=1)

requisicao_carta_correcaoobject

Dados da requisição de CCe (quando completa=1)

protocolo_carta_correcaoobject

Dados do protocolo de CCe (quando completa=1)

Example response

{
  "caminho_xml_carta_correcao": "/arquivos/12345678000123/201906/XMLs/41190612345678000123550010000000221923094166-cce-1.xml",
  "caminho_pdf_carta_correcao": "/notas_fiscais/NFe411906012345678000123550010000000221923094166/cartas_correcao/1.pdf"
}