1688 상품 배송비 템플릿
POST /v1/products/freight/template
공식 API로 국내 배송비, 요금 규칙, 포장 치수를 조회합니다. 주문을 만들지 않으며 최종 배송비를 보장하지 않습니다.
com.alibaba.fenxiao.crossborder:product.freight.estimate-1 · 1688
product:detail Live 키와 1688 인증이 필요합니다. 성공 시 SKU 매핑 포함 2 API Units, 실패 시 차감 없음. shop 또는 X-Shop-Domain이 있어도 AI Credits를 사용하지 않습니다. Sandbox: 422 SANDBOX_CAPABILITY_UNAVAILABLE.
요청
skus[].spec_id는 1688 표준 상세의 variants[].sku_id로 주문과 같습니다. 원본 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
}
]
}지역 이름과 코드
중국어 지역명 3개 또는 6자리 코드 3개를 모두 전달합니다. 명확한 약칭을 지원하며 이름과 코드는 일치해야 합니다. 본토 데이터는 2023-06-30 기준으로 원본은 업데이트를 중단했습니다. 새 지역은 현재 코드를 보낼 수 있고 1688이 수용 여부를 결정합니다. 직할시를 별도 처리하고 둥관·중산·단저우·자위관의 읍면·거리는 6자리 도시 코드로 변환합니다. 9자리 거리 코드를 전송하지 않습니다. 불명확한 이름은 거부하며 새 코드의 지역명은 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위안. 중량 kg, 치수 cm. 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