এটি কি আলাদা endpoint?

SSCC লেবেল 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 করুন.

Barcodes and retail

প্রোডাকশন সিস্টেমের জন্য SSCC লেবেল API

SSCC labels 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 পড়ুন

যে কাজটি করতে হবে

SSCC labels structured data থেকে repeatable PDF হিসেবে generate করা. gPdf document render করে; data semantics এবং workflow state থাকে আপনার system-এ.

কখন এই API ব্যবহার করবেন

Backend-এ SSCC labels 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/pdf/render

JSON Render এই workflow-এর default path.

SECONDARY 1

/api/v1/template-render

Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন.

Minimal request

/api/v1/pdf/render - SSCC labels

{
  "pages": [
    {
      "size": "label_100_150",
      "elements": [
        {
          "type": "text",
          "x": 6,
          "y": 8,
          "content": "SSCC",
          "style": { "font_size": 12, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "sscc-18",
          "content": "000123456789012345",
          "x": 6,
          "y": 28,
          "width": 86,
          "height": 30,
          "barcode_text": { "enabled": true, "position": "bottom" }
        }
      ]
    }
  ]
}

gPdf কী handle করে

Structured request থেকে SSCC labels PDF rendering.
Request অনুযায়ী text, tables, lines, barcodes, pages, metadata এবং output options.
Retry, reprint এবং audit-এর জন্য deterministic output.

আপনার system কী own করে

SSCC labels-এর সঠিক 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 একাধিক system reuse করলে template করুন.

Claim boundaries

gPdf label PDF render করে; postage কেনা, shipment তৈরি বা carrier certification করে না.
Payload, printer, label stock, routing এবং scan testing আপনার system-এর responsibility.

API shape

SSCC লেবেল 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/pdf/render. Layout approve হয়ে systems-এ reuse হলে Template Render ব্যবহার করুন. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging দরকার হলেই E-Invoice Render ব্যবহার করুন.

Production-এর আগে validation

SSCC labels real data এবং downstream systems দিয়ে validate করুন. Support, audit এবং reprint-এর জন্য request IDs, rendered output এবং validation evidence রাখুন.

FAQ

এটি কি আলাদা endpoint?: SSCC লেবেল 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 করুন.