Шаблон доставки 1688

POST /v1/products/freight/template

Тарифы внутренней доставки, оценка и размеры упаковки через официальный API. Не создаёт заказ и не гарантирует итоговую стоимость.

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, как в заказах; HIOBuy сам находит исходный 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 CNY. Вес кг, размеры см. 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