نظرة عامة على طلبات الشراء
يغطي /v1/orders/* الشراء المحلي — طلبات مع بائعي 1688/Taobao للتسليم إلى عنوان وارد داخل الصين. هذا ليس شحنا دوليا؛ استخدم Fulfillment بعد وصول البضائع.
المبالغ بوحدة CNY fen (分). اضبط response_format حسب تنسيق الاستجابة.
اربط معرفات المنتج من Products: search/detail id → lines[].id (compatible: offer_id, Taobao mi_id)، وvariants[].sku_id → lines[].spec_id.
يتغيّر
id/mi_idفي Taobao دوريا. لا تخزّنه طويلا. المعرفات القديمة تفشل في detail وsimilar والطلبات. أعد الجلب قبل الدفع.
دورة الحياة {#lifecycle}
- Preview — التحقق من البنود والأسعار والشحن
- Create — إنشاء طلب الشراء
- Pay — التسوية من محفظة السوق
- Detail / list — تتبع الحالة
- Domestic trace — من البائع إلى المستودع
- Cancel — عندما يكون مسموحا
دليل نقاط النهاية
| الخطوة | Path | المستند |
|---|---|---|
| Preview | POST /v1/orders/preview | معاينة الطلب |
| Create | POST /v1/orders/create | إنشاء الطلب |
| Pay | POST /v1/orders/pay | دفع الطلب |
| Detail | POST /v1/orders/detail | تفاصيل الطلب |
| List | POST /v1/orders/list | تفاصيل الطلب |
| Cancel | POST /v1/orders/cancel | إلغاء الطلب |
| Domestic trace | POST /v1/orders/logistics/trace | تتبع اللوجستيات المحلية |
| Taobao purchases | POST /v1/orders/purchase/query | تفاصيل الطلب |
| Response schemas | — | نماذج استجابة الطلبات |
اختصارات القنوات: /v1/orders/1688/*, /v1/orders/taobao/* (يمكن أن يحذف الجسم channel).
اللوجستيات المحلية مقابل الدولية {#domestic-vs-international}
| المرحلة | API |
|---|---|
| البائع → مستودع الصين | Domestic trace |
| المستودع → المشتري خارجيا | International tracking |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days