### 使用描述 實物商品下單前，通過此接口預先鎖定商品庫存，請參考[實物商品對接流程](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&timestamp=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" } ~~~