TF Fiscal
Documentación

Verificación de NF-e

Obtención del DANFE

Devuelve el DANFE de una NF-e verificada por su cuenta, por clave de acceso, como archivo PDF.

GET/openapi/v3/consultas/danfe/{chave}
Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Devuelve el DANFE (formato A4) de una NF-e verificada por su cuenta, como archivo PDF. Cada llamada genera el PDF a partir del veredicto de verificación más reciente de la factura en ese momento; la plataforma no almacena los PDF, la obtención en sí no consulta a la SEFAZ y no se cobra aparte.

Este endpoint tiene su propio alcance, que la plataforma habilita por separado: tener la consulta por chave no da acceso al PDF, y viceversa.

Los fallos devuelven un estado HTTP y un objeto simple {code, message} (códigos al final de la página); los errores llegan en JSON aunque la solicitud lleve Accept: application/pdf. Los fallos de autenticación (401 / 403 / 429) usan el sobre de la plataforma, vea Errores de autenticación y autorización.

Parámetros de ruta

chave*
stringClave de acceso

* Campo obligatorio

200
El DANFE como archivo PDF (no es JSON). Cabeceras de la respuesta: Content-Type: application/pdf; Content-Disposition: inline; filename="{chave}.pdf"; Cache-Control: no-store; X-Tffiscal-Nfe-Status, la situación fiscal que refleja este PDF, Autorizada (versión normal) o Cancelada (con marca de agua de cancelada), para distinguirlas sin interpretar el PDF.

La autenticación es la misma que en la consulta por chave: envíe las cabeceras token, timestamp y sign; el cuerpo del GET es la cadena vacía y la chave forma parte de la ruta firmada (reglas completas en Autenticación). Con app_secret = sk_live_9f8e7d6c5b4a, la chave 35260764962869000108550990001366171195929648 y timestamp = 1784906308, la cadena firmada es:

text
sign_input = "sk_live_9f8e7d6c5b4a"
+ "/openapi/v3/consultas/danfe/35260764962869000108550990001366171195929648"
+ ""
+ "1784906308"
sign = md5Hex(sign_input)