API ملصقات المستودع لسير الطباعة في WMS وERP
أنشئ ملصقات PDF للمنصات والكراتين والمواقع والمخزون وعمليات المستودع من بيانات WMS أو ERP مع إعادة طباعة حتمية.
/api/v1/pdf/render عرض ملصقات مستودع من بيانات WMS أو ERP للمنصات والكراتين والمواقع والأصول والمخزون وحركاته، مع إبقاء حالة المخزون وقواعد الالتقاط وعمليات المستودع داخل نظام المتصل.
متى تستخدم هذه API
- تحتاج إلى ملصقات PDF للمنصات أو الكراتين أو المواقع أو المخزون أو الأصول.
- يملك WMS أو ERP لديك بالفعل بيانات SKU والدفعة والموقع وSSCC والمخزون.
- تحتاج إلى إعادة طباعة حتمية عندما يتلف ملصق أو تعيد محطة محاولة مهمة.
- تريد إعادة استخدام تخطيطات الملصقات المعتمدة عبر Template Render.
ما الذي لا تستبدله
- تحتاج إلى أن يدير gPdf المخزون أو يخصص المواقع أو يشغّل سير المستودع.
- تحتاج إلى تطبيق ماسح أو وكيل محطة طباعة أو نظام توجيه ملصقات من gPdf.
- تحتاج إلى اعتماد GS1 بدل عرض الباركود.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - ملصق منصة يتضمن بيانات باركود SSCC.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
ما يتولاه gPdf
- ملصقات PDF لسير طباعة المستودع.
- باركود متجهي ونصوص ومربعات وأحجام صفحات ملصقات وربط القالب.
- مخرجات حتمية لإعادة الطباعة وسير التدقيق.
- JSON Render للتخطيطات المخصصة وTemplate Render لعقود الملصقات المعتمدة.
ما يبقى ضمن مسؤولية نظامك
- حالة المخزون وبيانات SKU وبيانات الدفعة أو الرقم التسلسلي وقيم SSCC ودلالات الموقع.
- توجيه الطابعات وإعداد المحطات والتحقق بالماسحات وقواعد عمليات المستودع.
- اختيار القالب وإعادة المحاولة وتخزين ملفات PDF المعروضة أو بيانات المصدر.
قائمة فحص الإنتاج
- تحقق من أبعاد الملصق مقابل الطابعة ومواد الملصقات الحقيقية.
- امسح كل تنسيق باركود يستخدمه سير المستودع.
- أبق حالة WMS/ERP مصدرًا معتمدًا وأرسل بيانات الملصق النهائية فقط إلى gPdf.
- استخدم Template Render للملصقات التي تطبعها أنظمة أو محطات متعددة.
- سجّل معرّفات المستند المصدر ومعرّفات الطلب لتتبع إعادة الطباعة.
حدود الادعاءات
- يعرض gPdf ملصقات المستودع بصيغة PDF؛ ولا يدير المخزون أو حالة المستودع.
- يملك المتصل دلالات بيانات الباركود وقبول الماسحات.
- يمكن أن يثبّت Template Render تخطيطات الملصقات، لكنه لا يستبدل قواعد WMS.
ملصقات المستودع سجلات تشغيلية
تعرّف ملصقات المستودع المنصات والكراتين والمواقع والأصول وحركات المخزون والمواقع. وهي مرتبطة بحالة تشغيلية داخل WMS أو ERP لديك. يجب أن يستقبل gPdf بيانات الملصق النهائية ويعرضها؛ ولا يجب أن يقرر معنى المخزون أو حالة سير المستودع.
يبقي Template Render محطات الطباعة بسيطة
بالنسبة إلى الملصقات المستخدمة عبر محطات متعددة، انشر التخطيط المعتمد كقالب. عندها تستطيع خدمات الطباعة إرسال template_id مع بيانات WMS بدل إعادة بناء الإحداثيات في كل متصل.
حتمية إعادة الطباعة
تعيد المستودعات طباعة الملصقات. لا يجب أن ينتج الملصق التالف أو انحشار الطابعة أو إعادة محاولة المحطة مستندًا مختلفًا قليلًا. أبق بيانات الملصق المصدرية مرتبطة بسجل المستودع واستخدم مدخلات عرض حتمية لإعادة الطباعة.
الأسئلة الشائعة
- هل يدير gPdf مخزون المستودع؟
- لا. يملك WMS أو ERP حالة المخزون والمواقع وSKUs والدفعات وقواعد العملية. يعرض gPdf ملف PDF للملصق من البيانات النهائية.
- هل يمكن لملصقات المستودع استخدام باركود GS1 أو SSCC؟
- نعم، يستطيع gPdf عرض تنسيقات باركود مدعومة داخل مخرجات PDF. يملك نظامك بيانات الباركود وقبول الماسحات.
- هل يجب أن تستخدم ملصقات المستودع المتكررة القوالب؟
- عادةً نعم. يمنح Template Render محطات الطباعة template_id وعقد بيانات مستقرين بعد اعتماد تخطيط الملصق.
- كيف يجب أن تعمل إعادة الطباعة؟
- خزّن بيانات الملصق المصدرية أو PDF المولد مع سجل المستودع، ثم اعرض أو استرجع الملصق نفسه باستخدام المعرّفات التشغيلية الأصلية.