NF-e

Consultar NF-e

Devuelve estado, datos de la factura y enlaces de descarga del DANFE / XML.

GET/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

nfeId es el id enviado en la emisión. La respuesta devuelve la solicitud de emisión con la misma forma, más los datos que devolvió la SEFAZ. Los errores de autenticación (10009xxx) están en Autenticación.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa
`nfeId*`	string	Identificador de la factura

* Campo obligatorio

200

Factura encontrada.

`id`	string	Identificador de la solicitud
`tipo`	string	Tipo del documento
`status`	string	Estado de la factura
`motivoStatus`	string	Motivo de la denegación
`ambienteEmissao`	string	Ambiente
`enviadaPorEmail`	bool	Enviada por correo
`dataCriacao`	string	Fecha de aceptación
`dataUltimaAlteracao`	string	Última modificación
`forcarEmissaoContingencia`	bool	Contingencia forzada
	object	Pedido
	object	Comprador
`numero`	string	Número de la factura
`serie`	string	Serie de la factura
`dataEmissao`	string	Fecha de emisión
`chaveAcesso`	string	Clave de acceso
	object	Transporte
`dataAutorizacao`	string	Fecha de autorización
`linkDanfe`	string	Enlace del DANFE
`linkDownloadXml`	string	Enlace del XML autorizado
`linkConsultaPorChaveAcesso`	string	Consulta pública
	object	Protocolo de autorización
`emitidaEmContingencia`	bool	Emitida en contingencia
`finalidade`	string	Finalidad
`naturezaOperacao`	string	Naturaleza de la operación
	object	Factura original
	array	Ítems
`valorTotal`	number	Importe total de la factura
`informacoesAdicionais`	string	Observaciones de la factura
`informacoesAdicionaisFisco`	string	Observaciones al fisco

La factura permanece en AguardandoAutorizacao hasta que la SEFAZ responde, y termina en Autorizada, Negada o Cancelada. En los estados finales la plataforma descarta los parámetros de la solicitud: pedido, observaciones, naturezaOperacao y los parámetros de impuesto más allá de código y alícuota dejan de venir.

AguardandoAutorizacao: en proceso

Desde la aceptación hasta la respuesta de la SEFAZ. Sin número, clave, protocolo ni enlaces; pedido, cliente y todos los parámetros de impuesto se devuelven como se enviaron. Consulte de nuevo o espere el callback.

json

{
  "id": "NFe-000014553",
  "status": "AguardandoAutorizacao",
  "numero": null,
  "chaveAcesso": null,
  "dataAutorizacao": null,
  "linkDanfe": null,
  "linkDownloadXml": null,
  "pedido": { "presencaConsumidor": "OperacaoPelaInternet", "pagamento": { "tipo": "PagamentoAVista", "formas": [ { "tipo": "CartaoDeCredito", "valor": 28.47 } ] } },
  "itens": [ { "cfop": "6102", "codigo": "000068", "origem": 0, "impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49", "aliquota": 0 }, "cofins": { "situacaoTributaria": "49", "aliquota": 0 } } } ]
}

Autorizada: autorizada por la SEFAZ

Número, clave, dataAutorizacao, protocolo y los dos enlaces informados. Cada consulta genera enlaces nuevos.

json

{
  "id": "NFe-000014553",
  "status": "Autorizada",
  "numero": "262",
  "serie": "2",
  "chaveAcesso": "35241104893402000113550020000002621202427463",
  "dataAutorizacao": "2024-11-27T20:56:55Z",
  "protocolo": { "numero": "135240009194753" },
  "linkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfe/35241104893402000113550020000002621202427463?token=…",
  "linkDownloadXml": "https://api.v2.tffiscal.com/openapi/files/xml/8801?token=…"
}

Negada: rechazada por la SEFAZ

motivoStatus trae el código y el motivo de la SEFAZ. Sin DANFE; el número, si ya se asignó, se reutiliza en las próximas emisiones, sin saltar números. Corrija la solicitud y emita de nuevo.

json

{
  "id": "NFe-000014553",
  "status": "Negada",
  "motivoStatus": "778 - Rejeicao: NCM inexistente",
  "linkDanfe": null,
  "linkDownloadXml": null
}

Cancelada: cancelada después de autorizada

Después de Cancelar NF-e. Número, clave y protocolo permanecen; el DANFE deja de venir y el XML sigue disponible.

json

{
  "id": "NFe-000014553",
  "status": "Cancelada",
  "numero": "262",
  "chaveAcesso": "35241104893402000113550020000002621202427463",
  "protocolo": { "numero": "135240009194753" },
  "linkDanfe": null,
  "linkDownloadXml": "https://api.v2.tffiscal.com/openapi/files/xml/8801?token=…"
}

`status`Estado de la factura

Valores	Significado
AguardandoAutorizacao	Aceptada, esperando la respuesta de la SEFAZ
Autorizada	Autorizada por la SEFAZ; DANFE y XML disponibles
Negada	Rechazada por la SEFAZ; motivo en `motivoStatus`
Cancelada	Cancelada después de autorizada

`ambienteEmissao`Ambiente de emisión

Valores	Significado
Homologacao	Ambiente de prueba de la SEFAZ; la factura no tiene validez
Producao	Ambiente oficial

`finalidade`Finalidad de la factura

Valores	Significado
Normal	Venta común
Complementar	Factura complementaria de una factura ya autorizada
Ajuste	Factura de ajuste de una factura ya autorizada
Devolucao	Devolución de una factura ya autorizada; trae `notaReferenciada`

`pedido.presencaConsumidor`Presencia del comprador

Valores	Significado
NaoSeAplica	No aplica; devolución
OperacaoPresencial	Venta presencial en la tienda
OperacaoPelaInternet	Venta por internet
OperacaoPorTelefone	Venta por teléfono
EntregaEmDomicilio	Venta cerrada en la entrega a domicilio
OperacaoPresencialForaDoEstabelecimento	Venta presencial fuera de la tienda
Outros	Otros

`pedido.pagamento.tipo`Plazo del pago

Valores	Significado
PagamentoAVista	Al contado
PagamentoAPrazo	A plazo

`pedido.pagamento.formas[].tipo`Forma de pago

Valores	Significado
Dinheiro	Efectivo
Cheque	Cheque
CartaoDeCredito	Tarjeta de crédito
CartaoDeDebito	Tarjeta de débito
CreditoLoja	Crédito de tienda
ValeAlimentacao	Vale de alimentación
ValeRefeicao	Vale de comida
ValePresente	Vale de regalo
ValeCombustivel	Vale de combustible
BoletoBancario	Boleto bancario
DepositoBancario	Depósito bancario
PagamentoInstantaneoPix	Pix
TransferenciaBancaria	Transferencia bancaria
ProgramaDeFidelidade	Programa de fidelidad o cashback
PagamentoInstantaneoPixEstatico	Pix estático
CreditoEmLoja	Saldo en tienda
PagamentoEletronicoNaoInformado	Pago electrónico no informado
PagamentoInstantaneoPixAutomatico	Pix automático
TransferenciaTefBookTransfer	Transferencia TEF en el mismo banco
SemPagamento	Sin pago; devolución
PagamentoPosterior	Pago posterior
Outros	Otros

`cliente.indicadorContribuinteICMS`Situación del comprador ante el ICMS

Tras el estado final solo ContribuinteICMS (CNPJ con inscripción estatal) o NaoContribuinte.

Valores	Significado
ContribuinteICMS	Contribuyente con inscripción estatal
ContribuinteIsento	Exento de inscripción estatal
NaoContribuinte	No contribuyente

`cliente.tipoPessoa`Tipo de comprador

Valores	Significado
F	Persona física; CPF de 11 dígitos
J	Persona jurídica; CNPJ de 14 dígitos

`cliente.endereco.uf`Estado del comprador

EX solo en factura de exportación.

Valores	Significado
AC	Acre
AL	Alagoas
AP	Amapá
AM	Amazonas
BA	Bahia
CE	Ceará
DF	Distrito Federal
ES	Espírito Santo
GO	Goiás
MA	Maranhão
MT	Mato Grosso
MS	Mato Grosso do Sul
MG	Minas Gerais
PA	Pará
PB	Paraíba
PR	Paraná
PE	Pernambuco
PI	Piauí
RJ	Rio de Janeiro
RN	Rio Grande do Norte
RS	Rio Grande do Sul
RO	Rondônia
RR	Roraima
SC	Santa Catarina
SP	São Paulo
SE	Sergipe
TO	Tocantins
EX	Exterior (factura de exportación)

`transporte.frete.modalidade`Modalidad del flete

Valores	Significado
SemFrete	Sin flete
PorContaDoEmitente	Flete por cuenta del vendedor
PorContaDoDestinatario	Flete por cuenta del comprador
PorContaDeTerceiros	Flete por cuenta de terceros
TransporteProprioPorContaDoRemetente	Transporte propio del vendedor
TransporteProprioPorContaDoDestinatario	Transporte propio del comprador

`itens[].origem`Origen del producto

Valores	Significado
0	Nacional
1	Importado directamente
2	Importado, comprado en el mercado interno
3	Nacional con más del 40 % de contenido importado
4	Nacional por proceso productivo básico
5	Nacional con hasta 40 % de contenido importado
6	Importado directamente, sin similar nacional
7	Importado del mercado interno, sin similar nacional
8	Nacional con más del 70 % de contenido importado

`itens[].impostos.icms.situacaoTributaria`CST del ICMS (régimen normal, CRT 2 / 3)

Valores	Significado
00	Gravada íntegramente
02	Monofásica propia (combustibles)
10	Gravada con cobro de ST
15	Monofásica propia y con retención (combustibles)
20	Con reducción de base de cálculo
30	Exenta o no gravada, con cobro de ST
40	Exenta
41	No gravada
50	Suspensión
51	Diferimiento
53	Monofásica con diferimiento (combustibles)
60	ICMS cobrado anteriormente por ST
61	Monofásica cobrada anteriormente (combustibles)
70	Con reducción de base y cobro de ST
90	Otras

`itens[].impostos.icms.situacaoTributaria`CSOSN del ICMS (Simples Nacional, CRT 1 / 4)

Valores	Significado
101	Gravada con permiso de crédito
102	Gravada sin permiso de crédito
103	Exención por franja de ingresos
201	Gravada con permiso de crédito y cobro de ST
202	Gravada sin permiso de crédito y con cobro de ST
203	Exención por franja de ingresos, con cobro de ST
300	Inmune
400	No gravada
500	ICMS cobrado anteriormente por ST
900	Otros

`itens[].impostos.pis.situacaoTributaria`CST del PIS

Valores	Significado
01	Gravado a la alícuota básica
02	Gravado a alícuota diferenciada
03	Gravado por cantidad
04	Monofásico, reventa a alícuota cero
05	Sustitución tributaria
06	Alícuota cero
07	Exenta
08	Sin incidencia (exportación)
09	Suspensión
49	Otras operaciones de salida
50–56	Entrada con derecho a crédito, por tipo de ingreso (solo devolución)
60–66	Entrada con crédito presunto, por tipo de ingreso (solo devolución)
67	Crédito presunto, otras operaciones (solo devolución)
70	Entrada sin derecho a crédito
71	Entrada con exención
72	Entrada con suspensión
73	Entrada a alícuota cero
74	Entrada sin incidencia
75	Entrada por sustitución tributaria
98	Otras operaciones de entrada
99	Otras operaciones

`itens[].impostos.cofins.situacaoTributaria`CST de la COFINS

Misma tabla que el PIS.

Valores	Significado
01	Gravado a la alícuota básica
02	Gravado a alícuota diferenciada
03	Gravado por cantidad
04	Monofásico, reventa a alícuota cero
05	Sustitución tributaria
06	Alícuota cero
07	Exenta
08	Sin incidencia (exportación)
09	Suspensión
49	Otras operaciones de salida
50–56	Entrada con derecho a crédito, por tipo de ingreso (solo devolución)
60–66	Entrada con crédito presunto, por tipo de ingreso (solo devolución)
67	Crédito presunto, otras operaciones (solo devolución)
70	Entrada sin derecho a crédito
71	Entrada con exención
72	Entrada con suspensión
73	Entrada a alícuota cero
74	Entrada sin incidencia
75	Entrada por sustitución tributaria
98	Otras operaciones de entrada
99	Otras operaciones

`itens[].impostos.ipi.situacaoTributaria`CST del IPI

Valores	Significado
00	Entrada con recuperación de crédito
01	Entrada gravada a alícuota cero
02	Entrada exenta
03	Entrada no gravada
04	Entrada inmune
05	Entrada con suspensión
49	Otras entradas
50	Salida gravada
51	Salida gravada a alícuota cero
52	Salida exenta
53	Salida no gravada
54	Salida inmune
55	Salida con suspensión
99	Otras salidas

Código	HTTP
10004000	404	El `nfeId` no existe. Verifique el id enviado en la emisión y el `empresaId`.
10004001	404	El `nfeId` no existe. Verifique el id enviado en la emisión y el `empresaId`.
10003000	404	`empresaId` no existe o no pertenece a esta aplicación.

Consultar NF-e

Parámetros

Parámetros de ruta

Respuestas

Qué viene en cada estado4 bloques

AguardandoAutorizacao: en proceso

Autorizada: autorizada por la SEFAZ

Negada: rechazada por la SEFAZ

Cancelada: cancelada después de autorizada

Enlaces de descarga

Enumeraciones16 tablas

statusEstado de la factura

ambienteEmissaoAmbiente de emisión

finalidadeFinalidad de la factura

pedido.presencaConsumidorPresencia del comprador

pedido.pagamento.tipoPlazo del pago

pedido.pagamento.formas[].tipoForma de pago

cliente.indicadorContribuinteICMSSituación del comprador ante el ICMS

cliente.tipoPessoaTipo de comprador

cliente.endereco.ufEstado del comprador

transporte.frete.modalidadeModalidad del flete

itens[].origemOrigen del producto

itens[].impostos.icms.situacaoTributariaCST del ICMS (régimen normal, CRT 2 / 3)

itens[].impostos.icms.situacaoTributariaCSOSN del ICMS (Simples Nacional, CRT 1 / 4)

itens[].impostos.pis.situacaoTributariaCST del PIS

itens[].impostos.cofins.situacaoTributariaCST de la COFINS

itens[].impostos.ipi.situacaoTributariaCST del IPI

Errores3 ítems

`status`Estado de la factura

`ambienteEmissao`Ambiente de emisión

`finalidade`Finalidad de la factura

`pedido.presencaConsumidor`Presencia del comprador

`pedido.pagamento.tipo`Plazo del pago

`pedido.pagamento.formas[].tipo`Forma de pago

`cliente.indicadorContribuinteICMS`Situación del comprador ante el ICMS

`cliente.tipoPessoa`Tipo de comprador

`cliente.endereco.uf`Estado del comprador

`transporte.frete.modalidade`Modalidad del flete

`itens[].origem`Origen del producto

`itens[].impostos.icms.situacaoTributaria`CST del ICMS (régimen normal, CRT 2 / 3)

`itens[].impostos.icms.situacaoTributaria`CSOSN del ICMS (Simples Nacional, CRT 1 / 4)

`itens[].impostos.pis.situacaoTributaria`CST del PIS

`itens[].impostos.cofins.situacaoTributaria`CST de la COFINS

`itens[].impostos.ipi.situacaoTributaria`CST del IPI