API قوائم التعبئة PDF لعمليات التنفيذ
أنشئ قوائم تعبئة PDF من بيانات الطلب والشحنة والكرتون والبنود لعمليات التنفيذ في التجارة الإلكترونية و3PL وOMS والمستودعات.
/api/v1/template-render عرض قوائم التعبئة من بيانات الشحنة والمستلم والبنود والكراتين حتى تتمكن فرق التنفيذ من طباعة مستند متسق أو إرفاقه بكل طلب صادر.
متى تستخدم هذه API
- لدى OMS أو WMS لديك بالفعل بنود الطلب والكميات وبيانات المستلم ومعرّفات الشحنة.
- تحتاج إلى قائمة تعبئة PDF لمحطات طباعة المستودع أو كمرفق داخل طرد العميل.
- تريد تخطيطًا واحدًا معتمدًا يعاد استخدامه عبر المستودعات أو العلامات التجارية أو قنوات البيع.
- قد تحتاج إلى باركود أو QR code للبحث عن الطلب أو استقبال المرتجعات.
ما الذي لا تستبدله
- تحتاج إلى شراء الطوابع أو تقييم الشحنة أو إنشاء ملصق ناقل.
- تحتاج إلى إدارة مخزون المستودع بدل عرض المستندات.
- تحتاج إلى دلالات فاتورة قانونية أو فاتورة إلكترونية.
أي مسار API يجب استدعاؤه
/api/v1/template-render
Template Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/pdf/render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/template-render - قالب packing_list لشحنة واحدة.
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
ما يتولاه gPdf
- Template Render لتخطيطات قوائم التعبئة المنشورة.
- JSON Render لصفحات قوائم التعبئة المخصصة أثناء التصميم أو العمليات الفردية.
- الجداول وصفوف البنود وكتل العناوين والباركود الاختياري ومخرجات PDF.
- إعادة طباعة حتمية عند استخدام البيانات والقالب نفسيهما.
ما يبقى ضمن مسؤولية نظامك
- بيانات الطلب وكميات البنود وحالة الشحنة وتوجيه المستودع ورسائل العملاء.
- ربط حقول القالب وتوجيه محطة الطباعة وسياسة إعادة الطباعة.
- أي مستند ناقل أو جمرك أو فاتورة يجب أن يرافق الطرد.
قائمة فحص الإنتاج
- اختبر أطول تراكيب SKU واسم بند وعنوان.
- تحقق من حالات بند واحد، وكراتين متعددة، وطلبات مؤجلة، وشحنات جزئية.
- استخدم Template Render بعد اعتماد تخطيط قائمة التعبئة.
- سجّل template_id و X-Request-Id لكل طلب طباعة تنفيذ.
- افصل إنشاء ملصق الناقل عن عرض قائمة التعبئة.
حدود الادعاءات
- يعرض gPdf PDF قائمة التعبئة؛ ولا يدير المخزون أو حالة التنفيذ.
- قائمة التعبئة ليست تلقائيًا فاتورة ضريبية أو مستندًا جمركيًا.
- شراء ملصق الناقل وتقييم الشحنة يبقيان خارج gPdf.
قوائم التعبئة تناسب مسار القوالب
عادةً ما تملك قوائم التعبئة بنية مستقرة: الشاحن، والمستلم، ورقم الشحنة، وصفوف البنود، والملاحظات الاختيارية. لذلك يكون Template Render خيارًا قويًا بعد اعتماد التخطيط.
يظل JSON Render مهمًا أثناء التصميم. فهو يسمح لفريقك بضبط الأعمدة والمسافات ووضع الباركود وفواصل الصفحات قبل نشر عقد template_id المستقر.
الأسئلة الشائعة
- هل قائمة التعبئة مسار منفصل في gPdf؟
- لا. استخدم Template Render لقالب قائمة تعبئة معتمد أو JSON Render عندما يصف نظامك التخطيط مباشرة.
- هل يمكن أن تتضمن قوائم التعبئة باركود؟
- نعم. يستطيع gPdf عرض عناصر باركود داخل PDF. يملك نظامك بيانات الطلب أو الكرتون أو المرتجع المشفرة.
- هل ينشئ gPdf ملصقات الناقل؟
- لا. ملصقات الناقل سير عمل منفصل. يعرض gPdf ملفات PDF من البيانات التي يوفرها نظام الناقل أو الشحن لديك.
- هل يمكن لطلب واحد عرض عدة قوائم تعبئة؟
- يقبل Template Render مصفوفة data لعناصر متعددة في طلب واحد، ضمن حدود API العامة الموثقة لذلك المسار.