Endpoint mana yang sebaiknya dipakai untuk output PDF/A umum?

Gunakan POST /api/v1/pdf/render dengan nilai settings.profile yang sesuai untuk output PDF/A biasa.

Kapan saya membutuhkan E-Invoice Render?

Gunakan E-Invoice Render ketika dokumen harus menjadi paket PDF/A-3b Factur-X atau ZUGFeRD dengan CII XML tertanam.

Apakah gPdf memvalidasi acceptance arsip?

Tidak. gPdf merender output PDF/A. Sistem Anda sebaiknya memvalidasi output terhadap kebijakan acceptance arsip atau pelanggan.

Bisakah PDF/A digabungkan dengan pengaturan security?

Tidak dalam Render API publik saat ini. settings.profile dan settings.security saling eksklusif dan kombinasi yang tidak valid gagal saat validasi.

Kepatuhan dan arsip

PDF/A API untuk pembuatan PDF arsip

Generate output PDF/A dari request JSON Render untuk workflow arsip, dengan batas jelas antara profile PDF/A dan packaging e-invoice.

API UTAMA JSON Render

ENDPOINT /api/v1/pdf/render

SISTEM backend compliance / layanan arsip / layanan export ERP / layanan automasi dokumen

Coba di Playground Baca dokumentasi

Pekerjaan yang diselesaikan

Generate output ber-profile PDF/A dari request dokumen terstruktur ketika workflow bisnis membutuhkan PDF yang ramah arsip, sambil memilih E-Invoice Render hanya ketika packaging invoice dengan XML tertanam diperlukan.

Kapan memakai API ini

Workflow Anda membutuhkan profile PDF/A yang dipilih dalam pengaturan render.
Anda membutuhkan output invoice, statement, laporan, atau dokumen arsip.
Anda menginginkan halaman PDF/A umum yang lebih luas daripada packaging e-invoice PDF/A-3b.
Anda dapat memvalidasi file yang dihasilkan dengan workflow acceptance arsip Anda sendiri.

Apa yang tidak digantikan

Anda membutuhkan Factur-X atau ZUGFeRD dengan EN 16931 CII XML tertanam. Gunakan E-Invoice Render.
Anda membutuhkan workflow validator-only. Gunakan halaman validator untuk konteks validasi.
Anda membutuhkan output terenkripsi dan PDF/A dalam request yang sama. Render API publik memperlakukan pengaturan security dan profile PDF/A sebagai mutually exclusive.

Endpoint yang dipanggil

UTAMA

/api/v1/pdf/render

JSON Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/e-invoice/render

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

Request minimal

POST /api/v1/pdf/render - pengaturan output PDF/A biasa.

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

Yang ditangani gPdf

Pengaturan profile PDF/A pada request JSON Render.
Render dokumen dengan teks, tabel, gambar, barcode, metadata, dan output profile.
Packaging e-invoice PDF/A-3b hanya melalui jalur E-Invoice Render.
Respons PDF biner dengan perilaku error yang sama.

Yang dikelola sistem Anda

Kebijakan arsip, pemilihan profile, workflow validasi, retensi, dan acceptance legal.
Semantik dokumen, data bisnis, dan bukti eksternal yang diperlukan.
Storage, access control, dan kebijakan migrasi di masa depan.

Checklist produksi

Pilih profile PDF/A yang diwajibkan arsip atau pelanggan Anda.
Jalankan output melalui workflow validator dan acceptance retensi Anda.
Pisahkan PDF/A dan pengaturan security dalam flow render berbeda kecuali docs publik menambahkan kontrak yang kompatibel.
Gunakan E-Invoice Render ketika CII XML tertanam diperlukan.
Simpan source data atau PDF yang dikembalikan sesuai kebijakan retensi.

Batas klaim

Output PDF/A tidak sama dengan packaging e-invoice legal.
gPdf tidak menggantikan workflow validator atau acceptance arsip Anda.
Sistem Anda memiliki retensi dan interpretasi compliance.

PDF/A adalah pilihan profile

Untuk dokumen arsip biasa, PDF/A dipilih melalui pengaturan render. Ini menjaga workflow tetap dekat dengan JSON Render: sistem Anda menjelaskan dokumen dan menetapkan profile yang dibutuhkan.

Packaging e-invoice berbeda. Ketika dokumen membutuhkan Factur-X atau ZUGFeRD dengan CII XML tertanam, gunakan endpoint E-Invoice Render.

FAQ

Endpoint mana yang sebaiknya dipakai untuk output PDF/A umum?: Gunakan POST /api/v1/pdf/render dengan nilai settings.profile yang sesuai untuk output PDF/A biasa.
Kapan saya membutuhkan E-Invoice Render?: Gunakan E-Invoice Render ketika dokumen harus menjadi paket PDF/A-3b Factur-X atau ZUGFeRD dengan CII XML tertanam.
Apakah gPdf memvalidasi acceptance arsip?: Tidak. gPdf merender output PDF/A. Sistem Anda sebaiknya memvalidasi output terhadap kebijakan acceptance arsip atau pelanggan.
Bisakah PDF/A digabungkan dengan pengaturan security?: Tidak dalam Render API publik saat ini. settings.profile dan settings.security saling eksklusif dan kombinasi yang tidak valid gagal saat validasi.