Compliance และการเก็บถาวร
Factur-X API สำหรับ e-invoice แบบ hybrid PDF/A-3b
สร้าง invoice แบบ Factur-X PDF/A-3b พร้อม EN 16931 CII XML ที่ฝังอยู่ ผ่าน public E-Invoice Render endpoint
PRIMARY API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render SYSTEMS ERP / billing backend / compliance workflow / บริการ finance automation
งานที่ต้องทำให้เสร็จ
package invoice PDF ที่เรนเดอร์แล้วให้เป็น Factur-X PDF/A-3b พร้อม EN 16931 CII XML ที่ฝังอยู่ หลังจาก ERP หรือ billing system ของคุณสร้างข้อมูล invoice แบบ structured ที่ถูกต้องแล้ว
ควรใช้ API นี้เมื่อใด
- คุณต้องการ native Factur-X output จาก public E-Invoice Render endpoint
- ระบบของคุณมี EN 16931 CII XML ที่ถูกต้องสำหรับ invoice อยู่แล้ว
- คุณต้องการ PDF/A-3b packaging พร้อม Factur-X metadata และ associated-file wiring
- คุณต้องการให้ capabilities endpoint ยืนยัน e-invoice contract ที่เผยแพร่ในปัจจุบัน
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการให้ gPdf สร้างความหมายทางธุรกิจของ invoice หรือ tax decisions ให้คุณ
- คุณต้องการ native XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e หรือ standards อื่นที่ OpenAPI ไม่ได้ระบุ
- คุณต้องการ submit โดยตรงไปยัง Chorus Pro หรือ government portal อื่น
ควรเรียก endpoint ใด
/api/v1/e-invoice/render
E-Invoice Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/e-invoice/capabilities
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/e-invoice/render - รูปแบบแพ็กเกจ Factur-X ขั้นต่ำ
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf จัดการอะไร
- Factur-X packaging ผ่าน E-Invoice Render
- การจัดการ PDF/A-3b profile สำหรับ hybrid invoice PDF
- การฝัง CII XML เป็น associated file พร้อม standard metadata
- การส่ง PDF แบบ inline หรือ behavior ของ object-delivery job ตาม documentation
ระบบของคุณรับผิดชอบอะไร
- EN 16931 CII XML ที่ถูกต้อง, invoice numbers, tax logic, buyer and seller data และ eligibility
- external validation, recipient rules, portal submission และ legal interpretation
- storage, audit trail, retry logic และ delivery ถึงลูกค้าหรือ portal
Production checklist
- validate CII XML ก่อนส่งให้ gPdf
- ตั้ง settings.profile เป็น pdfa-3b หรือ omit เพื่อใช้ค่า default ของ e-invoice
- ใช้ settings.e_invoice.standard = factur_x และ settings.e_invoice.profile = en16931
- นำ PDF ที่ได้ผ่าน Factur-X validator workflow ของคุณ
- เก็บ submission และ recipient routing ไว้นอก render API
ขอบเขตของ claim
- native public e-invoice output คือ Factur-X หรือ ZUGFeRD พร้อม EN 16931 CII XML
- gPdf ไม่ submit invoices ไปยัง government หรือ buyer portals
- ระบบของคุณเป็นเจ้าของ business, tax และ XML correctness
Factur-X คือ workflow สำหรับ package e-invoice
Factur-X รวม PDF ที่มนุษย์อ่านได้เข้ากับ EN 16931 CII XML ที่เครื่องอ่านได้ public endpoint ของ gPdf package ส่วนผสมนี้ให้เป็น output PDF/A-3b โดยไม่ตัดสินความหมายของ invoice และไม่ submit ไฟล์ไปยัง portal
FAQ
- endpoint ใดใช้เรนเดอร์ Factur-X
- ใช้ POST /api/v1/e-invoice/render โดยตั้ง settings.e_invoice.standard เป็น factur_x
- gPdf สร้าง EN 16931 XML หรือไม่
- ระบบของคุณเป็นผู้ส่ง CII XML และเป็นเจ้าของความถูกต้องทางธุรกิจของ XML นั้น gPdf package ลงใน hybrid PDF
- หน้านี้รองรับ XRechnung หรือไม่
- ไม่ หน้านี้จำกัดอยู่ที่ public Factur-X contract ที่ระบุใน OpenAPI
- gPdf submit Factur-X invoices ไปยัง portal หรือไม่
- ไม่ submission และ recipient routing อยู่นอก render API