Compliance और archival
Hybrid PDF/A-3b e-invoices के लिए Factur-X API
Public E-Invoice Render endpoint से embedded EN 16931 CII XML वाले Factur-X PDF/A-3b invoices generate करें.
PRIMARY API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render SYSTEMS ERP / billing backend / compliance workflow / finance automation service
काम जो पूरा करना है
ERP या billing system correct structured invoice data produce कर चुका हो, उसके बाद rendered invoice PDF को embedded EN 16931 CII XML के साथ Factur-X PDF/A-3b के रूप में package करें.
यह API कब इस्तेमाल करें
- आपको public E-Invoice Render endpoint से native Factur-X output चाहिए.
- आपके system के पास invoice के लिए valid EN 16931 CII XML पहले से है.
- Factur-X metadata और associated-file wiring के साथ PDF/A-3b packaging चाहिए.
- Currently published e-invoice contract confirm करने के लिए capabilities endpoint चाहिए.
यह क्या replace नहीं करता
- आप gPdf से invoice business semantics या tax decisions बनवाना चाहते हैं.
- आपको OpenAPI में listed नहीं native XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e या other standards चाहिए.
- आपको Chorus Pro या किसी government portal में direct submission चाहिए.
कौन सा endpoint call करें
/api/v1/e-invoice/render
E-Invoice Render इस workflow का default path है।
/api/v1/e-invoice/capabilities
जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें।
Minimal request
POST /api/v1/e-invoice/render - minimal Factur-X package shape.
{
"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 क्या handle करता है
- E-Invoice Render से Factur-X packaging.
- Hybrid invoice PDF के लिए PDF/A-3b profile handling.
- Standard metadata के साथ CII XML को associated file की तरह embed करना.
- Docs में described inline PDF delivery या object-delivery job behavior.
आपका system क्या संभालता है
- Correct EN 16931 CII XML, invoice numbers, tax logic, buyer और seller data, और eligibility.
- External validation, recipient rules, portal submission और legal interpretation.
- Storage, audit trail, retry logic और customer या portal तक delivery.
Production checklist
- CII XML को gPdf भेजने से पहले validate करें.
- settings.profile को pdfa-3b set करें या omit करें ताकि e-invoice default apply हो.
- settings.e_invoice.standard = factur_x और settings.e_invoice.profile = en16931 use करें.
- Returned PDF को अपने Factur-X validator workflow से चलाएं.
- Submission और recipient routing को render API से बाहर रखें.
Claim boundaries
- Native public e-invoice output Factur-X या ZUGFeRD with EN 16931 CII XML है.
- gPdf invoices को government या buyer portals में submit नहीं करता.
- Business, tax और XML correctness आपका system own करता है.
Factur-X e-invoice packaging workflow है
Factur-X human-readable PDF को machine-readable EN 16931 CII XML के साथ combine करता है. Public gPdf endpoint उस combination को PDF/A-3b output में package करता है. यह invoice semantics decide नहीं करता और file को portal में submit नहीं करता.
FAQ
- कौन सा endpoint Factur-X render करता है?
- settings.e_invoice.standard को factur_x set करके POST /api/v1/e-invoice/render use करें.
- क्या gPdf EN 16931 XML generate करता है?
- आपका system CII XML supply करता है और उसकी business correctness own करता है. gPdf उसे hybrid PDF में package करता है.
- क्या इस page पर gPdf XRechnung support करता है?
- नहीं. यह page OpenAPI में listed public Factur-X contract तक limited है.
- क्या gPdf Factur-X invoices portals में submit करता है?
- नहीं. Submission और recipient routing render API से बाहर रहते हैं.