Guía del producto y de la API

Plantillas de la tienda

Qué ofrecen los diseños listos para usar

La tienda ofrece diseños iniciales de PDFgine para propuestas, informes, presentaciones y documentos similares. Tras añadir una plantilla a tu espacio de trabajo, puedes editar su texto, datos, colores y diseño en el Generador.

Por ahora, solo PDFgine publica plantillas en la tienda. No hay un proceso de publicación para que los clientes vendan sus propias plantillas.

Tipos de acceso

  • Gratis: un usuario con el permiso necesario puede añadir la plantilla directamente al espacio de trabajo.
  • Incluido en el plan: no hay cargo adicional si tu suscripción activa incluye la plantilla.
  • De pago: la plantilla puede instalarse en el espacio de trabajo correspondiente después de verificar su pago único.

Obtener y usar una plantilla

  1. Busca un diseño por categoría o búsqueda y examina su portada y descripción.
  2. Añade una plantilla gratuita o incluida en tu plan, o completa el pago seguro de un diseño de pago.
  3. La instalación añade una copia editable del diseño a Plantillas en el espacio de trabajo seleccionado.
  4. Ábrela en el Generador, sustituye los datos de ejemplo por los tuyos y verifica PDF, Word y el visor antes de publicar.

El código de plantilla debe ser único en el espacio de trabajo. Una coincidencia nunca sobrescribe la plantilla existente; se te pide elegir otro código.

Publicar e instalar a través de la API

Todo lo que hace la pantalla de la tienda está disponible mediante endpoints: listar lo publicado, copiar una plantilla en tu cuenta, publicar una propia y fijar su precio.

cURL 
# Listar lo publicado
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# Copiar uno a tu propia cuenta
curl -X POST https://api.pdfgine.com/api/v1/marketplace/templates/consulting-proposal/install \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "proposal", "name": "Propuesta" }'

# Publicar uno propio
curl -X POST https://api.pdfgine.com/api/v1/templates/invoice/marketplace \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Factura con condiciones de pago",
        "summary": "Una plantilla de facturación con condiciones de pago y un bloque de totales.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# Fijar su precio - priceMinorUnits es obligatorio cuando isFree es false
curl -X PUT https://api.pdfgine.com/api/v1/marketplace/templates/invoice-with-payment-terms/offer \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "isFree": false,
        "priceMinorUnits": 4900,
        "currency": "USD",
        "includedPlanCodes": ["business", "enterprise"],
        "expectedVersion": 3
      }'

La instalación copia la plantilla en tu cuenta; los cambios posteriores del publicador no afectan a tu copia. Al publicar, debes confirmar que puedes redistribuir las fuentes y las imágenes de la plantilla; esa confirmación queda registrada.

Tus propios gráficos y plantillas

Crear tu propia plantilla o gráfico no requiere comprar en la tienda. Se vende el diseño listo para usar preparado por PDFgine.

Abrir tienda →

Los errores más habituales

  • La instalación copia el diseño a tu espacio de trabajo. Los cambios posteriores del publicador no afectan a esa copia y tus ediciones tampoco se sobrescriben.
  • El código debe estar libre en tu espacio de trabajo. Una coincidencia nunca sobrescribe tu plantilla; se rechaza la instalación y se pide otro código.
  • Actualmente solo PDFgine publica. Los endpoints de publicación y oferta responden 403 para espacios sin el rol de publicador, así que todavía no construyas un flujo de vendedores con ellos.
  • El cursor del listado incluye los filtros. Cambiar search, category o locale conservando before responde 400 de forma intencionada; de lo contrario, el mismo cursor apuntaría a otra lista.
  • Un diseño de pago solo se instala después de verificar el pago. Llamar a install antes de checkout provoca un rechazo, no una cola.