# Vista previa de una factura en PDF > `POST https://api.cfdi.express/v1/invoices/preview/pdf` — Desde la v1.53.0, la misma vista previa en PDF: plantilla del PDF timbrado, marca de agua PREVIEW y sin UUID, sellos ni QR. No timbra ni cobra. URL de esta página: https://cfdi.express/docs/api/vista-previa-factura-pdf Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`) Header `x-account-id`: indica la cuenta. Si no eres miembro, la respuesta es 403. Mismo cuerpo y mismas validaciones que [POST /v1/invoices/preview](https://cfdi.express/docs/api/vista-previa-factura). Con `delivery=file` (el default) responde el PDF con `Content-Type: application/pdf`, `Cache-Control: no-store` y `Content-Disposition: attachment`. El archivo se llama `Vista previa factura {serie} {folio}.pdf`, por ejemplo `Vista previa factura A 53.pdf`. Con `delivery=url` sube el PDF y responde JSON con una liga firmada que vence en 15 minutos. Es el único caso en que se guarda algo: el PDF temporal de la liga. ### Query string | Campo | Tipo | Requerido | Descripción | |---|---|---|---| | `delivery` | string | no | file (default): el PDF. url: JSON con una liga temporal de descarga. | ## Ejemplos ### cURL — guardar el PDF ```bash curl -X POST "https://api.cfdi.express/v1/invoices/preview/pdf" \ -H "Authorization: Bearer sk_test_..." \ -H "Content-Type: application/json" \ -d @factura.json \ -o "vista-previa.pdf" ``` ### cURL — liga temporal ```bash curl -X POST "https://api.cfdi.express/v1/invoices/preview/pdf?delivery=url" \ -H "Authorization: Bearer sk_test_..." \ -H "Content-Type: application/json" \ -d @factura.json ``` ## Respuesta ### 200 OK (delivery=url) ```json { "object": "invoice_preview_pdf", "filename": "Vista previa factura A 53.pdf", "url": "https://files.cfdi.express/previews/...pdf?X-Amz-Expires=900&...", "expiresAt": "2026-11-17T17:45:00.000Z" } ``` ## Errores | Status | code | Cuándo aparece | |---|---|---| | 400 | `validation_error` | El mismo cuerpo lo rechazaría POST /v1/invoices, o delivery no es file ni url. | | 401 | `unauthorized` | Falta el header Authorization o la llave es inválida. | | 403 | `forbidden` | No eres miembro de la cuenta del header x-account-id. | | 404 | `not_found` | El merchantId no existe en tu cuenta. | | 429 | `rate_limited` | Excediste el límite de requests por minuto de tu cuenta (300 por default). La respuesta incluye Retry-After. | | 503 | `pdf_unavailable` | El generador de PDF no está disponible, o el almacenamiento no está disponible con delivery=url (usa delivery=file). Reintenta en unos momentos. | ## Notas - El PDF lleva la leyenda «VISTA PREVIA — SIN VALIDEZ FISCAL» y el pie «Vista previa de un CFDI versión 4.0 — no es un comprobante fiscal.». En lugar del UUID dice «Se asigna al timbrar». - Por MCP es la herramienta `download_invoice_preview_pdf`, que solo puede llamar la tarjeta de vista previa (botón «Descargar PDF»), no el modelo. ## Relacionados - [POST /v1/invoices/preview](https://cfdi.express/docs/api/vista-previa-factura) — Vista previa de factura - [POST /v1/invoices](https://cfdi.express/docs/api/timbrar-factura) — Timbrar factura --- Referencia completa: https://cfdi.express/docs/api · OpenAPI: https://api.cfdi.express/openapi.json · Llaves: https://dash.cfdi.express