Czy to osobny endpoint?

API: PDF/A-3b 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.

Compliance and archival

PDF/A-3b: API dla produkcji

Generowanie PDF/A-3b 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

Przetestuj w Playground → Czytaj dokumentację

Zadanie do wykonania

Generowanie PDF/A-3b 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/A-3b 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/e-invoice/render

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

Minimalny request

/api/v1/pdf/render - PDF/A-3b

{
  "settings": {
    "profile": "pdfa-3b"
  },
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Archive copy",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

Co obsługuje gPdf

Rendering PDF dla PDF/A-3b 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/A-3b, reguły biznesowe i stan operacji.
Autentykacja, przechowywanie, zewnętrzne workflow i walidacja u odbiorcy.

Checklist produkcyjny

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

Granice deklaracji

gPdf renderuje PDF z requestu; nie zastępuje workflow produktu, bazy danych ani walidacji biznesowej.
Twój system odpowiada za semantykę danych, retries, przechowywanie i końcową akceptację.

Kształt API

API: PDF/A-3b 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/A-3b 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/A-3b 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.