4.1 运费计算

POST

/api/v2/order/shipping_fee

功能说明

根据收货省市区，获取商品运费

应用场景

商品立即购买、勾选购物车商品等，计算选择商品的运费信息

注意事项

支持批量计算，最多商品50个

收货地址为省市区id，直辖市时【上海除外】，province:直辖市id,city:直辖市区id，area:0

运输方式为快递时，在线收取快递费；运输方式为物流时，线下到付

allowNonPackage：是否支持散件购买，1是，2否；当商品的打包数不等于1时，如果商品支持散件购买，运费计算、订单预览、创建订单等接口时，传此参数为1时，不再校验打包数，标识业务侧需要零散购买；

支持零散购买时，购买数量非商品的打包数时，有可能会形成两个小订单，分别以packageType:发货类型：1整件，2散件

请求参数

Header 参数

Body 参数application/json

示例

{
    "goods": [
        {
            "goodsId": 318672,
            "specId": 5363009,
            "num": 1,
            "yfMode": 1
        },
        {
            "goodsId": 318733,
            "specId": 5363036,
            "num": 1,
            "yfMode": 4
        }
    ],
    "allowNonPackage":1,
    "province": 1491,
    "city": 1492,
    "area": 1493
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-openapi.7dingdong.com/api/v2/order/shipping_fee' \
--header 'appKey: ' \
--header 'token: ' \
--header 'nonce: ' \
--header 'timestamp: ' \
--header 'signature: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goods": [
        {
            "goodsId": 318672,
            "specId": 5363009,
            "num": 1,
            "yfMode": 1
        },
        {
            "goodsId": 318733,
            "specId": 5363036,
            "num": 1,
            "yfMode": 4
        }
    ],
    "allowNonPackage":1,
    "province": 1491,
    "city": 1492,
    "area": 1493
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "status": 200,
    "msg": "请求成功",
    "requestId": "6b765bfe-8795-11f0-bdf9-080027db4a40",
    "content": {
        "shipPrice": [
            {
                "goodsId": 318672,
                "specId": 5363009,
                "num": 5,
                "yfMode": 1,
                "yfModeType": 1,
                "shipPrice": 495,
                "shippingFeeDetails": [
                    {
                        "num": 4,
                        "shipPrice": 396,
                        "packageType": 1
                    },
                    {
                        "num": 1,
                        "shipPrice": 99,
                        "packageType": 2
                    }
                ]
            }
        ],
        "errorGoods": [
            {
                "goodsId": 318733,
                "specId": 5363036,
                "num": 1,
                "yfMode": 4,
                "msg": "收货地址不支持此方式配送，请选择其他运输方式！"
            }
        ]
    }
}

修改于 2025-09-20 02:35:07

3.5 全部在售商品

4.2 订单预览