Compliance and archival

প্রোডাকশন সিস্টেমের জন্য Factur-X ইনভয়েস API

Factur-X invoices structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.

PRIMARY API E-Invoice Render
ENDPOINT /api/v1/e-invoice/render
SYSTEMS operations backend / finance system / compliance workflow / document service
যে কাজটি করতে হবে

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 তৈরি বা fiscal system হিসেবে কাজ করে না.
  • Data validation, business rules বা marketplace integrations replace করে না.

কোন endpoint call করবেন

PRIMARY

/api/v1/e-invoice/render

E-Invoice Render এই workflow-এর default path.

SECONDARY 1

/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

  1. Real data এবং PDF consume করা systems দিয়ে test করুন.
  2. Support, audit এবং reprint-এর জন্য request IDs এবং validation evidence রাখুন.
  3. Approved layout একাধিক system reuse করলে template করুন.

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-এর meaning আপনার system রাখে.

Endpoint choice

এই workflow-এর default endpoint /api/v1/e-invoice/render. Layout approve হয়ে systems-এ reuse হলে Template Render ব্যবহার করুন. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging দরকার হলেই E-Invoice Render ব্যবহার করুন.

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 করুন.