Docs
ES
EnglishEspañol
Crear cuenta

Inicio rápido con un asistente de IA

Pide a tu asistente de IA que genere la misma factura que en las guías de app y API. Necesitas la plantilla publicada Invoice quickstart de Crea tu plantilla dinámica reutilizable y un espacio de trabajo con créditos de generación.

Tu asistente ya debe estar conectado a ShipPDF. Sigue la guía de autenticación de MCP para configurar la conexión y los permisos. Este inicio rápido empieza cuando esa conexión está lista.

1. Identifica la plantilla y da los datos

Copia el ID de la plantilla publicada y reemplaza YOUR_PUBLISHED_TEMPLATE_ID en esta solicitud. Envíala a tu asistente:

Usa la plantilla de ShipPDF YOUR_PUBLISHED_TEMPLATE_ID, llamada Invoice quickstart. Revisa su esquema de datos publicado y usa el JSON de abajo para generar un documento. Pregúntame si falta información necesaria. Espera a que termine la generación y dame el enlace de descarga del PDF. Usa quickstart-invoice-INV-1043 como clave de idempotencia para esta solicitud.

{
  "invoice": {
    "number": "INV-1043",
    "customer_name": "Northstar"
  }
}

El ID real de la plantilla identifica el diseño; el JSON da los valores para este documento. Si usas otra plantilla, da datos que coincidan con su esquema.

2. Genera y obtén el PDF

El asistente usa la plantilla publicada, envía los datos a ShipPDF y consulta el documento hasta que termine o falle. Una nueva generación usa un crédito. La llamada de generación no devuelve el PDF completo de inmediato.

Si repites esta misma solicitud, conserva la clave de idempotencia. Para otra factura o datos distintos, pide un nuevo documento con una clave nueva.

Si la generación falla, pide al asistente que explique el error y qué debe cambiar antes de probar de nuevo. La guía de generación con MCP describe las herramientas, los estados y los reintentos en detalle.

3. Descarga y revisa el documento

Abre el enlace del PDF y descarga el archivo mientras esté vigente. Comprueba que muestre Invoice INV-1043 y Customer: Northstar.

Si el enlace vence, pide al asistente un enlace nuevo para el mismo documento en lugar de generarlo otra vez.

Generar un documento no cambia la plantilla. Para modificar el diseño, sigue Crear una plantilla con IA y publica la revisión antes de generar otro PDF.

Próximos pasos