4.3 订单创建

功能说明

根据收货省市区，商品收货信息，生成订单

应用场景

需要在我司创建订单时，调用此接口

注意事项

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

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

checkType: 数据校验方式，用于检查用户实际生成订单时，与订单预览时商品、运费价格是否一致；0不校验，1商品价格校验，2运费价格校验，3商品价格和运费价格都校验；此数据为实际扣除储备金的金额，请慎重选择！

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

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

收件人姓名不能含有下面特殊字符 ~!@#$%^&*()=|{}':;\[].<>?！￥…（）—【】‘；：”“’。，、？

请求参数

Header 参数

Body 参数application/json

示例

{
	"orderNo": "230029101363325102",
	"checkType": 3,
	"allowNonPackage": 1,
	"goods": [
		{
			"goodsId": 318763,
			"specId": 5363157,
			"num": 1,
			"yfMode": 1,
			"price": 5,
			"shipPrice": 0
		},
		{
			"goodsId": 318774,
			"specId": 5363206,
			"num": 5,
			"yfMode": 1,
			"price": 70,
			"shipPrice": 0
		}
	],
	"consignee": {
		"receiver": "张三丰",
		"phone": "13888888888",
		"address": {
			"province": 1491,
			"city": 1492,
			"area": 1493,
			"detail": "宇宙中心太阳系小区88栋楼8单元808室"
		}
	}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "status": 200,
    "msg": "请求成功",
    "requestId": "4a44dd0c-87c7-11f0-8267-080027db4a40",
    "content": {
        "orderSn": "25090214372721365018",
        "orderNo": "230029101363325102",
        "totalGoodsPrice": 355,
        "totalShipPrice": 0,
        "totalWlPrice": 0,
        "totalPrice": 355,
        "detail": [
            {
                "orderId": 9578243,
                "goodsId": 318763,
                "specId": 5363157,
                "num": 1,
                "yfMode": 1,
                "yfModeType": 1,
                "goodsPrice": 5,
                "totalGoodsPrice": 5,
                "totalShipPrice": 0,
                "totalPrice": 5,
                "packageType": 1
            },
            {
                "orderId": 9578244,
                "goodsId": 318774,
                "specId": 5363206,
                "num": 3,
                "yfMode": 1,
                "yfModeType": 1,
                "goodsPrice": 70,
                "totalGoodsPrice": 210,
                "totalShipPrice": 0,
                "totalPrice": 210,
                "packageType": 1
            },
            {
                "orderId": 9578245,
                "goodsId": 318774,
                "specId": 5363206,
                "num": 2,
                "yfMode": 1,
                "yfModeType": 1,
                "goodsPrice": 70,
                "totalGoodsPrice": 140,
                "totalShipPrice": 0,
                "totalPrice": 140,
                "packageType": 2
            }
        ],
        "consignee": {
            "receiver": "张三丰",
            "phone": "13888888888",
            "address": {
                "province": 1491,
                "city": 1492,
                "area": 1493,
                "detail": "宇宙中心太阳系小区88栋楼8单元808室"
            }
        }
    }
}

功能说明#