क्या यह अलग endpoint है?

इनवॉइस PDF 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 करें.

Invoicing and finance

प्रोडक्शन सिस्टम के लिए इनवॉइस PDF API

invoice PDF को structured backend data से बिना browser render करें. gPdf PDF output संभालता है और business rules आपके system में रहते हैं.

PRIMARY API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMS operations backend / finance system / compliance workflow / document service

Playground में आज़माएँ → Docs पढ़ें

काम जो पूरा करना है

invoice PDF को structured data से repeatable PDF के रूप में generate करना. gPdf document render करता है; data semantics और workflow state आपका system रखता है.

यह API कब इस्तेमाल करें

Backend में invoice PDF 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 करें

PRIMARY

/api/v1/pdf/render

JSON Render इस workflow का default path है.

SECONDARY 1

/api/v1/template-render

जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें.

SECONDARY 2

/api/v1/e-invoice/render

जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें.

Minimal request

/api/v1/pdf/render - invoice PDF

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Invoice INV-1007",
          "style": { "font_size": 18, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 20,
          "y": 42,
          "content": "Bill to: Example Customer\nAmount due: USD 245.00",
          "style": { "font_size": 11, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "line",
          "x1": 20,
          "y1": 62,
          "x2": 190,
          "y2": 62
        }
      ]
    }
  ]
}

gPdf क्या handle करता है

Structured request से invoice PDF का PDF rendering.
Request के हिसाब से text, tables, lines, barcodes, pages, metadata और output options.
Retry, reprint और audit के लिए deterministic output.

आपका system क्या own करता है

invoice PDF का सही 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 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

invoice PDF को real data और downstream systems से validate करें. Support, audit और reprint के लिए request IDs, rendered output और validation evidence रखें.

FAQ

क्या यह अलग endpoint है?: इनवॉइस PDF 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 करें.