# Solucionar problemas comunes

Solucionar problemas de renderizado, datos faltantes, imágenes bloqueadas y saltos de página.

## La vista previa funciona pero el renderizado no
Verifique la versión publicada, la clave/proyecto, `template:render`, la cuota y obtenga una vista previa de las advertencias de recursos. La vista previa puede omitir imágenes no permitidas, mientras que una representación real las rechaza.

## Identifique el error antes de volver a intentarlo

| Código o síntoma | Acción |
| --- | --- |
| `PDF_TEMPLATE_VERSION_NOT_PUBLISHED` | Abra la versión de destino en el editor y publíquela, luego vuelva a intentar realizar el trabajo. |
| `PDF_INVALID_API_KEY` / `PDF_API_KEY_INSUFFICIENT_SCOPE` | Verifique la clave activa, el proyecto correcto y el alcance `template:render`. |
| `PDF_RENDER_QUOTA_EXCEEDED` / `quota_exceeded` | Verifique el uso del espacio de trabajo en Configuración. Los POST repetidos no restablecen la cuota. |
| `EXTERNAL_IMAGES_NOT_ALLOWED` | Lea la advertencia de vista previa y [image Policy](/docs/es/assets/images/); utilizar los recursos permitidos por el plan del espacio de trabajo. |
| `ASSET_STORAGE_PLAN_REQUIRED` | Actualmente, el espacio de trabajo no puede servir a los activos del proyecto. Consulta el aviso de plan y almacenamiento en Assets. |
| `RENDER_TIMEOUT` | Simplifique o divida contenido grande, reduzca el trabajo con imágenes y verifique el límite de procesamiento antes de volver a intentarlo. |
| 404 inmediatamente después del render 202 | Mantenga el ID de renderizado aceptado y [siga la guía de reintento de estado](/docs/es/developers/render-reference/). |
| PDF todavía muestra una etiqueta antigua | Guarde el diseño y luego regenere la vista previa de PDF. Las entradas Run no actualizan los valores de la vista previa del editor. |

## Datos faltantes
Verifique los nombres, los enlaces `params`, el alcance de la propiedad y la variante seleccionada. En las matrices, inspeccione el contexto del elemento y la forma JSON completa.

## Recorte o exceso de espacios en blanco
Inspeccione las alturas fijas/desbordamiento, márgenes, fuentes y configuraciones de mantenimiento. Comience con entradas pequeñas y utilice la vista previa de PDF para localizar las transiciones de páginas físicas.

## La descarga falla
Confirmar el éxito, los resultados retenidos y la autorización del proyecto. Las URL de descarga no eluden los controles de acceso.

## HTTP 401/403
Verifique el origen de API, `ApiKey`, la credencial actual y los alcances. Una clave del proyecto A no puede acceder a la plantilla del proyecto B. No envíe secretos al soporte.

## Conflicto de revisión del agente
Vuelva a leer el contexto actual y concilie los cambios. No sobrescriba ciegamente una revisión más reciente. Distinga el proyecto `/mcp` del público `/docs/mcp` y utilice los encabezados correctos.

## Informar de forma reproducible
Proporcione tiempo, acción, plantilla/versión, ID de renderizado/entrega y errores desinfectados. Prefiere datos de reproducción falsos y censura credenciales/información personal en capturas de pantalla.