API PDF للوجستيات: ملصقات وقوائم ومستندات مستودع
أنشئ ملفات PDF لوجستية منظمة مثل الملصقات، وقوائم التعبئة، وبوالص الشحن، والمانيفست، ومستندات المستودع من بيانات WMS و OMS و 3PL.
/api/v1/pdf/render عرض مستندات لوجستية تشغيلية من بيانات WMS و OMS و 3PL والتنفيذ المنظمة، مع إبقاء معاملات الناقل وتوجيه الشحنات وحالة المستودع وقواعد الأعمال داخل أنظمة المتصل.
متى تستخدم هذه API
- تحتاج إلى ملفات PDF للملصقات أو قوائم التعبئة أو المانيفست أو بوالص الشحن أو أوراق المستودع.
- تعرف أنظمة اللوجستيات لديك بالفعل بيانات الشحنة والطلب والمخزون والمسار والناقل.
- تحتاج إلى إعادة طباعة حتمية وعرض API عالي الحجم.
- تريد صفحة محور واسعة توجه المستخدمين إلى عمليات أضيق للملصقات والمستودعات.
ما الذي لا تستبدله
- تحتاج إلى أن يقيّم gPdf الشحنات أو يشتري الطوابع أو يتحدث مباشرةً إلى الناقلين.
- تحتاج إلى ميزات WMS أو OMS أو TMS أو إدارة المخزون.
- تحتاج إلى EDI أصلي أو تقديم جمركي أو عمليات وسيط شحن خارج إنشاء PDF.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/template-render - مستند لوجستي متكرر من بيانات منظمة.
{
"template_id": "packing_list",
"data": [
{
"order_number": "SO-8421",
"warehouse": "LAX-01",
"ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
"items": [
{ "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
{ "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
]
}
]
}
ما يتولاه gPdf
- عرض PDF للمستندات اللوجستية المنظمة.
- صفحات بحجم الملصق، ومستندات A4/letter، وباركود، وجداول، وكتل عناوين، وبيانات وصفية.
- Template Render لتخطيطات المستودع والتنفيذ المعتمدة.
- مخرجات حتمية لإعادة الطباعة وسجلات التدقيق.
ما يبقى ضمن مسؤولية نظامك
- حالة الشحنة وخدمة الناقل وقواعد التوجيه وحالة المخزون وأهلية المستند.
- ربط بيانات الأعمال من أنظمة WMS أو OMS أو TMS أو ERP أو 3PL.
- توجيه الطابعات والتخزين والتسليم ومنطق إعادة المحاولة ومعالجة الاستثناءات التشغيلية.
قائمة فحص الإنتاج
- قرر أي المستندات تستخدم JSON Render مباشرة وأيها قوالب.
- تحقق من حالات تجاوز الباركود والعناوين والجداول لكل نوع مستند.
- خزّن بيانات المصدر أو PDF وفق متطلبات إعادة الطباعة والتدقيق.
- أبق استدعاءات API الناقل واستدعاءات API العرض خطوتين منفصلتين في التكامل.
- اربط الصفحات الأضيق لملصقات الشحن وملصقات المستودعات بدل تكرار محتواها.
حدود الادعاءات
- ينشئ gPdf ملفات PDF لوجستية؛ وليس ناقلًا أو WMS أو OMS أو TMS أو مزود طوابع بريدية.
- تقييم الشحن وشراء الملصقات وحالة المخزون وعمليات الناقل تبقى خارج gPdf.
- يجب أن تربط هذه الصفحة الواسعة بصفحات حلول أضيق بحسب نية سير العمل الدقيقة.
المستندات اللوجستية مجموعة متداخلة
يشمل إنشاء PDF للوجستيات عدة أنواع من المستندات: ملصقات الشحن، وملصقات المستودعات، وقوائم التعبئة، والمانيفست، وبوالص الشحن، وتذاكر الالتقاط، ومستندات التسليم الداخلية. هذه الصفحة هي نقطة الدخول الواسعة. ويجب أن تملك الصفحات الأضيق نية البحث الدقيقة للملصقات وسير العمل الكثيف بالباركود.
نمط استخدام API
تستخدم معظم المستندات اللوجستية إما JSON Render أو Template Render. يناسب JSON Render التخطيطات المولدة أو المستندات الخاصة. ويناسب Template Render المستندات المتكررة حيث تتوقع فرق العمليات تخطيطًا مستقرًا ومجموعة صغيرة من حقول البيانات.
أبق الأنظمة التشغيلية مصدر الحقيقة
يبقى WMS أو OMS أو TMS أو منصة 3PL أو ERP أو تكامل الناقل لديك المصدر المعتمد لحالة الشحنة وقواعد الأعمال. يستقبل gPdf بيانات المستند النهائية وينتج مخرجات PDF.
الأسئلة الشائعة
- هل تختلف هذه الصفحة عن صفحة ملصقات الشحن؟
- نعم. هذه صفحة المستندات اللوجستية الواسعة. ولملصقات الشحن وملصقات المستودعات صفحات أضيق بإرشادات أكثر تحديدًا للملصقات والباركود.
- هل يستدعي gPdf الناقلين؟
- لا. تتولى منظومتك اللوجستية API الناقلين والطوابع وتقييم الشحن والتوجيه. يعرض gPdf ملفات PDF من البيانات التي يستقبلها.
- أي مسار API يناسب المستندات اللوجستية؟
- استخدم JSON Render للتخطيطات المخصصة وTemplate Render للمستندات المتكررة المعتمدة مثل قوائم التعبئة أو ملصقات المستودعات.
- هل يمكن أن تتضمن الصفحات اللوجستية باركود؟
- نعم. يعرض gPdf عناصر باركود داخل PDF، لكن نظامك يملك البيانات المشفرة والتحقق التشغيلي.