TF Fiscal
Documentación

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. Los ids desconocidos devuelven HTTP 404 + NFe0001. Los errores de autenticación (10009xxx) están en Autenticación.

Parámetros

Parámetros de ruta

  • empresaIdstringobligatorio

    Identificador de la empresa devuelto en Registrar empresa.

    Ejemplo: 1934811222334455
  • nfeIdstringobligatorio

    El id enviado en la emisión.

    Ejemplo: NFe-000014553

Respuestas

200

Factura encontrada.

  • idstring

    Id de la solicitud de emisión.

  • tipostring

    Siempre NF-e.

  • statusstring

    AguardandoAutorizacao en proceso / Autorizada autorizada / Negada denegada / Cancelada cancelada.

    Valores:AguardandoAutorizacaoAutorizadaNegadaCancelada
  • motivoStatusstring

    Motivo del rechazo: código de estado de la SEFAZ + descripción, por ejemplo 778 - Rejeicao: NCM inexistente; presente solo en Negada.

  • ambienteEmissaostring

    Homologacao / Producao.

  • enviadaPorEmailboolean

    Siempre false (la plataforma no envía facturas por correo).

  • dataCriacaostring

    Momento en que se aceptó la solicitud de emisión, ISO-8601 UTC.

  • dataUltimaAlteracaostring

    Última actualización.

  • forcarEmissaoContingenciaboolean

    Siempre false.

  • pedidoobject

    Datos del pedido.

  • clienteobject

    Datos del cliente.

  • numerostring

    Número de la factura nNF (string).

  • seriestring

    Serie.

  • dataEmissaostring

    Momento de la emisión.

  • chaveAcessostring

    Clave de acceso de 44 dígitos.

  • transporteobject

    Transporte.

  • dataAutorizacaostring

    Momento de la autorización en la SEFAZ; vacío hasta autorizar.

  • linkDanfestring

    Enlace de descarga del DANFE en PDF, solo Autorizada; la primera descarga dispara el renderizado. Vea Descarga de archivos.

  • linkDownloadXmlstring

    Enlace de descarga del XML autorizado, cuando existe un XML. Vea Descarga de archivos.

  • linkConsultaPorChaveAcessostring

    Siempre la cadena vacía.

  • protocoloobject

    Protocolo de autorización.

  • emitidaEmContingenciaboolean

    Si se emitió en contingencia.

  • finalidadestring

    Finalidad de la factura devuelta: Normal / Devolucao.

  • notaReferenciadaobject

    Las facturas de devolución devuelven la clave de acceso de la factura original.

  • itensarray

    Ítems de la factura.

  • valorTotalnumber

    Total de la factura.

  • informacoesAdicionaisstring

    Información adicional, no se proporciona por el momento.

  • informacoesAdicionaisFiscostring

    Información adicional para el fisco, no se proporciona por el momento.

Errores

CódigoHTTP
NFe0001404

El nfeId no existe. Verifique el id enviado en la emisión y el empresaId.

10003000404

empresaId no existe o no pertenece a esta aplicación.

Semántica de los estados

AguardandoAutorizacao desde la aceptación hasta la respuesta de la SEFAZ; Autorizada una vez autorizada; Negada cuando se rechaza (motivoStatus explica el motivo: corrija y reenvíe); Cancelada tras una cancelación exitosa.

Enlaces de descarga (`linkDanfe` / `linkDownloadXml`)

Los enlaces tienen el formato https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=… y no necesitan cabeceras de firma: basta un GET simple que siga la redirección 302. Cada consulta emite enlaces nuevos; un enlace expirado devuelve 401 + 10009036. La validez, el renderizado bajo demanda del DANFE y el resto de errores están en Descarga de archivos.

AnteriorEmitir NF-eSiguienteCancelar NF-e