Apakah ini endpoint terpisah?

API struk PDF memetakan workflow ke API publik gPdf. Halaman ini menjelaskan path yang dipanggil dan data yang harus dimiliki request.

Bisa memakai templates?

Bisa. Gunakan JSON Render saat layout masih berubah; gunakan Template Render setelah layout disetujui dan callers hanya mengirim data bisnis.

Apa yang harus divalidasi sebelum produksi?

Validasi dengan data nyata dan printer, scanner, validator, sistem akuntansi, atau marketplace sesuai workflow.

Invoicing and finance

API struk PDF untuk sistem produksi

Buat struk PDF dari data backend terstruktur tanpa browser. gPdf menangani PDF rendering; aturan bisnis tetap berada di sistem Anda.

API UTAMA JSON Render

ENDPOINT /api/v1/pdf/render

SISTEM backend operasional / sistem finance / workflow compliance / layanan dokumen

Coba di Playground → Baca dokumentasi

Pekerjaan yang diselesaikan

Membuat struk PDF sebagai PDF yang dapat direproduksi dari data terstruktur. gPdf merender dokumen; sistem Anda tetap memegang makna data dan status proses.

Kapan memakai API ini

Backend sudah memiliki data struk PDF dan membutuhkan respons PDF yang stabil.
Anda ingin menghindari Chromium atau HTML-to-PDF untuk dokumen operasional.
Anda membutuhkan output berulang untuk reprint, audit, atau batch.

Apa yang tidak digantikan

gPdf tidak membeli ongkir, melaporkan pajak, membuat pesanan eksternal, atau menjadi sistem fiskal.
Tidak menggantikan validasi data, aturan bisnis, atau integrasi marketplace.

Endpoint yang dipanggil

UTAMA

/api/v1/pdf/render

JSON Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/template-render

Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.

Request minimal

/api/v1/pdf/render - struk PDF

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 12,
          "content": "Receipt R-2026-1001",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 10,
          "y": 28,
          "content": "Order total: $82.40\nPaid by card ending 4242\nTax: $6.10",
          "style": { "font_size": 10, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "qrcode",
          "content": "https://example.com/receipts/R-2026-1001",
          "x": 10,
          "y": 58,
          "width": 28,
          "height": 28
        }
      ]
    }
  ]
}

Yang ditangani gPdf

Rendering PDF struk PDF dari request terstruktur.
Teks, tabel, garis, barcode, halaman, metadata, dan opsi output sesuai request.
Output deterministik untuk retry, reprint, dan audit.

Yang dikelola sistem Anda

Data struk PDF yang benar, aturan bisnis, dan status operasional.
Autentikasi, penyimpanan, workflow eksternal, dan validasi dengan sistem penerima.

Checklist produksi

Uji dengan data nyata dan sistem yang akan menerima PDF.
Simpan request ID dan bukti validasi untuk support, audit, dan reprint.
Jadikan layout yang disetujui sebagai template ketika dipakai banyak sistem.

Batas klaim

gPdf merender PDF dari request; tidak menggantikan workflow produk, database, atau business validation.
Data semantics, retries, storage, dan final acceptance tetap milik sistem Anda.

Bentuk API

API struk PDF adalah workflow produksi di atas public APIs gPdf. Request menjelaskan data, layout, settings, dan bagian PDF yang perlu dirender. gPdf membuat PDF; sistem Anda menjaga semantik event bisnis.

Pilihan endpoint

Endpoint default untuk workflow ini adalah /api/v1/pdf/render. Gunakan Template Render setelah layout disetujui dan dipakai ulang. Gunakan E-Invoice Render hanya untuk paket Factur-X / ZUGFeRD PDF/A-3b dengan EN 16931 CII XML tertanam.

Validasi sebelum produksi

Validasi struk PDF dengan data nyata dan downstream systems. Simpan request ID, output, dan bukti validasi untuk support, audit, dan reprint.

FAQ

Apakah ini endpoint terpisah?: API struk PDF memetakan workflow ke API publik gPdf. Halaman ini menjelaskan path yang dipanggil dan data yang harus dimiliki request.
Bisa memakai templates?: Bisa. Gunakan JSON Render saat layout masih berubah; gunakan Template Render setelah layout disetujui dan callers hanya mengirim data bisnis.
Apa yang harus divalidasi sebelum produksi?: Validasi dengan data nyata dan printer, scanner, validator, sistem akuntansi, atau marketplace sesuai workflow.