### 使用描述
实物商品下单前，通过此接口预先锁定商品库存，请参考[实物商品对接流程](https://duobaoyu.com.cn/documentcenter?onlyFlag=5f6844f2b84e16c396ad5bb44b91c50d)，如果是虚拟商品下单，请使用[虚拟商品预下单](https://duobaoyu.com.cn/documentcenter?onlyFlag=72dc53a8dcdd4d637ac9032506580696)
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E6%96%B9%E6%B3%95%E5%90%8D)方法名
dby.scm.order.submit
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E7%BD%91%E5%85%B3%E5%9C%B0%E5%9D%80)网关地址
| 环境 | 地址 | 请求方式 |
| --- | --- | --- |
| 生产环境 | `https://openapi.duobaoyu.com.cn/open/api` | post+json |
| 测试环境 | `https://openapi.duobaoyu88.cn/open/api` | post+json |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E5%85%AC%E5%85%B1query%E5%8F%82%E6%95%B0)公共Query参数
* * *
| 名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| method | String | 是 | 方法名称 |
| sign | String | 是 | [签名](签名规则.md) |
| timestamp | String | 是 | 时间戳,格式为13位,例如:1670223623000 |
| version | String | 是 | 版本号,现固定为v1 |
| appKey | String | 是 | 申请的应用appKey |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)业务Body参数(application/json)
* * *
| 名称 | 类型 | 必填 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| tradeNo | java.lang.String | 是 | 123456789 | 交易单号(少于50字符)每次请求确保唯一性 |
| consigneeProvinceCode | java.lang.String | 是 | 42 | 收货地址省ID |
| consigneeCityCode | java.lang.String | 是 | 4201 | 收货地址城市ID |
| consigneeCountyCode | java.lang.String | 是 | 420106 | 收货地址区县ID |
| consigneeTownCode | java.lang.String | 是 | 420106010 | 收货地址乡镇ID |
| consigneeAddress | java.lang.String | 是 | 安腾国际 | 收货详细地址，最多100个字符 |
| consigneeName | java.lang.String | 是 | 张三 | 收货人姓名 |
| consigneeMobile | java.lang.String | 是 | 16866668888 | 收货人手机号 |
| orderRemark | java.lang.String | 否 | 巴拉巴拉 | 订单备注 |
| skuInfos | java.util.List | 是 | | 商品信息 |
| ├─skuCode | java.lang.String | 是 | 210001 | SKU编号 |
| ├─skuNum | java.lang.Integer | 是 | 3 | 购买数量 |
| ├─unitPrice | java.lang.Long | 否 | 1250 | 商品成本单价`分`(传值时会校验传入价格和商品当前价格是否相等：如果相等就会扣除商户对应价格的预存款,如果价格不相等，下单失败。建议必传) |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0)响应参数
* * *
| 名称 | 类型 | 示例值 | 描述 |
| --- | --- | --- | --- |
| code | java.lang.String | 0 | 业务编码处理结果编码 |
| msg | java.lang.String | 请求成功 | 业务处理结果结果说明 |
| data | java.lang.Object | | 响应结果 |
| ├─tradeNo | java.lang.String | 123456789 | 交易单号,长度最大50 |
| ├─dbyOrderId | java.lang.String | 223456789 | 聚合供应链订单号 |
| ├─totalGoodsAmount | java.lang.Long | 3750 | 订单商品总额,单位`分` |
| ├─totalFreightAmount | java.lang.Long | 600 | 订单运费总额,单位`分` |
| ├─skuInfos | java.util.List | | 商品信息 |
| ├─skuCode | java.lang.String | 210001 | sku编码 |
| ├─skuNum | java.lang.String | 3 | 商品数量 |
| ├─unitPrice | java.lang.Long | 1250 | 商品单价`分` |
| msgId | java.lang.String | efd7f07011124adf | 消息id |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)请求示例
curljavaphp
~~~json
curl -XPOST -H "Content-type: application/json" -d '{
"tradeNo": "123",
"consigneeName": "张三",
"consigneeMobile": "15976688867",
"consigneeProvinceCode": "42",
"consigneeCityCode": "4201",
"consigneeCountyCode": "420106",
"consigneeTownCode": "420106010",
"consigneeAddress": "安腾国际",
"orderRemark": "",
"skuInfos": [
{
"skuCode": "50140911611",
"skuNum": 1,
"unitPrice": 7560
}
]
}' 'http://xxxxx/open/api?method=dby.scm.order.submit&version=v1&appKey=your appKey×tamp=1670057525000&sign=123'
~~~
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B)响应示例
~~~json
{
"code": "0",
"msg": "请求成功",
"data": {
"tradeNo": "1BEc82c1-eaAF-89ed-549D-9D3e33Cb49bb",
"dbyOrderId": "1411599691436717113344",
"totalGoodsAmount": 7560,
"totalFreightAmount": 600,
"skuInfos": [
{
"skuCode": "50140911611",
"skuNum": 1,
"unitPrice": 7560
}
]
},
"msgId": "c98195bed06842b4",
"success": true
}
~~~
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=875e160aca4b9cf2ad3db2f800acbf60#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)异常示例
~~~json
{
"code": "1",
"msg": "请求失败",
"data": null,
"msgId": "efd7f07011124adf"
}
~~~
- 产品介绍
- 开发指南
- 实物商品对接流程
- 签名规则
- JAVA SDK使用
- PHP SDK使用
- 商品消息对接流程
- 虚拟商品对接流程
- 电影H5对接流程
- 卡密信息解密规范
- 错误码查询
- 商品API文档
- 商品
- 查询商品SPU详情
- 查询商品SPU深度分页
- 查询商品可售性
- 手机号所属运营商查询
- 查询商品详情
- 查询商户商品上下架状态
- 查询商品最小起订量
- 查询商品价格
- 根据SKU查询商品SPU详情
- 查询商品分类逐级获取
- 查询商品分类分页获取
- 订单
- 运费评估
- 确认收货
- 查询订单物流信息
- 查询订单详情
- 取消订单
- 确认下单
- 实物商品预下单
- 虚拟商品预下单
- 售后
- 查询售后退款详情
- 查询售后订单详情
- 取消售后申请
- 确认售后完成
- 提交运单信息
- 查询售后支持的物流
- 查询客户寄回地址
- 创建退款退货申请
- 上传商品售后凭证
- 批量查询商品售后权益
- 地址
- 详细地址转换成供应链地址编码
- 省市区街道4级地址查询
- 消息
- 消息通知
- 账户
- 查询商户账户信息
- 电影API文档
- 电影H5
- 电影H5首页免登录
- 设置商户价格策略
- 设置商户货币兑换比例
- H5电影订单详情
- H5电影订单确认
- H5电影订单列表
- 电影消息
- 电影消息通知