تكامل الشحن في ماجنتو: من واجهة برمجة التطبيقات إلى الجمارك
يعني تكامل الشحن مع ماجنتو، تحديدًا، أن إنشاء الملصقات وتتبع الشحنات ومعرفة حالة الشحنات تتم تلقائيًا من داخل المتجر، ويتم التحكم بها عبر واجهة برمجة تطبيقات REST الخاصة بماجنتو أو وحدة خاصة بشركات الشحن. توجد طرق مختلفة للتنفيذ التقني. واجهة برمجة تطبيقات REST الخاصة بـ Magento (تقريبًا POST /V1/order/{orderId}/shipهذا مناسب إذا كنت بحاجة إلى تحكم كامل في المنطق وترغب في ربطه بنظام تخطيط موارد المؤسسات (ERP). وحدة حاملة أصلية مثل شركة دي إتش إل للشحن (Dhl_Shippingهذا يكفي لتجار التجزئة الذين لديهم مزود شحن رئيسي واحد. برمجيات وسيطة متعددة شركات الاتصالات يصبح الأمر مجدياً بمجرد أن تتكامل شركات الشحن المتعددة، والحسابات الجمركية، والتجارة الإلكترونية.
قبل كل عملية دمج، يتم إجراء فحص سريع:
- تحقق من البيانات الرئيسية: يجب إدخال الوزن والأبعاد ورقم التعريفة الجمركية وقيمة البضائع بشكل صحيح لكل منتج.
- قم بإعداد بيئة تجريبية (Sandbox) واحرص على فصلها تمامًا عن البيئة الحية.
- إدارة بيانات الوصول إلى واجهة برمجة التطبيقات (رمز حامل أو OAuth) وبيانات اعتماد شركة الاتصالات بشكل منفصل.
ندعمك في كل خطوة من خطوات الطريق لإيجاد الحل المناسب لعملك.
الأفكار الرئيسية
يعتمد نجاح عملية دمج الشحن في ماجنتو على البيانات الرئيسية النظيفة، والمسار التقني الصحيح، واختبارات بيئة الاختبار المتسقة قبل الإطلاق الفعلي.
| موضوع | تفاصيل |
|---|---|
| اختر المسار الصحيح | واجهة برمجة تطبيقات REST لتكامل نظام تخطيط موارد المؤسسات (ERP)، ووحدة ناقل لشاحن رئيسي، وبرمجيات وسيطة لمقدمي خدمات الشحن المتعددين. |
| البيانات الرئيسية أولاً | يجب إدخال الوزن والأبعاد ورمز النظام المنسق وقيمة البضائع بشكل صحيح قبل أي عملية أتمتة. |
| افصل صندوق الرمل تمامًا | لا تخلط أبدًا بين بيانات الوصول الحية وبيانات الوصول التجريبية؛ فهذا هو المصدر الأكثر شيوعًا للأخطاء. |
| خطة للمراقبة | قم بمراقبة سجلات الأخطاء وأوقات استجابة شركات الاتصالات وقواعد الإنذار بشكل مستمر، وليس فقط أثناء عملية الإطلاق. |
| الأتمتة عبر الطرود الدولية | تقوم المنصة بحساب الرسوم الجمركية وتكاليف الشحن تلقائيًا، وتربط ماجنتو مركزيًا بجميع خدمات الطرود الشائعة. |
Inhaltsverzeichnis
- قائمة التحقق للبدء السريع: انطلق في 6 خطوات
- ما هو خيار التكامل التقني الأنسب لمتجرك؟
- كيف يقوم المطورون بتكوين واجهة برمجة تطبيقات الشحن تقنياً؟
- لماذا تفشل عملية حساب الرسوم الجمركية التلقائية بسبب ضعف البيانات الأساسية؟
- كيف تختبر تكامل الشحن قبل إطلاقه؟
- الشحن الدولي كطريقة لأتمتة تكامل الشحن
- تضخم
قائمة التحقق للبدء السريع: انطلق في 6 خطوات
يحدد الترتيب ما إذا كان التكامل سيسير بسلاسة أم ستقضي أيامًا في البحث عن الأخطاء.
- تحقق من البيانات الرئيسية (العمليات): الحفاظ بشكل كامل على الوزن والأبعاد ورموز النظام المنسق وقيمة البضائع لكل منتج.
- تهيئة بيئة الاختبار (المطور): قم بتفعيل بيئة اختبار DHL التجريبية أو بيئة اختبار واجهة برمجة التطبيقات قبل إطلاق أي شيء.
- تفعيل واجهة برمجة التطبيقات أو الوحدة النمطية (المطور): إما قم بتوصيل واجهة برمجة تطبيقات Magento REST أو قم بتفعيل وحدة Carrier في لوحة التحكم ضمن المتاجر → التكوين → المبيعات → طرق التسليم.
- تنفيذ أوامر الاختبار (الشحن، العمليات): محاكاة سيناريوهات طلبات متعددة بما في ذلك الشحن الجزئي.
- تحقق من سجلات النظام (المطور): تحقق من سجلات الأخطاء وأوقات استجابة واجهة برمجة التطبيقات قبل بدء عملية النشر.
- انطلق مباشرة (العمليات والمطورون معًا): قم بتحويل بيانات الوصول من Sandbox إلى Live وراقب عن كثب عمليات البث الحقيقية الأولى.
نصيحة احترافية: إنّ السبب الأكثر شيوعًا للأخطاء ليس خللًا في الإعدادات، بل مزيج من بيانات اعتماد بيئة الاختبار وبيانات اعتماد بيئة التشغيل. قبل نشر النظام، تحقق بدقة من زوج بيانات الاعتماد النشط حاليًا.
ما هو خيار التكامل التقني الأنسب لمتجرك؟
توفر واجهة برمجة تطبيقات Magento REST إمكانية الوصول عبر مورد الشحنات. /V1/shipment تُوفّر نقاط نهاية لإنشاء الشحنات واسترجاعها، بما في ذلك بيانات التتبع والمصادقة عبر رمز حامل أو OAuth. يُناسب هذا الأسلوب إذا كان لديك تكامل قائم مع نظام تخطيط موارد المؤسسات (ERP) أو كنت ترغب في برمجة قواعد الشحن الخاصة بك. يتطلب هذا الأسلوب جهدًا تطويريًا أكبر، ولكن في المقابل، ستحصل على تحكم كامل في كل خطوة من خطوات عملية الشحن.
مواطن وحدة حاملة يُعدّ إعداد وحدة Magento_Dhl أسرع في لوحة التحكم. وتوصي Adobe Experience League بتعيين نوع DHL إلى "DHL REST" أثناء الإعداد، حيث تُعتبر واجهة XML القديمة قديمة. ويُعدّ وضع Sandbox وبيانات اعتماد API منفصلة إلزاميّين هنا، وليسا اختياريين.
بالنسبة لتجار التجزئة الذين يتعاملون مع العديد من شركات الشحن، غالباً ما يكون من المفيد النظر في اختيار إحداها. برمجيات وسيطة متعددة شركات الاتصالاتيجمع هذا النظام خيارات الشحن من DHL و UPS و FedEx و DPD أو DB Schenker في واجهة واحدة ويتعامل مع تقدير تكلفة الوصول والتجارة الإلكترونية بشكل مركزي، بدلاً من الاحتفاظ بهذه المعلومات بشكل فردي لكل شركة شحن.
يعتمد القرار على أربعة معايير:
- جهود التنفيذيتطلب دمج واجهة برمجة التطبيقات موارد من المطورين؛ ويستغرق تكوين وحدة نمطية ساعات.
- قابلية الصيانةتتولى البرمجيات الوسيطة تحديثات شركات الاتصالات مركزياً؛ يجب عليك صيانة عمليات تكامل واجهة برمجة التطبيقات الخاصة بك بنفسك.
- أسعار فوريةلا توفر كل وحدة أسعارًا دقيقة حتى اليوم؛ وعادةً ما تفعل حلول البرمجيات الوسيطة ذلك بشكل أكثر موثوقية.
- وظائف مخصصةيحتاج أي شخص يقوم بشحن كميات كبيرة دوليًا إلى حساب تكلفة الشحن والتخليص الجمركي تلقائيًا عند إتمام عملية الشراء.
كيف يقوم المطورون بتكوين واجهة برمجة تطبيقات الشحن تقنياً؟
نقطة النهاية المركزية لإنشاء البرامج هي POST /V1/order/{orderId}/ship. عالي وثائق Adobe Commerce هل يقبل حمولة JSON مع items, notify اوند tracks. ايم tracks-المصفوفة التي تمررها carrier_code, title اوند track_number، والتراسل الفوري items- قم بترتيب العناصر ذات الصلة order_item_id مع تحديد الكمية المشحونة. يمكن للطلب الناجح أن يُعيّن حالة الطلب تلقائيًا إلى "مكتمل".
بالنسبة للمنتجات المجمعة، المستوى الأعلى order_item_idفي حالة التسليمات الجزئية، يُرجى تحديد المنتجات التي تم شحنها فعلياً فقط. يُعدّ هذا الأمر بالغ الأهمية، خاصةً في الشحنات الدولية، إذا تأخر تسليم أحد المنتجات بسبب مشاكل في المخزون.
تتوفر ثلاث طرق للمصادقة: رمز مميز للمسؤول (حامل) للتكاملات الداخلية، وOAuth 1.0a لتطبيقات الطرف الثالث، ووصول محدود للضيوف لنقاط النهاية العامة الفردية. بالنسبة لمعظم تكاملات Magento، يكفي استخدام رمز المسؤول المميز.
في لوحة التحكم، فعّل شركة DHL للشحن من خلال المتاجر ← الإعدادات ← المبيعات ← طرق التوصيل، ثم أدخل مفتاح API وكلمة مرور API لـ DHL REST. يمكن تثبيت وحدة DHL لـ Magento 2 عبر Composer، ثم... bin/magento module:enable Dhl_Shipping، تالي setup:upgrade, cache:flush اوند di:compile.
- ينبغي تفعيل خطافات إنشاء الملصقات مع كل عملية إنشاء شحنة.
- يقوم مستمع الأحداث بتسجيل الأخطاء بشكل منفصل عن المكالمات الناجحة.
- تمنع آليات إعادة المحاولة ذات التراجع الأسي فشل الناقل على المدى القصير من حجب الإرسال بالكامل.
نصيحة احترافية: التزم بدقة بتسلسل الإعداد: أولاً، أنشئ حساب الشاحن، ثم أدخل العناوين، ثم حدد أحجام الطرود، وأخيراً فعّل طرق الشحن. عكس هذا الترتيب سيؤدي إلى ظهور أخطاء غير ظاهرة لن تظهر إلا مع أول شحنة فعلية.
لماذا تفشل عملية حساب الرسوم الجمركية التلقائية بسبب ضعف البيانات الأساسية؟
بدون بيانات دقيقة للمنتج، يستحيل إجراء حسابات جمركية تلقائية. يجب أن تكون الأوزان والأبعاد دقيقة، وكذلك رقم التعريفة الجمركية (رمز النظام المنسق) والقيمة الفعلية للبضائع. في حال فقدان أي من هذه المعلومات، رقم زولتاريف لا يمكن تعيينها تلقائياً، وتتعطل الشحنة في الجمارك.
يُقلل العديد من تجار التجزئة من أهمية جودة البيانات الأساسية (عبر https://paket-international.com/zolltarifnummer-bestimmen) لعملية الأتمتة بأكملها. فبدون مواصفات دقيقة للوزن والأبعاد، بالإضافة إلى رموز النظام المنسق (HS) الدقيقة، لا يمكن إجراء حسابات جمركية تلقائية ولا إنشاء ملصقات موثوقة.
بالنسبة للشحنات الدولية، تنطبق متطلبات إضافية: تقوم التجارة الإلكترونية غير الورقية بنقل المستندات الجمركية إلكترونيًا بدلاً من شكلها الورقي، ويظهر تقدير التكلفة النهائية للمشتري الرسوم الجمركية والضرائب عند الدفع، ويجب تضمين معلومات EORI و VAT في مستندات الشحن.
على وجه التحديد، تتضمن قاعدة بيانات البيانات الرئيسية النظيفة ما يلي:
- مواصفات دقيقة للوزن والأبعاد لكل قطعة، بدون تقديرات.
- أرقام التعريفة الجمركية الصحيحة لكل فئة من فئات المنتجات.
- القيمة الفعلية للبضائع في الفاتورة التجارية، وليس متوسط قيمة ثابتة.
- رقم EORI ورقم تعريف ضريبة القيمة المضافة للتخليص الجمركي.
يؤدي تعيين رموز النظام المنسق (HS) بشكل غير صحيح إلى تأخيرات جمركية وتكاليف إضافية غير متوقعة. يُجنّب التحقق المنهجي من بيانات المنتج قبل بدء التكامل هذا الجهد الإضافي أثناء التشغيل.
كيف تختبر تكامل الشحن قبل إطلاقه؟
يجب عليك إجراء أربع حالات اختبار قبل كل إطلاق مباشر: عرض السعر في صفحة الدفع، وإنشاء الملصق نفسه، وتسليم رقم التتبع إلى العميل، والتعامل مع الشحنات الجزئية أو المرتجعات.
- قم بإجراء فحوصات أسعار الدفع مع مختلف دول الوجهة وأحجام الطرود.
- اختبار إنشاء الملصقات في وضع الاختبار دون إجراء حجز حقيقي مع شركة النقل.
- تحقق من عملية تسليم التتبع إلى العميل، بما في ذلك تغييرات حالة الطلب.
- محاكاة الشحن الجزئي، حيث يتم إرسال جزء فقط من العناصر المطلوبة.
بالنسبة للعمليات الجارية، يلزم وجود نظام مراقبة ثابت:
- المراقبة اليومية لسجلات الأخطاء واستدعاءات واجهة برمجة التطبيقات الفاشلة.
- مراقبة أوقات استجابة شركات الاتصالات للكشف عن الأعطال مبكراً.
- قم بتوضيح قواعد التنبيه التي تُفعّل الإشعار تلقائيًا في حالة تكرار أخطاء الشحن.
كما أن خطة التراجع جزء من الخطة: في حالة حدوث أخطاء حرجة، قم بتعطيل الوحدة النمطية والتحويل إلى قاعدة شحن احتياطية بدلاً من حظر عملية الدفع تمامًا.
الشحن الدولي كطريقة لأتمتة تكامل الشحن
أي شخص يرغب في برمجة واجهة برمجة تطبيقات REST بنفسه أو صيانة وحدة واحدة خاصة بشركات الشحن يستثمر وقتاً ثميناً لدى المطورين، وهو وقت لا يتوفر لدى العديد من تجار التجزئة. تربط Paket International منصة Magento بجميع شركات الشحن الشائعة عبر تكامل مركزي، بدلاً من صيانة وحدات منفصلة لشركات DHL وUPS وFedEx وDPD وDB Schenker.
تحسب المنصة تكاليف الشحن والرسوم الجمركية في ثوانٍ، وتُنشئ ملصقات الشحن تلقائيًا، وتُجري التخليص الجمركي دون تدخل يدوي. بالنسبة لتجار التجزئة الإلكترونيين ذوي النشاط التجاري الدولي، يُقلل هذا بشكل كبير من الجهد الإداري. تعرض لوحة تحكم مركزية جميع الشحنات بنظرة سريعة، بما في ذلك... تتبع الشحنة في جميع خدمات الطرود.
خصوصا ل تجار التجزئة عبر الإنترنتبالنسبة لمن يديرون حاليًا وحدات شركات الشحن بشكل منفصل وما زالوا يملؤون مستندات الجمارك يدويًا، يمثل هذا توفيرًا مباشرًا للوقت: حيث تتم معالجة تكلفة الشحن، وأوراق الجمارك، وإنشاء الملصقات تلقائيًا، دون الحاجة إلى برمجة أي منطق برمجي إضافي. إذا كنت ترغب في استكشاف كيفية استبدال أو استكمال تكامل الشحن الحالي في ماجنتو، فمن المفيد الاطلاع على... دمج ماجنتو لشركة باكيت الدولية وعرض غير ملزم لحجم شحناتك.