प्रोडक्शन सिस्टम के लिए Factur-X इनवॉइस API
Factur-X invoices को structured backend data से बिना browser render करें. gPdf PDF output संभालता है और business rules आपके system में रहते हैं.
/api/v1/e-invoice/render Factur-X invoices को structured data से repeatable PDF के रूप में generate करना. gPdf document render करता है; data semantics और workflow state आपका system रखता है.
यह API कब इस्तेमाल करें
- Backend में Factur-X invoices data पहले से है और stable PDF response चाहिए.
- Operational document के लिए Chromium या HTML-to-PDF avoid करना है.
- Reprint, audit या batch के लिए repeatable output चाहिए.
यह क्या replace नहीं करता
- gPdf postage खरीदना, tax filing, external order creation या fiscal system का काम नहीं करता.
- Data validation, business rules या marketplace integrations को replace नहीं करता.
कौन सा 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
/api/v1/e-invoice/render - Factur-X invoices
{
"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 करता है
- Structured request से Factur-X invoices का PDF rendering.
- Request के हिसाब से text, tables, lines, barcodes, pages, metadata और output options.
- Retry, reprint और audit के लिए deterministic output.
आपका system क्या own करता है
- Factur-X invoices का सही data, business rules और operation state.
- Authentication, storage, external workflows और receiver validation.
Production checklist
- Real data और PDF consume करने वाले systems के साथ test करें.
- Support, audit और reprint के लिए request IDs और validation evidence रखें.
- Approved layout को template बनाएं जब कई systems उसे reuse करें.
Claim boundaries
- gPdf Factur-X / ZUGFeRD PDF/A-3b के लिए public e-invoice endpoint use करता है.
- Tax portals, PDP, SDI, KSeF, ZATCA, IRP, Peppol और legal obligations scope से बाहर हैं.
- Buyer data, tax logic, routing और local legal interpretation आपके system में रहते हैं.
API shape
Factur-X इनवॉइस API public gPdf APIs पर बना production workflow है. Request data, layout, settings और render होने वाले PDF parts स्पष्ट करता है. gPdf PDF बनाता है; business event का मतलब आपका system रखता है.
Endpoint choice
इस workflow का default endpoint /api/v1/e-invoice/render है. Layout approve होकर systems में reuse हो तो Template Render use करें. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging के लिए ही E-Invoice Render use करें.
Production से पहले validation
Factur-X invoices को real data और downstream systems से validate करें. Support, audit और reprint के लिए request IDs, rendered output और validation evidence रखें.
FAQ
- क्या यह अलग endpoint है?
- Factur-X इनवॉइस API Factur-X / ZUGFeRD PDF/A-3b के लिए public e-invoice endpoint use करता है. यह अलग product surface नहीं है.
- क्या यह local clearance networks cover करता है?
- नहीं. gPdf PDF/e-invoice file render और package करता है; tax portals और legal routing आपके system में रहते हैं.
- क्या JSON Render continue कर सकते हैं?
- Ordinary PDFs के लिए हाँ. Structured e-invoice package चाहिए तो E-Invoice Render use करें.