قالب شحن منتجات 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
        }
      }
    ]
  }
}

الأخطاء

HTTPCode
400INVALID_DESTINATION, REGION_NOT_FOUND, REGION_AMBIGUOUS, REGION_CODE_MISMATCH, INVALID_PRODUCT_ID, INVALID_SKUS, INVALID_SPEC_ID, DUPLICATE_SPEC_ID, INVALID_QUANTITY
401 / 403Authentication
404NOT_FOUND
422SANDBOX_CAPABILITY_UNAVAILABLE
429Rate limits
502CHANNEL_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

Email support