ควรใช้ endpoint ใดสำหรับ PDF/A output ทั่วไป

ใช้ POST /api/v1/pdf/render พร้อมค่า settings.profile ที่เหมาะสมสำหรับ ordinary PDF/A output

เมื่อไรต้องใช้ E-Invoice Render

ใช้ E-Invoice Render เมื่อเอกสารต้องเป็นแพ็กเกจ Factur-X หรือ ZUGFeRD PDF/A-3b พร้อม CII XML ที่ฝังอยู่

gPdf validate archival acceptance หรือไม่

ไม่ gPdf เรนเดอร์ PDF/A output ระบบของคุณควร validate output ตาม archive หรือ customer acceptance policy

รวม PDF/A กับ security settings ได้หรือไม่

ไม่ได้ใน public Render API ปัจจุบัน settings.profile และ settings.security เป็น mutually exclusive และ combination ที่ invalid จะ fail validation

Compliance และการเก็บถาวร

PDF/A API สำหรับการสร้าง archival PDF

สร้าง PDF/A output จาก JSON Render requests สำหรับ archival workflows พร้อม boundary ที่ชัดเจนระหว่าง PDF/A profiles และ e-invoice packaging

PRIMARY API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMS compliance backend / archive service / บริการ export ของ ERP / บริการ document automation

ลองใน Playground อ่านเอกสาร

งานที่ต้องทำให้เสร็จ

สร้าง output แบบ PDF/A-profile จาก structured document requests เมื่อ business workflow ต้องการ PDF ที่เหมาะกับ archival โดยเลือก E-Invoice Render เฉพาะเมื่อจำเป็นต้อง package invoice XML ที่ฝังอยู่

ควรใช้ API นี้เมื่อใด

workflow ของคุณต้องเลือก PDF/A profile ใน render settings
คุณต้องการ output สำหรับ archival invoice, statement, report หรือ document
คุณต้องการหน้า PDF/A ทั่วไปที่กว้างกว่า PDF/A-3b e-invoice packaging
คุณสามารถ validate ไฟล์ที่สร้างด้วย archival acceptance workflow ของคุณเอง

สิ่งที่ไม่ได้ทดแทน

คุณต้องการ Factur-X หรือ ZUGFeRD พร้อม EN 16931 CII XML ที่ฝังอยู่ ให้ใช้ E-Invoice Render
คุณต้องการ workflow เฉพาะ validator ใช้หน้า validator สำหรับ validation context
คุณต้องการ encrypted output และ PDF/A ใน request เดียว public Render API ถือว่า security settings และ PDF/A profile settings เป็น mutually exclusive

ควรเรียก endpoint ใด

PRIMARY

/api/v1/pdf/render

JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.

SECONDARY 1

/api/v1/e-invoice/render

ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.

Minimal request

POST /api/v1/pdf/render - setting สำหรับ ordinary PDF/A output

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

gPdf จัดการอะไร

PDF/A profile settings บน JSON Render requests
การเรนเดอร์เอกสารพร้อม text, tables, images, barcodes, metadata และ profile output
PDF/A-3b e-invoice packaging เฉพาะผ่านเส้นทาง E-Invoice Render
binary PDF response พร้อมพฤติกรรม error ร่วมกัน

ระบบของคุณรับผิดชอบอะไร

archival policy, profile selection, validation workflow, retention และ legal acceptance
document semantics, business data และ external evidence ที่ต้องใช้
storage, access control และ future migration policy

Production checklist

เลือก PDF/A profile ที่ archive หรือลูกค้าของคุณต้องการ
นำ output ผ่าน validator และ retention acceptance workflow ของคุณ
แยก PDF/A และ security settings เป็นคนละ render flow เว้นแต่ public docs จะเพิ่ม compatible contract
ใช้ E-Invoice Render เมื่อจำเป็นต้องฝัง CII XML
จัดเก็บ source data หรือ PDF ที่ส่งกลับตาม retention policy

ขอบเขตของ claim

PDF/A output ไม่เหมือน legal e-invoice packaging
gPdf ไม่แทน archival acceptance หรือ validator workflow ของคุณ
ระบบของคุณเป็นเจ้าของ retention และ compliance interpretation

PDF/A คือการเลือก profile

สำหรับ ordinary archival documents, PDF/A ถูกเลือกผ่าน render settings วิธีนี้ทำให้ workflow อยู่ใกล้ JSON Render: ระบบของคุณอธิบายเอกสารและตั้ง profile ที่ต้องการ

e-invoice packaging แตกต่างออกไป เมื่อเอกสารต้องเป็น Factur-X หรือ ZUGFeRD พร้อม CII XML ที่ฝังอยู่ ให้ใช้ E-Invoice Render endpoint

FAQ

ควรใช้ endpoint ใดสำหรับ PDF/A output ทั่วไป: ใช้ POST /api/v1/pdf/render พร้อมค่า settings.profile ที่เหมาะสมสำหรับ ordinary PDF/A output
เมื่อไรต้องใช้ E-Invoice Render: ใช้ E-Invoice Render เมื่อเอกสารต้องเป็นแพ็กเกจ Factur-X หรือ ZUGFeRD PDF/A-3b พร้อม CII XML ที่ฝังอยู่
gPdf validate archival acceptance หรือไม่: ไม่ gPdf เรนเดอร์ PDF/A output ระบบของคุณควร validate output ตาม archive หรือ customer acceptance policy
รวม PDF/A กับ security settings ได้หรือไม่: ไม่ได้ใน public Render API ปัจจุบัน settings.profile และ settings.security เป็น mutually exclusive และ combination ที่ invalid จะ fail validation