اللوجستيات والملصقات
API ملصقات الإرجاع للوجستيات العكسية في التجارة الإلكترونية
أنشئ ملصقات إرجاع وتعليمات إرجاع PDF من بيانات التجارة الإلكترونية أو الدعم، مع صفحات بحجم الملصق وباركود وإعادة طباعة عبر القوالب.
API الرئيسي JSON Render
مسار API
/api/v1/pdf/render الأنظمة خادم خلفي للتجارة الإلكترونية / بوابة مرتجعات / OMS / خادم خلفي 3PL
المهمة المطلوبة
عرض ملصقات إرجاع PDF أو صفحات تعليمات الإرجاع من بيانات RMA والعميل والبند والوجهة والباركود، حتى توفر بوابة المرتجعات مستندًا حتميًا للعميل.
متى تستخدم هذه API
- أنشأ نظامك بالفعل RMA وتفويض الإرجاع.
- زوّد نظام الناقل أو المرتجعات بالفعل بيانات الملصق أو التتبع.
- تحتاج إلى ملصق PDF أو صفحة تعليمات يمكن تنزيلها أو إرسالها بالبريد أو إعادة طباعتها.
- تريد إعادة استخدام تخطيط ملصق الإرجاع نفسه عبر Template Render.
ما الذي لا تستبدله
- تحتاج إلى أن يوافق gPdf على الإرجاع أو يشتري الطوابع أو ينشئ شحنة ناقل.
- تحتاج إلى تنسيق مباشر مع API الناقل.
- تحتاج إلى مخرجات أوامر طابعة مثل ZPL.
أي مسار API يجب استدعاؤه
/api/v1/pdf/render
JSON Render هو المسار الافتراضي لسير العمل هذا.
/api/v1/template-render
استخدمه عندما يحتاج سير العمل إلى مسار API مرتبط، أو عقد قالب، أو استعلام capabilities.
طلب مختصر
POST /api/v1/pdf/render - ملصق إرجاع يتضمن باركود RMA.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 8,
"content": "RETURN TO",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 5,
"y": 18,
"content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "RMA-2026-77881",
"x": 5,
"y": 70,
"width": 88,
"height": 20,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
ما يتولاه gPdf
- عرض PDF لملصقات الإرجاع بحجم الملصق وصفحات التعليمات.
- كتل الباركود والنص والعنوان وRMA والخدمة.
- ربط القالب لتخطيطات ملصقات الإرجاع أو التعليمات المعتمدة.
- مخرجات حتمية لتنزيلات العميل المتكررة وإعادة طباعة الدعم.
ما يبقى ضمن مسؤولية نظامك
- أهلية الإرجاع وحالة RMA وحساب الناقل والطوابع ورقم التتبع ورسائل العملاء.
- صحة بيانات الباركود وعنوان الوجهة ومراجع البنود وقواعد نافذة الإرجاع.
- تسليم البريد الإلكتروني وتنزيل البوابة وسجل تدقيق الدعم.
قائمة فحص الإنتاج
- تحقق من بيانات الإرجاع مع الناقل أو مزود المرتجعات قبل العرض.
- اطبع وامسح الملصقات على المواد نفسها التي سيستخدمها العملاء أو المتاجر.
- أدرج X-Request-Id وخزّن أثر RMA إلى PDF في سجلات الدعم.
- اجعل التنزيلات المتكررة حتمية من منظور العميل.
- افصل عرض الملصق عن منطق اعتماد رد الأموال.
حدود الادعاءات
- يعرض gPdf ملصقات إرجاع PDF؛ ولا يصرّح المرتجعات أو يشتري الطوابع.
- قبول الناقل وصحة بيانات الباركود تبقى مسؤوليتك.
- يعيد API العام PDF، لا ZPL ولا أوامر طابعة مباشرة.
اللوجستيات العكسية تحتاج إلى ملكية واضحة
تجمع ملصقات الإرجاع بين تجربة العميل وقواعد الناقل. يملك gPdf عرض PDF. أما نظام المرتجعات لديك فيملك الأهلية، وحالة RMA، والتتبع، وبيانات الناقل، والتواصل مع العميل.
أبق هذا الحد واضحًا في التكامل. أنشئ قرار الإرجاع أولًا، ثم اعرض المستند من البيانات النهائية.
الأسئلة الشائعة
- هل ينشئ gPdf شحنة الإرجاع؟
- لا. ينشئ الناقل أو منصة المرتجعات لديك الشحنة والبيانات. يعرض gPdf هذه البيانات داخل PDF.
- هل يمكن إنشاء ملصقات الإرجاع من قوالب؟
- نعم. استخدم Template Render بعد اعتماد تخطيط ملصق الإرجاع أو التعليمات.
- هل يمكن أن يتضمن PDF تعليمات الإرجاع؟
- نعم. يستطيع طلب العرض نفسه إنشاء صفحة ملصق أو صفحة تعليمات أو الاثنتين بحسب التخطيط لديك.
- هل يستبدل gPdf اعتماد الناقل؟
- لا. قبول الناقل واختبارات الماسحات وقواعد البيانات تبقى مسؤوليتك.