Is dit een apart endpoint?

API voor Shopify-PDFs koppelt de workflow aan een publieke gPdf API. De pagina laat zien welk pad je aanroept en wat de request moet bevatten.

Wat moet ik valideren voor productie?

Valideer met echte data en met printers, scanners, validators, boekhoudsystemen of marketplaces uit de workflow.

Ecommerce platforms

API voor Shopify-PDFs in productiesystemen

Genereer Shopify-PDFs vanuit gestructureerde backenddata, zonder browser, met een duidelijke grens tussen gPdf-rendering en je eigen bedrijfsregels.

PRIMAIRE API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMEN operationele backend / financieel systeem / compliance-workflow / documentservice

Testen in Playground → Documentatie lezen

Taak om op te lossen

Shopify-PDFs als reproduceerbare PDF genereren vanuit gestructureerde data. Je systeem bewaakt de business rules; gPdf verzorgt de PDF-rendering.

Wanneer deze API past

Je backend heeft de data voor Shopify-PDFs al en heeft een stabiele PDF-respons nodig.
Je wilt Chromium of HTML-to-PDF vermijden voor operationele documenten.
Je hebt herhaalbare output nodig voor reprints, audit of batchverwerking.

Wat dit niet vervangt

Je verwacht dat gPdf porto koopt, belasting afwikkelt, externe orders maakt of als fiscaal systeem optreedt.
Je wilt datavalidatie, business logic of marketplace-integraties vervangen.

Welk endpoint aanroepen

PRIMAIR

/api/v1/pdf/render

JSON Render is het standaardpad voor deze workflow.

SECUNDAIR 1

/api/v1/template-render

Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.

Minimale request

/api/v1/pdf/render - Shopify-PDFs

{
  "template_id": "packing_list",
  "data": [
    {
      "order_number": "#1042",
      "customer_name": "Example Buyer",
      "ship_to": "1200 Market St, San Francisco, CA",
      "items": [
        { "sku": "TSHIRT-BLK-M", "name": "Black T-shirt", "quantity": 2 },
        { "sku": "MUG-WHT", "name": "White mug", "quantity": 1 }
      ]
    }
  ]
}

Wat gPdf afhandelt

PDF-rendering van Shopify-PDFs vanuit gestructureerde requests.
Tekst, tabellen, lijnen, barcodes, pagina’s, metadata en outputopties volgens de request.
Deterministische output voor retries, reprints en audit.

Wat je systeem beheert

Correcte data voor Shopify-PDFs, business rules en operationele status.
Authenticatie, opslag, externe workflows en validatie met ontvangende systemen.

Productiechecklist

Test met echte data en met de systemen die de PDF ontvangen.
Bewaar request IDs en bewijs voor support, audit en reprints.
Zet de goedgekeurde layout om naar een template zodra meerdere systemen hem gebruiken.

Grenzen van de claim

gPdf rendert operationele PDFs; het is geen officiële marketplace connector of OMS.
Je systeem beheert orders, fulfillment, marketplace-calls en klantregels.

API-vorm

API voor Shopify-PDFs is een productieworkflow bovenop de publieke gPdf APIs. De request beschrijft data, layout, settings en de PDF-onderdelen die moeten worden gerenderd. gPdf rendert de PDF; je systeem bewaakt de betekenis van het business event.

Endpointkeuze

Voor deze workflow is /api/v1/pdf/render het standaardendpoint. Gebruik Template Render wanneer de layout is goedgekeurd en tussen systemen wordt hergebruikt. Gebruik E-Invoice Render alleen wanneer Factur-X / ZUGFeRD PDF/A-3b-packaging met ingebedde EN 16931 CII XML nodig is.

Validatie voor productie

Valideer Shopify-PDFs met echte data en met de systemen die de output gebruiken. Bewaar request IDs, gerenderde output en bewijs voor support, audit en reprints.

FAQ

Is dit een apart endpoint?: API voor Shopify-PDFs koppelt de workflow aan een publieke gPdf API. De pagina laat zien welk pad je aanroept en wat de request moet bevatten.
Kan ik templates gebruiken?: Ja. Gebruik JSON Render zolang de layout verandert; gebruik Template Render wanneer de layout is goedgekeurd en callers alleen bedrijfsdata sturen.
Wat moet ik valideren voor productie?: Valideer met echte data en met printers, scanners, validators, boekhoudsystemen of marketplaces uit de workflow.