API باركود GS1 لملصقات PDF متجهية
اعرض باركودات GS1 متجهية داخل ملفات PDF، بما في ذلك GS1-128 و GS1 DataMatrix و GS1 QR و ITF-14 وعمليات ملصقات SSCC-18.
/api/v1/pdf/render عرض بيانات باركود GS1 داخل ملصقات أو مستندات PDF متجهية، مع بقاء معرّفات التطبيق الصحيحة وأرقام التحقق وقبول الماسحات ضمن مسؤولية نظام المنتج أو المستودع أو التجزئة لديك.
متى تستخدم هذه API
- تحتاج إلى رسم وحدات الباركود كمحتوى PDF متجهي بدل لصق صور نقطية.
- لدى نظامك بالفعل بيانات GS1 الصحيحة والتفسير القابل للقراءة البشرية.
- تحتاج إلى عمليات GS1-128 أو GS1 DataMatrix أو GS1 QR أو ITF-14 أو SSCC-18 داخل ملصقات أو مستندات.
- تريد نقل تخطيطات ملصقات الباركود المتكررة إلى Template Render.
ما الذي لا تستبدله
- تحتاج إلى اعتماد GS1 أو تحقق من دلالات بيانات المنتج من gPdf.
- تحتاج إلى أن يخصص gPdf بادئات شركة GS1 أو GTINs أو SSCCs أو أرقام تحقق.
- تحتاج إلى إدارة المخزون أو بيانات المنتج الرئيسية.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - عنصر باركود PDF بنمط GS1-128.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- عرض الباركود المتجهي داخل مخرجات PDF.
- وضع الباركود مع النص والخطوط وبيانات المنتج وبنى الملصقات.
- Template Render للملصقات المتكررة للمنتجات والمنصات والكراتين والمستودعات.
- مخرجات PDF مناسبة لاختبارات المسح والطباعة.
ما يبقى ضمن مسؤولية نظامك
- معرّفات تطبيق GS1 وبادئات الشركة وGTINs وSSCCs وأرقام التحقق.
- صحة بيانات الباركود وبيانات المنتج والنص التنظيمي واختبارات قبول الماسحات.
- عملية الطباعة ومواد الملصقات والمناطق الهادئة وQA التشغيلي.
قائمة فحص الإنتاج
- أنشئ بيانات GS1 في المنبع واجعلها قابلة للاختبار.
- اطبع وامسح باستخدام طابعات وماسحات الإنتاج.
- تحقق من المناطق الهادئة وحجم الوحدة والنص القابل للقراءة البشرية ومواد الملصقات.
- استخدم Template Render بعد اعتماد تخطيط الملصق.
- وثّق أن gPdf يعرض الباركود ولا يعتمد امتثال GS1.
حدود الادعاءات
- يعرض gPdf باركودات PDF متجهية؛ وليس جهة اعتماد GS1.
- يملك المتصل دلالات بيانات GS1 وأرقام التحقق.
- يجب التحقق من قبول الماسحات داخل بيئة الإنتاج الخاصة بالمتصل.
عرض باركود GS1 هو مهمة عرض PDF
يتولى gPdf رسم الباركود داخل PDF. لكنه لا يقرر ما إذا كان GTIN أو SSCC أو تسلسل معرّفات التطبيق صالحًا لأعمالك. أبق هذا المنطق في ERP أو WMS أو نظام معلومات المنتج أو أدوات GS1 لديك.
استخدم JSON Render أو Template Render
استخدم JSON Render عندما يضع الكود تخطيط الملصق أو المستند مباشرة. واستخدم Template Render عندما يكون الباركود حقلًا ضمن تخطيط ملصق متكرر. في الحالتين، يرسل المتصل البيانات التي يجب تشفيرها.
تحقق باستخدام ماسحات حقيقية
نجاح الباركود يقاس بقبول الماسح، لا بمظهر الصورة على الشاشة. تحقق من المخرجات المطبوعة بالطابعات والماسحات ومواد الملصقات نفسها المستخدمة في الإنتاج.
الأسئلة الشائعة
- هل يعتمد gPdf ملصقات GS1؟
- لا. يعرض gPdf رسومات باركود متجهية داخل PDF. يملك فريقك صحة بيانات GS1 واختبارات المسح وأي سير اعتماد.
- هل يمكن استخدام باركود GS1 مع Template Render؟
- نعم. يمكن أن يحتوي القالب المنشور على حقول باركود، ويرسل المتصلون البيانات المتغيرة فقط لتخطيطات الملصقات المتكررة.
- من ينشئ SSCC أو GTIN؟
- ينشئ نظام المنتج أو المستودع أو ERP المعرّفات ويتحقق منها. يستقبل gPdf البيانات ويعرضها.
- لماذا نستخدم باركودًا متجهيًا؟
- تتجنب الوحدات المتجهية آثار تحجيم الصور النقطية وتحافظ على حدة PDF الملصق عبر DPI ومستويات التكبير المختلفة.