نظرة عامة على التنفيذ الدولي
يغطي /v1/fulfillment/* الخدمات اللوجستية الدولية بعد دخول البضاعة مستودع HIOBuy. الشراء المحلي: طلبات الشراء بالوكالة.
يتطلب التطبيق تنفيذ المستودع (تفويض البوابة). تطبيقات التنفيذ الذاتي تتلقى 403 FULFILLMENT_MODE_NOT_SUPPORTED.
الوحدة النقدية {#monetary-unit}
تتضمن استجابات JSON القياسية لمسارات التنفيذ ذات المبالغ الحقل العلوي monetary_unit: "CNY_minor". كل { amount, currency } يستخدم فن الصيني (1 يوان = 100 فن). انظر نماذج استجابة التنفيذ.
توفر واجهات API {#availability}
| المسار | الحالة |
|---|---|
/v1/fulfillment/inbounds/create | Live لمستودع simple-store في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/packages | Live لمستودع packages/index في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/packages/{package_id} | Live لمستودع packages/detail/{id} في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/packages/{package_id}/tracking | Live لمستودع packages/logs/{id} في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/unclaimed-packages | Live للقائمة والمطالبة في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/returns | Mock — إنشاء / سرد / تأكيد / إلغاء الإرجاع للبائع |
/v1/fulfillment/locations | Live لمستودع warehouse في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/value-added-services | Live لمستودع services في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/service-requests | Mock — إنشاء / سرد / تفاصيل / تأكيد |
/v1/fulfillment/shipments/{id}/intercept | Live لمستودع shipments/set-exceptional في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/shipments | Live لمستودع shipments/index في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/shipping/channels | كتالوج قنوات Live في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/shipping/quotes | عروض أسعار Live في وضع المستودع؛ mock في sandbox |
/v1/fulfillment/shipments/* | متاح (HTTP المستودع إن وُجدت الإعدادات، وإلا mock) |
/v1/fulfillment/balance | متاح |
/v1/shipments (قديم) | مهجور |
التدفق من البداية إلى النهاية {#end-to-end-flow}
- إنشاء طلب شراء بالوكالة → يرسل البائع إلى المستودع
أو إشعار الوارد للطرود التي تتحكم فيها مسبقاً - تفاصيل / تتبع الطرد → قياسات المستودع / الاستثناءات / VAS / الخط الزمني
أو تفاصيل الطلب →tracking_numbers[]بعد الدخول من الشراء - قنوات الشحن للإمكانات، ثم عروض أسعار الشحن → اختر
quotes[].channel.code - إنشاء شحنة →
id/order_sn(PENDING) - التعبئة والقياس النهائي في المستودع →
boxes[]والوزن / الأبعاد / الشحن النهائي - الشحنة جاهزة للدفع (
WAIT_PAYMENT) → انظر التفاصيل؛ الدفع المبكر يعيد409 SHIPMENT_NOT_READY_FOR_PAYMENT - دفع الشحنة → خصم من المحفظة
- القائمة / التفاصيل → صفوف خفيفة، أو صناديق / ملفات التعبئة /
timeline/ أرقام الميل الأول والأخير
اختياري: اعتراض لإيقاف شحنةWAIT_SHIP/SHIPPED - التتبع الدولي → أحداث المسح
جديد على تنفيذ المستودع؟ اتبع دليل اختبار WH-DEV لتجربة التدفق الكامل بما فيه التعبئة والتسوية.
دليل نقاط النهاية
| الموضوع | المسار | المستند |
|---|---|---|
| إشعار الوارد | POST .../inbounds/create | الوارد |
| التفاصيل / التتبع / غير المطالب بها | GET .../packages/* · unclaimed-packages | الطرود |
| المرتجعات | POST/GET .../returns · confirm/cancel | المرتجعات |
| المواقع | GET .../locations | المواقع |
| الخدمات ذات القيمة المضافة | GET .../value-added-services | VAS |
| طلبات الخدمة | POST/GET .../service-requests · confirm | طلبات الخدمة |
| قنوات الشحن | GET .../shipping/channels | قنوات الشحن |
| عروض أسعار الشحن | POST .../shipping/quotes | عروض أسعار الشحن |
| إنشاء / دفع / إلغاء / اعتراض | POST .../shipments/create · {id}/pay · {id}/cancel · {id}/intercept | الشحنات |
| قائمة الشحنات | GET .../shipments | الشحنات · القائمة |
| تفاصيل الشحنة | GET .../shipments/{id} | الشحنات · التفاصيل |
| التتبع الدولي | GET .../shipments/{id}/tracking | التتبع |
| رصيد المحفظة | GET /v1/fulfillment/balance | الرصيد |
| حقول الاستجابة | — | نماذج الاستجابة |
| سمات السلعة | GET .../item-attributes | عروض أسعار الشحن |
الشراء في وضع المستودع
مسارات /v1/orders/* لا تتغير؛ تمرّر البوابة الطلبات إلى HIOBuy. واجهات المنتجات ما زالت تستدعي الأسواق مباشرة.
التتبع المحلي: تتبع لوجستيات الطلب (عبر الوكيل في وضع المستودع).
مخططات دورة الحياة {#lifecycle}
مخططات الحالات: الطرود، الشحنات، المرتجعات.
الأخطاء
FULFILLMENT_MODE_NOT_SUPPORTED و SHIPMENT_CREATE_EXCEPTION و SHIPMENT_CREATE_FAILED و PARCEL_NOT_FOUND و EXTERNAL_ORDER_ID_ALREADY_EXISTS و SHIPMENT_NOT_READY_FOR_PAYMENT و SHIPMENT_ALREADY_PAID و INSUFFICIENT_BALANCE و NOT_FOUND (SHIPMENT_NOT_EXISTS) ورموز الاعتراض (SHIPMENT_NOT_FOUND و SHIPMENT_NOT_INTERCEPTABLE و SHIPMENT_INTERCEPTION_ALREADY_REQUESTED) — انظر الأخطاء و الشحنات.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days