هل ينشئ gPdf ملصقات الناقل نيابة عني؟

لا. ينشئ نظام الناقل أو الشحن لديك شحنة الناقل وبيانات الباركود. يعرض gPdf تلك البيانات داخل ملصق PDF.

هل يمكنني استخدام Template Render لملصقات الشحن؟

نعم. استخدم JSON Render أثناء التصميم أو الاختبار، ثم استخدم Template Render عندما يصبح التخطيط مستقرًا ويجب أن يرسل المتصلون البيانات فقط.

هل يخرج gPdf ملفات ZPL؟

لا. واجهات العرض العامة تخرج PDF. إذا كان مسار الطباعة يحتاج إلى ZPL، فحوّل أو وجّه PDF خارج gPdf.

ماذا يجب أن أتحقق منه قبل الإنتاج؟

اطبع على الطابعة ومواد الملصقات الحقيقية، وامسح الباركود بماسحات الإنتاج، وتأكد أن النصوص والبيانات الخاصة بالناقل تأتي من نظام الشحن لديك.

اللوجستيات والملصقات

API ملصقات الشحن لملصقات PDF بقياس 4x6

أنشئ ملصقات شحن PDF جاهزة للطباعة بقياس 4x6 من JSON الطلب، مع باركود متجهي وأحجام صفحات ملصقات وإعادة طباعة حتمية للمستودعات.

API الرئيسي JSON Render

مسار API /api/v1/pdf/render

الأنظمة WMS / OMS / خادم خلفي 3PL / خادم خلفي للشحن

جرّب في Playground اقرأ الوثائق

المهمة المطلوبة

عرض ملفات PDF بحجم الملصق من بيانات الطلب والمستلم والخدمة والتتبع، حتى يستطيع خادم المستودع أو التجارة الإلكترونية طباعة ملصق 4x6 نفسه بثبات أثناء التنفيذ وإعادة طباعته حتميًا عند الحاجة.

متى تستخدم هذه API

لدى نظامك بالفعل رقم التتبع والوجهة ونص الخدمة وبيانات الباركود.
تحتاج إلى مخرجات PDF لسير طابعات Zebra أو SATO أو Honeywell أو الطابعات الحرارية الأخرى.
تريد وحدات باركود متجهية بدل صور باركود نقطية ملصوقة داخل PDF.
تحتاج إلى أن تعرض البيانات نفسها الملصق نفسه لإعادة الطباعة وأدلة التدقيق.

ما الذي لا تستبدله

تحتاج إلى شراء الطوابع أو تقييم الشحنة أو إنشاء ملصق ناقل عبر حساب ناقل.
تحتاج إلى مسار بديل لـ ZPL. يعيد gPdf ملفات PDF، لا لغة أوامر طابعة.
تحتاج إلى اعتماد ناقل من gPdf. تبقى اختبارات قبول الماسحات والناقل ضمن مسؤوليتك.

أي مسار API يجب استدعاؤه

الرئيسي

/api/v1/pdf/render

JSON Render هو المسار الافتراضي لسير العمل هذا.

ثانوي 1

/api/v1/template-render

استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.

طلب مختصر

POST /api/v1/pdf/render - ملصق 4x6 بسيط يتضمن باركود تتبع.

{
  "pages": [
    {
      "size": "label_4_6_in",
      "elements": [
        {
          "type": "text",
          "x": 4,
          "y": 6,
          "content": "SHIP TO",
          "style": { "font_size": 8, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 4,
          "y": 13,
          "content": "Acme Warehouse\n1200 Logistics Pkwy\nMemphis TN 38116",
          "style": { "font_size": 11, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "1Z999AA10123456784",
          "x": 4,
          "y": 62,
          "width": 92,
          "height": 22,
          "barcode_text": { "enabled": true, "position": "bottom" }
        }
      ]
    }
  ]
}

ما يتولاه gPdf

صفحات PDF بحجم الملصق مثل سير 4x6 بوصة.
عرض باركود متجهي لمحتوى ملصقات الناقل والمستودع.
النص وكتل العناوين وعلامات الخدمة والخطوط والمربعات وربط القالب اختياريًا.
مخرجات PDF حتمية لإعادة الطباعة في المستودع.

ما يبقى ضمن مسؤولية نظامك

حساب الناقل وشراء الطوابع واختيار الخدمة وإنشاء رقم التتبع.
صحة بيانات الباركود والنص القابل للقراءة والعناوين وبيانات التوجيه.
إعداد الطابعات ومواد الملصقات واختبار المسح وفحوص قبول الناقل.

قائمة فحص الإنتاج

اطبع ملصقات اختبار على طراز الطابعة ومواد الملصقات الحقيقية.
تحقق من معدلات مسح الباركود عند DPI ومسافة الماسح المستهدفة.
خزّن بيانات الشحنة المصدرية أو PDF العائد وفق سياسة إعادة الطباعة لديك.
استخدم Template Render بعد اعتماد تخطيط الملصق وإعادة استخدامه عبر الأنظمة.
أبق منطق الناقل الخاص خارج طلب العرض.

حدود الادعاءات

يعرض gPdf ملف PDF للملصق؛ ولا يشتري الطوابع أو يتحدث مباشرةً إلى الناقلين.
gPdf ليس جهة اعتماد لملصقات الناقلين.
API هو مخرج PDF، وليس ZPL أو EPL أو أي تدفق أوامر لطابعة حرارية.

شكل API ملصقات الشحن

صفحات ملصقات الشحن ليست مسار API ناقل منفصلًا. تستدعي JSON Render بصفحة بحجم الملصق، وكتل نصية، وخطوط، وصور اختيارية، وعناصر باركود. للملصقات المتكررة، انشر التخطيط المعتمد كقالب واستدع Template Render ببيانات الشحنة.

هذا يبقي الملكية واضحة. يملك gPdf عرض PDF ورسم الباركود. ويملك نظامك معاملة الناقل وحالة الشحنة ودلالات البيانات.

JSON Render مقابل Template Render

استخدم JSON Render عندما يولد نظام التنفيذ التخطيط كاملًا أو عندما لا يزال فريق العمليات يضبط الإحداثيات. واستخدم Template Render عندما يعتمد المستودع تخطيط ملصق مستقرًا ويجب أن يرسل كل متصل حقول البيانات نفسها.

يعيد المساران مخرجات PDF. الفرق هو ما إذا كان المتصل يصف التخطيط في كل طلب أو يشير إلى template_id منشور.

اختبارات الطباعة مهمة

جودة الملصقات الحرارية مادية. تحقق من المخرجات على مواد الملصقات والطابعات والماسحات الحقيقية. صحة بيانات الباركود والمناطق الهادئة ودرجة تعتيم الطابعة وقواعد الناقل الخاصة كلها مسؤوليات إنتاجية خارج API العرض.

الأسئلة الشائعة

هل ينشئ gPdf ملصقات الناقل نيابة عني؟: لا. ينشئ نظام الناقل أو الشحن لديك شحنة الناقل وبيانات الباركود. يعرض gPdf تلك البيانات داخل ملصق PDF.
هل يمكنني استخدام Template Render لملصقات الشحن؟: نعم. استخدم JSON Render أثناء التصميم أو الاختبار، ثم استخدم Template Render عندما يصبح التخطيط مستقرًا ويجب أن يرسل المتصلون البيانات فقط.
هل يخرج gPdf ملفات ZPL؟: لا. واجهات العرض العامة تخرج PDF. إذا كان مسار الطباعة يحتاج إلى ZPL، فحوّل أو وجّه PDF خارج gPdf.
ماذا يجب أن أتحقق منه قبل الإنتاج؟: اطبع على الطابعة ومواد الملصقات الحقيقية، وامسح الباركود بماسحات الإنتاج، وتأكد أن النصوص والبيانات الخاصة بالناقل تأتي من نظام الشحن لديك.