Integraciones de Make y Zapier

Antes de conectar

Necesitas una cuenta de cliente de PDFgine, una plantilla en ese espacio de trabajo, cuota de páginas disponible y una cuenta de Make o Zapier. Crea primero la plantilla y anota su Template Code.

La aplicación de Make está en revisión para el catálogo. La integración de Zapier es privada. Contacta con PDFgine para obtener acceso; ninguna de las dos está aún publicada en el catálogo general.

Solicitar acceso a la integración

Conecta tu espacio de trabajo

Crea una clave API exclusiva en tu cuenta de PDFgine con usage:read y documents:render. Utiliza la URL de la API alojada que aparece abajo. Añade templates:read solo si utilizas el selector opcional Brand Kit para las vistas previas.

https://api.pdfgine.com · usage:read · documents:render

El selector Locale del conector ofrece actualmente inglés y turco. El idioma del sitio no cambia los datos del documento ni los campos disponibles en el conector.

Configurar un escenario de Make

1. Acepta el acceso a la aplicación privada proporcionado por PDFgine. Añade un módulo de PDFgine al escenario y crea una conexión con la URL de tu API y una clave API exclusiva.
2. Elige Create a Document, configura Template Code y Format, y asigna los valores del módulo anterior al objeto JSON de Template Data. Utiliza Queue a Document para trabajo asíncrono o Create a Public Preview para un enlace destinado al receptor.
3. Ejecuta Run once con datos de ejemplo y revisa el resultado del módulo y el documento generado. Activa la programación solo cuando la asignación sea correcta. Make an API call admite rutas relativas de API autorizadas; los ámbitos de la conexión siguen aplicándose.

Configurar un Zap

1. Acepta la invitación a la integración privada de PDFgine en tu cuenta de Zapier. Elige el disparador, añade una acción de PDFgine y conecta con la URL de tu API y una clave API exclusiva.
2. Para Create Document, configura Template Code y Format y asigna los datos del disparador a Template Data como JSON válido. Queue Document y Create Public Preview son acciones independientes. Brand Kits es una fuente opcional para una lista desplegable, no un disparador.
3. Prueba la acción, publica el Zap y envía un nuevo evento al disparador. Confirma una ejecución correcta en Zap History y revisa el documento de ese evento; un Test Step del editor por sí solo no demuestra que el flujo activo se haya ejecutado.

Asigna valores reales y conserva un JSON válido

Template Data debe ser un objeto JSON que coincida con los campos de tu plantilla, no una ruta de archivo ni un marcador vacío. El ejemplo siguiente corresponde a una plantilla de propuesta. Asigna los nombres e importes del disparador, conserva los valores numéricos como números y verifica los totales calculados antes de enviar.

{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

Elige la salida adecuada

Create Document devuelve una downloadUrl protegida que requiere autenticación API. Para un enlace que el cliente pueda abrir en el navegador, utiliza Create Public Preview y elige una duración de acceso permitida. Queue Document devuelve una statusUrl de trabajo; una respuesta en cola no es un documento terminado.

Renderización en cola · Enlaces de vista previa

Prueba antes de activar

Utiliza primero datos ficticios de clientes. Comprueba el destinatario, la referencia, los conceptos, los totales y el formato de salida. Tras activar el flujo, envía un nuevo evento y verifica el historial de ejecución de la plataforma. Evita repetir ejecuciones de producción: las páginas generadas consumen tu cuota de PDFgine.

Límites y resolución de problemas

Ante un 401 o 403, revisa la conexión y los ámbitos API. Ante un 402, comprueba la cuota disponible. Ante un 429, respeta Retry-After y reduce la frecuencia de solicitudes. Corrige el JSON o los datos de plantilla no válidos antes de reintentar. La duración de la vista previa y los límites de generación dependen de tu plan.

Errores · Consultar tu cuota

Mantén privadas las claves de conexión

Introduce tu clave API solo en los ajustes de conexión de la plataforma. No la incluyas en Template Data, capturas ni registros de ejecución compartidos. Utiliza una clave distinta por conexión y revócala en PDFgine cuando ya no se necesite acceso.

¿Necesitas eventos de documentos? Consulta la guía de webhooks de la API. Webhooks