प्रोडक्शन सिस्टम के लिए PDF/A-3b आउटपुट API
PDF/A-3b output को structured backend data से बिना browser render करें. gPdf PDF output संभालता है और business rules आपके system में रहते हैं.
/api/v1/pdf/render PDF/A-3b output को structured data से repeatable PDF के रूप में generate करना. gPdf document render करता है; data semantics और workflow state आपका system रखता है.
यह API कब इस्तेमाल करें
- Backend में PDF/A-3b output 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/pdf/render
JSON Render इस workflow का default path है.
/api/v1/e-invoice/render
जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें.
Minimal request
/api/v1/pdf/render - PDF/A-3b output
{
"settings": {
"profile": "pdfa-3b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive copy",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf क्या handle करता है
- Structured request से PDF/A-3b output का PDF rendering.
- Request के हिसाब से text, tables, lines, barcodes, pages, metadata और output options.
- Retry, reprint और audit के लिए deterministic output.
आपका system क्या own करता है
- PDF/A-3b output का सही 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 request से PDF render करता है; product workflow, database या business validation replace नहीं करता.
- Data semantics, retries, storage और final acceptance आपके system में रहते हैं.
API shape
PDF/A-3b आउटपुट 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/pdf/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
PDF/A-3b output को real data और downstream systems से validate करें. Support, audit और reprint के लिए request IDs, rendered output और validation evidence रखें.
FAQ
- क्या यह अलग endpoint है?
- PDF/A-3b आउटपुट API workflow को public gPdf API path से map करता है. Page बताता है कौन सा path call करना है और request क्या own करता है.
- क्या templates use कर सकते हैं?
- हाँ. Layout बदल रहा हो तो JSON Render use करें; layout approve हो जाए और callers सिर्फ business data भेजें तो Template Render use करें.
- Production से पहले क्या validate करें?
- Real data और workflow के printer, scanner, validator, accounting system या marketplace receiver से validate करें.