قالب شحن منتجات 1688
POST /v1/products/freight/template
رسوم الشحن الداخلي وقواعد التسعير والأبعاد عبر الواجهة الرسمية. لا يُنشئ طلبًا ولا يضمن التكلفة النهائية.
com.alibaba.fenxiao.crossborder:product.freight.estimate-1 · 1688
مفتاح Live بصلاحية product:detail وتفويض 1688. النجاح يستهلك 2 API Units شاملة مطابقة SKU؛ لا خصم عند الفشل. لا تُستخدم AI Credits حتى مع shop أو X-Shop-Domain. Sandbox: 422 SANDBOX_CAPABILITY_UNAVAILABLE.
الطلب
skus[].spec_id مأخوذ من variants[].sku_id في تفاصيل 1688 القياسية، كما في الطلبات. تتم مطابقة skuId الأصلي داخليًا. من 1 إلى 100 SKU فريد بكميات ومجموع أعداد صحيحة موجبة آمنة. يُحسب total_quantity تلقائيًا وتُرفض المواصفات غير الموجودة.
POST /v1/products/freight/template
{
"channel": "1688",
"product_id": "111111111",
"destination": {
"province": "浙江省",
"city": "杭州市",
"district": "滨江区"
},
"skus": [
{
"spec_id": "b266e0726506185beaf205cbae88530d",
"quantity": 3
}
]
}أسماء المناطق ورموزها
أرسل الأسماء الصينية الثلاثة أو الرموز الثلاثة ذات ست خانات. تُقبل الاختصارات غير الملتبسة ويجب توافق الأسماء والرموز. بيانات البر الصيني بتاريخ 2023-06-30 وقد توقف المصدر عن تحديثها. للمناطق الجديدة أرسل الرموز الحالية ويحدد 1688 قبولها. تُعالج البلديات بصورة خاصة وتُربط بلدات دونغقوان وتشونغشان ودانتشو وجيايوغوان برمز المدينة ذي الست خانات، وليس رمز الشارع ذي التسع خانات. تُرفض الأسماء المجهولة أو الملتبسة؛ قد تكون أسماء الرموز الجديدة null.
province / city / district → province_code / city_code / district_code
{
"destination": {
"province_code": "330000",
"city_code": "330100",
"district_code": "330108"
}
}Administrative-divisions-of-China
الاستجابة
المبالغ بوحدة فن CNY (CNY_minor): 490 تعني 4.90 يوان. الوزن كغ والأبعاد سم. dimensions_source=product يقابل sizeValueType=1 وproduct_dimensions؛ وsku يقابل 2 وskus[].dimensions. المفقود null والشحن المجاني الصريح 0. لا يُطبق discount مجددًا. يحتفظ response_format=upstream بالحقول وskuId واليوان الأصلي دون monetary_unit. أخطاء المورد تعيد 502 في الشكلين. المثال أدناه توضيحي.
charge_type: weight / quantity / volume → charge_unit: kg / item / m3
template.type: seller_paid / custom / official_custom
template.shipping_method: express / freight / cash_on_delivery / official
{
"request_id": "req_example",
"monetary_unit": "CNY_minor",
"freight_template": {
"channel": "1688",
"product_id": "111111111",
"destination": {
"province": "浙江省",
"province_code": "330000",
"city": "杭州市",
"city_code": "330100",
"district": "滨江区",
"district_code": "330108"
},
"total_quantity": 3,
"free_postage": false,
"freight": {
"amount": 490,
"currency": "CNY"
},
"discount": 1,
"template": {
"id": "123456789",
"name": "普通快递运费模板",
"type": "custom",
"shipping_method": "express",
"charge_type": "weight",
"charge_unit": "kg",
"first_unit": 1,
"first_fee": {
"amount": 290,
"currency": "CNY"
},
"next_unit": 1,
"next_fee": {
"amount": 200,
"currency": "CNY"
}
},
"dimensions_source": "sku",
"product_dimensions": null,
"skus": [
{
"spec_id": "b266e0726506185beaf205cbae88530d",
"quantity": 3,
"dimensions": {
"weight_kg": 0.5,
"length_cm": 20,
"width_cm": 15,
"height_cm": 10
}
}
]
}
}الأخطاء
| HTTP | Code |
|---|---|
| 400 | INVALID_DESTINATION, REGION_NOT_FOUND, REGION_AMBIGUOUS, REGION_CODE_MISMATCH, INVALID_PRODUCT_ID, INVALID_SKUS, INVALID_SPEC_ID, DUPLICATE_SPEC_ID, INVALID_QUANTITY |
| 401 / 403 | Authentication |
| 404 | NOT_FOUND |
| 422 | SANDBOX_CAPABILITY_UNAVAILABLE |
| 429 | Rate limits |
| 502 | CHANNEL_UPSTREAM_ERROR |
POST /v1/products/freight/estimate · POST /v1/orders/preview
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days