نظرة عامة على الشحن الدولي
يغطي /v1/fulfillment/* اللوجستيات الدولية بعد وجود البضائع في مستودع HIOBuy. الشراء المحلي: طلبات الشراء.
يتطلب warehouse fulfillment في تطبيقك (تفويض البوابة). تحصل تطبيقات self-fulfillment على 403 FULFILLMENT_MODE_NOT_SUPPORTED.
توفر API {#availability}
| Path | الحالة |
|---|---|
/v1/fulfillment/shipments/* | مخطط — المواصفة مستقرة؛ طرح Gateway قيد التنفيذ |
/v1/fulfillment/balance | مخطط |
/v1/shipments (legacy) | مهمل |
التدفق الكامل {#end-to-end-flow}
- إنشاء طلب شراء → البائع يشحن إلى المستودع
- تفاصيل الطلب →
parcel_nos[]عند الوصول - تقدير الشحن → اختر
shipping_channel_code - معاينة الشحنة → السعر الدقيق
- إنشاء الشحنة →
shipment_id - دفع الشحنة → خصم من المحفظة
- التتبع الدولي
دليل نقاط النهاية
| الموضوع | Path | المستند |
|---|---|---|
| عرض شحن سريع | POST .../freight/estimate | تقدير الشحن |
| عرض مستودع دقيق | POST .../preview | معاينة الشحنة |
| إنشاء / دفع / إلغاء / تفاصيل | POST .../shipments/* | الشحنات |
| التتبع الدولي | POST .../logistics/trace | التتبع |
| رصيد المحفظة | GET /v1/fulfillment/balance | الرصيد |
| حقول الاستجابة | — | نماذج استجابة fulfillment |
| سمات العناصر | GET .../item-attributes | تقدير الشحن |
الشراء في وضع المستودع
تبقى مسارات /v1/orders/* كما هي؛ يمرر Gateway الطلب إلى HIOBuy. لا تزال Product APIs تستدعي الأسواق مباشرة.
التتبع المحلي: تتبع لوجستيات الطلب (يمرر عبر proxy في وضع المستودع).
الأخطاء
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — راجع الأخطاء.