एकीकरण

S3 या Azure Blob से ZPL प्रिंट करना - और छपे लेबल वहीं आर्काइव करना

ऑब्जेक्ट स्टोरेज वह जगह है जहाँ प्रिंट फ़ाइलें पहले से रहती हैं: शिपिंग प्रदाता के कैरियर लेबल, ERP से पहले से रेंडर किए गए बैच, रिटेंशन नियमों के लिए रखे गए…

ऑब्जेक्ट स्टोरेज वह जगह है जहाँ प्रिंट फ़ाइलें पहले से रहती हैं: शिपिंग प्रदाता के कैरियर लेबल, ERP से पहले से रेंडर किए गए बैच, रिटेंशन नियमों के लिए रखे गए आर्काइव। यह गाइड दोनों दिशाएँ कवर करती है - बकेट से ZPL प्रिंट करना, और छपा ZPL वापस बकेट में लिखना।

सब कुछ Amazon S3 और Azure Blob Storage पर लागू होता है। चूँकि S3 इंटरफ़ेस मानकीकृत है, इसलिए MinIO, Cloudflare R2, Wasabi, Backblaze B2 और Ceph भी काम करते हैं।

स्टोरेज कनेक्शन बनाना

स्ट्रीमिंग → स्टोरेज → नया कनेक्शन में आप कनेक्शन एक बार बनाते हैं। नाम महत्वपूर्ण है: बाद में संदेश इसी नाम से कनेक्शन को संबोधित करते हैं।

फ़ील्ड	S3	Azure Blob
बकेट / कंटेनर	बकेट का नाम	कंटेनर का नाम
रीजन	जैसे `eu-central-1`	उपयोग नहीं होता
एंडपॉइंट	AWS के लिए खाली, अन्यथा जैसे `https://minio.example.com`	उपयोग नहीं होता
पाथ स्टाइल	MinIO और Ceph के लिए चालू करें	उपयोग नहीं होता
प्रीफ़िक्स	वैकल्पिक, जैसे `zpl/`	वैकल्पिक
क्रेडेंशियल्स	`AccessKey=…;SecretKey=…`	कनेक्शन स्ट्रिंग या कंटेनर SAS URL

क्रेडेंशियल्स प्लेटफ़ॉर्म डेटाबेस में AES-एन्क्रिप्टेड संग्रहीत होते हैं। वे कभी ब्राउज़र तक वापस नहीं जाते - फ़ॉर्म केवल यह दिखाता है कि क्रेडेंशियल्स मौजूद हैं। S3 के साथ आप उन्हें पूरी तरह छोड़ भी सकते हैं: तब सामान्य AWS क्रेडेंशियल चेन लागू होती है, उदाहरण के लिए वातावरण की IAM भूमिका।

टेस्ट करें कुछ भी प्रिंट होने से पहले सत्यापित करता है कि बकेट और अनुमतियाँ सही हैं।

दिशा 1: बकेट से ZPL प्रिंट करना

बस संदेश तैयार ZPL साथ ले जा सकता है। बड़ी फ़ाइलों के लिए यह असुविधाजनक है - कई ब्रोकर संदेश का आकार सीमित करते हैं, और एम्बेडेड ग्राफ़िक वाला लेबल जल्दी बड़ा हो जाता है। बेहतर यह है कि संदेश केवल उसकी ओर इशारा करे।

{
  "schemaVersion": 1,
  "printer": "rp:7",
  "zplRef": { "storage": "archive", "key": "orders/4711.zpl" }
}

storage आपके कनेक्शन का नाम है, key उसके अंदर की ऑब्जेक्ट कुंजी। कॉन्फ़िगर किया गया प्रीफ़िक्स आगे जोड़ा जाता है: प्रीफ़िक्स zpl/ के साथ ऊपर का उदाहरण zpl/orders/4711.zpl बन जाता है।

फ़ाइल प्रिंट के समय लाई जाती है, संदेश मिलने पर नहीं। नाम केवल आपके अपने या आपकी कंपनी के स्कोप में रिज़ॉल्व होता है - किसी और का कनेक्शन संदेश के ज़रिए नहीं पहुँचा जा सकता, भले ही कोई उसका नाम जानता हो।

दिशा 2: छपा ZPL संग्रहीत करना और उसकी सूचना देना

उल्टी दिशा को आउटपुट लक्ष्य कहा जाता है। यह तीन चरणों को एक साथ जोड़ता है जो सफल प्रिंट के बाद चलते हैं, और हर एक अलग से चालू होता है:

1. संग्रहीत करें - छपा ZPL एक फ़ाइल के रूप में स्टोरेज कनेक्शन में लिखा जाता है।

2. सूचित करें - एक संदेश किसी बस पर जाता है, सात में से कोई भी।

3. ट्रिगर करें - आपके अपने URL पर एक HTTP POST, HMAC-SHA256 से हस्ताक्षरित।

फ़ाइल का नाम एक टेम्पलेट से बनता है। सभी समय UTC में हैं:

टेम्पलेट: {yyyy}/{MM}/{dd}/{subscription}/{id}.zpl
परिणाम:   2026/09/09/Outbound/8f3c1e2a9b7d4c0e.zpl

उपलब्ध हैं {yyyy} {MM} {dd} {HH} {mm} {ss}, {subscription}, {printer}, {key} (बस संदेश की कुंजी) और हर लेबल के लिए एक अद्वितीय id हेतु {id}।

सूचना और वेबहुक को एक ही पेलोड मिलता है:

{
  "schemaVersion": 1,
  "event": "label.printed",
  "utc": "2026-09-09T12:34:56.7890000Z",
  "subscription": "Outbound",
  "printer": "rp:7",
  "storageKey": "zpl/2026/09/09/Outbound/8f3c1e2a.zpl",
  "storageUrl": "https://archive.s3.eu-central-1.amazonaws.com/zpl/2026/09/09/...",
  "zplBytes": 812,
  "zpl": null
}

ZPL स्वयं केवल तभी शामिल होता है जब आप स्पष्ट रूप से उसे माँगें। अन्यथा फ़ील्ड null होता है और URL काफ़ी है - जिससे संदेश छोटा रहता है।

यह किस काम आता है

रिटेंशन नियम। शिपिंग लेबल रिकॉर्ड हैं। आपके अपने बकेट में, आपके प्रदाता के लाइफ़साइकल नियमों के तहत रखा गया आर्काइव किसी दूसरे सिस्टम के बिना यह आवश्यकता पूरी करता है।
बिना दोबारा रेंडर किए रीप्रिंट। जो एक बार छपा, वह बाइट-दर-बाइट मौजूद है। रीप्रिंट वही फ़ाइल है, नया रेंडर नहीं।
डाउनस्ट्रीम सिस्टम को हैंडओवर। वेबहुक ERP को बताता है कि कार्टन 12 पर लेबल लग गया है, और साथ ही रिकॉर्ड का लिंक भी सौंप देता है।

स्टोरेज विफलता कभी प्रिंट नहीं रोकती

संग्रहीत करना, सूचित करना और वेबहुक सभी प्रिंट के बाद चलते हैं। यदि बकेट कुछ समय के लिए अप्राप्य हो, तब भी लेबल प्रिंट होता है; त्रुटि सदस्यता लॉग में टेक्स्ट के रूप में दर्ज होती है। आर्काइव की वजह से संचालन नहीं रुकना चाहिए।

किसी आउटपुट लक्ष्य को किसी भी समय टेस्ट करें से परखा जा सकता है: यह एक नमूना ZPL संग्रहीत करता है और बिना कुछ प्रिंट किए सूचना और वेबहुक चलाता है।