供应链API
  1. 4 订单
供应链API
  • 使用说明
  • 帮助中心
  • 更新说明
  • V1
    • 1 账号信息
      • 1.1 获取 TOKEN
      • 1.2 重置 TOKEN
      • 1.3 账号基本信息
      • 1.4 设置回调地址
    • 2 基础信息
      • 2.1 省市区列表
      • 2.2 省市区详情
      • 2.3 商品分类
      • 2.4 商品品牌
      • 2.5 所有运输方式
    • 3 商品
      • 3.1 商品列表
      • 3.2 商品详情
      • 3.3 商品运输方式
      • 3.4 商品库存
      • 3.5 全部在售商品
    • 4 订单
      • 4.1 运费计算
      • 4.2 订单预览
      • 4.3 订单创建
      • 4.4 订单支付
      • 4.5 订单取消
      • 4.6 订单详情
      • 4.7 确认收货
      • 4.8 运输方式运费
    • 5 售后
      • 5.1 预约服务类型
      • 5.2 上传资源
      • 5.3 创建预约服务
      • 5.4 取消预约服务
      • 5.5 预约服务列表
      • 5.6 预约服务详情
      • 5.7 订单售后详情
    • 6 回调通知
      • 回调通知
  • V2
    • 1 账号信息
      • 1.1 获取 TOKEN
      • 1.2 重置 TOKEN
      • 1.3 账号基本信息
      • 1.4 设置回调地址
    • 2 基础信息
      • 2.1 省市区列表
      • 2.2 省市区详情
      • 2.3 商品分类
      • 2.4 商品品牌
      • 2.5 所有运输方式
    • 3 商品
      • 3.1 商品列表
      • 3.2 商品详情
      • 3.3 商品运输方式
      • 3.4 商品库存
      • 3.5 全部在售商品
    • 4 订单
      • 4.1 运费计算
        POST
      • 4.2 订单预览
        POST
      • 4.3 订单创建
        POST
      • 4.4 订单支付
        POST
      • 4.5 订单取消
        POST
      • 4.6 订单详情
        POST
      • 4.7 确认收货
        POST
      • 4.8 运输方式运费
        POST
    • 5 售后
      • 5.1 预约服务类型
      • 5.2 上传资源
      • 5.3 创建预约服务
      • 5.4 取消预约服务
      • 5.5 预约服务列表
      • 5.6 预约服务详情
      • 5.7 订单售后详情
    • 6 回调通知
      • 回调通知
  1. 4 订单

4.2 订单预览

POST
/api/v2/order/order_preview

功能说明#

根据用户实际收货地址、商品及数量、运输方式计算商品的运费、商品金额及订单需要扣除的储备金总金额

应用场景#

商品立即购买、勾选购物车商品等,计算选择商品的运费信息、商品费用、需要扣除储备金的信息

注意事项#

1.
收货地址为省市区id,直辖市时【上海除外】,province:直辖市id,city:直辖市区id,area:0
2.
运输方式为快递时,在线手续快递费;运输方式为物流时,线下到付
3.
allowNonPackage:是否支持散件购买,1是,2否;当商品的打包数不等于1时,如果商品支持散件购买,运费计算、订单预览、创建订单等接口时,传此参数为1时,不再校验打包数,标识业务侧需要零散购买;
4.
支持零散购买时,购买数量非商品的打包数时,有可能会形成两个小订单,分别以packageType:发货类型:1整件,2散件

请求参数

Header 参数

Body 参数application/json

示例
{
	"checkType": 1,
	"allowNonPackage":1,
	"goods": [
		{
			"goodsId": 318689,
			"specId": 5362833,
			"num": 1,
			"yfMode": 1,
			"price": 4
		},
		{
			"goodsId": 318672,
			"specId": 5363009,
			"num": 5,
			"yfMode": 1,
			"price": 6
		}
	],
	"consignee": {
		"receiver": "张三丰",
		"phone": "13888888888",
		"address": {
			"province": 1491,
			"city": 1492,
			"area": 1493,
			"detail": "宇宙中心太阳系小区88栋楼8单元808室"
		}
	}
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test-openapi.7dingdong.com/api/v2/order/order_preview' \
--header 'appKey: ' \
--header 'token: ' \
--header 'nonce: ' \
--header 'timestamp: ' \
--header 'signature: ' \
--header 'Content-Type: application/json' \
--data-raw '{
	"checkType": 1,
	"allowNonPackage":1,
	"goods": [
		{
			"goodsId": 318689,
			"specId": 5362833,
			"num": 1,
			"yfMode": 1,
			"price": 4
		},
		{
			"goodsId": 318672,
			"specId": 5363009,
			"num": 5,
			"yfMode": 1,
			"price": 6
		}
	],
	"consignee": {
		"receiver": "张三丰",
		"phone": "13888888888",
		"address": {
			"province": 1491,
			"city": 1492,
			"area": 1493,
			"detail": "宇宙中心太阳系小区88栋楼8单元808室"
		}
	}
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "status": 200,
    "msg": "请求成功",
    "requestId": "53787812-87a3-11f0-8fd2-080027db4a40",
    "content": {
        "totalGoodsPrice": 34,
        "totalShipPrice": 495,
        "totalWlPrice": 0,
        "totalPrice": 529,
        "detail": [
            {
                "goodsId": 318689,
                "specId": 5362833,
                "num": 1,
                "yfMode": 1,
                "yfModeType": 1,
                "price": 4,
                "totalGoodsPrice": 4,
                "totalShipPrice": 0,
                "totalPrice": 4,
                "shippingFeeDetails": [
                    {
                        "num": 1,
                        "shipPrice": 0,
                        "packageType": 1
                    }
                ]
            },
            {
                "goodsId": 318672,
                "specId": 5363009,
                "num": 5,
                "yfMode": 1,
                "yfModeType": 1,
                "price": 6,
                "totalGoodsPrice": 30,
                "totalShipPrice": 495,
                "totalPrice": 525,
                "shippingFeeDetails": [
                    {
                        "num": 4,
                        "shipPrice": 396,
                        "packageType": 1
                    },
                    {
                        "num": 1,
                        "shipPrice": 99,
                        "packageType": 2
                    }
                ]
            }
        ],
        "consignee": {
            "receiver": "张三丰",
            "phone": "13888888888",
            "address": {
                "province": 1491,
                "city": 1492,
                "area": 1493,
                "detail": "宇宙中心太阳系小区88栋楼8单元808室"
            }
        }
    }
}
修改于 2025-09-19 06:42:51
上一页
4.1 运费计算
下一页
4.3 订单创建
Built with