供应链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 运费计算
        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/v1/order/order_preview

功能说明#

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

应用场景#

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

注意事项#

1.
收货地址为省市区id,直辖市时【上海除外】,province:直辖市id,city:直辖市区id,area:0
2.
运输方式为快递时,在线手续快递费;运输方式为物流时,线下到付

请求参数

Header 参数

Body 参数application/json

示例
{
	"checkType": 1,
	"goods": [
		{
			"goodsId": 318689,
			"specId": 5362833,
			"num": 1,
			"yfMode": 1,
			"price": 3
		},
		{
			"goodsId": 280304,
			"specId": 539097,
			"num": 1,
			"yfMode": 2,
			"price": 1760
		}
	],
	"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/v1/order/order_preview' \
--header 'appKey;' \
--header 'token;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"checkType": 1,
	"goods": [
		{
			"goodsId": 318689,
			"specId": 5362833,
			"num": 1,
			"yfMode": 1,
			"price": 3
		},
		{
			"goodsId": 280304,
			"specId": 539097,
			"num": 1,
			"yfMode": 2,
			"price": 1760
		}
	],
	"consignee": {
		"receiver": "张三丰",
		"phone": "13888888888",
		"address": {
			"province": 1491,
			"city": 1492,
			"area": 1493,
			"detail": "宇宙中心太阳系小区88栋楼8单元808室"
		}
	}
}'

返回响应

🟢200成功
application/json
Body

示例
{
	"status": 200,
	"msg": "请求成功",
	"requestId": "05084948-7957-11ee-8937-08002763b2f5",
	"content": {
		"totalGoodsPrice": 1763,
		"totalShipPrice": 1,
		"totalWlPrice": 100,
		"totalPrice": 1764,
		"detail": [
			{
				"goodsId": 318689,
				"specId": 5362833,
				"num": 1,
				"yfMode": 1,
				"price": 3,
				"totalGoodsPrice": 3,
				"totalShipPrice": 1,
				"totalPrice": 4,
				"shippingFeeDetail": {
					"shipPrice": 1,
					"basicShipPrice": 0,
					"totalShipPrice": 1,
					"yfModeType": 1
				}
			},
			{
				"goodsId": 280304,
				"specId": 539097,
				"num": 1,
				"yfMode": 2,
				"price": 1760,
				"totalGoodsPrice": 1760,
				"totalShipPrice": 0,
				"totalPrice": 1760,
				"shippingFeeDetail": {
					"shipPrice": 100,
					"basicShipPrice": 0,
					"totalShipPrice": 100,
					"yfModeType": 2
				}
			}
		],
		"consignee": {
			"receiver": "张三丰",
			"phone": "13888888888",
			"address": {
				"province": 1491,
				"city": 1492,
				"area": 1493,
				"detail": "宇宙中心太阳系小区88栋楼8单元808室"
			}
		}
	}
}
修改于 2024-07-10 00:51:54
上一页
4.1 运费计算
下一页
4.3 订单创建
Built with