Ecommerce platforms

PDF dla Shopify: API dla produkcji

Generowanie PDF dla Shopify ze strukturalnych danych backendu, bez przeglądarki, z jasną granicą między gPdf renderingiem a regułami Twojego systemu.

GŁÓWNE API JSON Render
ENDPOINT /api/v1/pdf/render
SYSTEMY backend operacyjny / system finansowy / workflow compliance / serwis dokumentów
Zadanie do wykonania

Generowanie PDF dla Shopify jako powtarzalnego PDF ze strukturalnych danych. gPdf tworzy dokument; Twój system odpowiada za znaczenie danych i stan procesu.

Kiedy użyć tej API

  • Backend ma już dane dla PDF dla Shopify i potrzebuje stabilnej odpowiedzi PDF.
  • Chcesz uniknąć Chromium lub HTML-to-PDF w dokumencie operacyjnym.
  • Potrzebujesz powtarzalnego wyniku do reprintów, audytu lub batchy.

Czego nie zastępuje

  • gPdf nie kupuje wysyłki, nie rozlicza podatków, nie tworzy zewnętrznych zamówień i nie jest systemem fiskalnym.
  • gPdf nie zastępuje reguł biznesowych, walidacji danych ani integracji marketplace.

Który endpoint wywołać

GŁÓWNY

/api/v1/pdf/render

JSON Render to domyślna ścieżka dla tego workflow.

DODATKOWY 1

/api/v1/template-render

Użyj, gdy workflow potrzebuje powiązanej API, kontraktu szablonu albo sprawdzenia capabilities.

Minimalny request

/api/v1/pdf/render - PDF dla Shopify

{
  "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 }
      ]
    }
  ]
}

Co obsługuje gPdf

  • Rendering PDF dla PDF dla Shopify ze strukturalnego requestu.
  • Tekst, tabele, linie, kody kreskowe, strony, metadane i opcje wyjścia zgodnie z requestem.
  • Deterministyczny output dla retry, reprintów i audytu.

Co kontroluje Twój system

  • Poprawne dane dla PDF dla Shopify, reguły biznesowe i stan operacji.
  • Autentykacja, przechowywanie, zewnętrzne workflow i walidacja u odbiorcy.

Checklist produkcyjny

  1. Testuj na prawdziwych danych i w systemach, które odbiorą PDF.
  2. Zachowuj request ID i dowody walidacji dla supportu, audytu i reprintów.
  3. Zamień zaakceptowany layout w template, gdy ma być współdzielony.

Granice deklaracji

  • gPdf renderuje operacyjne PDF; nie jest oficjalnym marketplace connector ani OMS.
  • Twój system odpowiada za zamówienia, fulfillment, wywołania marketplace API i reguły klienta.

Kształt API

API: PDF dla Shopify to production workflow oparty na publicznych API gPdf. Request opisuje dane, layout, settings i części PDF do renderingu. gPdf tworzy PDF, a Twój system zachowuje semantykę zdarzenia biznesowego.

Wybór endpointu

Domyślny endpoint dla tego workflow to /api/v1/pdf/render. Template Render stosuj po zatwierdzeniu layoutu. E-Invoice Render tylko dla Factur-X / ZUGFeRD PDF/A-3b z osadzonym EN 16931 CII XML.

Walidacja przed produkcją

Waliduj PDF dla Shopify na realnych danych i downstream-systemach. Zachowuj request ID, output i dowody walidacji dla supportu, audytu oraz reprintów.

FAQ

Czy to osobny endpoint?
API: PDF dla Shopify mapuje workflow na publiczną API gPdf. Strona pokazuje, który path wywołać i co ma zawierać request.
Czy można używać templates?
Tak. JSON Render pasuje, gdy layout jeszcze się zmienia; Template Render po zatwierdzeniu layoutu i przy wysyłaniu samych danych biznesowych.
Co zweryfikować przed produkcją?
Sprawdź realne dane oraz downstream: drukarki, skanery, walidatory, księgowość albo marketplace.