提交实物订单
<p><strong>简要描述:</strong></p>
<ul>
<li>订单信息提交</li>
</ul>
<p><strong>请求URL:</strong></p>
<ul>
<li><code>http://www.test.damaicheng.com/index.php?r=orderapi/addorder</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST</li>
<li>application/json</li>
</ul>
<p><strong>参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">kehuid</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">int</td>
<td>客户id</td>
</tr>
<tr>
<td style="text-align: left;">order_sn</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>客户方订单id</td>
</tr>
<tr>
<td style="text-align: left;">useraccount</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>下单用户id或名称</td>
</tr>
<tr>
<td style="text-align: left;">order_status</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">int</td>
<td>订单状态,1:已确认</td>
</tr>
<tr>
<td style="text-align: left;">consignee</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>收货人姓名</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>收货人电话</td>
</tr>
<tr>
<td style="text-align: left;">alladdress</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>详细收货地址(包括省市区字段)</td>
</tr>
<tr>
<td style="text-align: left;">goods_info</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">json/string</td>
<td>订单产品信息的json格式(也可以将转json字符串后的商品信息进行base64加密,注意签名中的参数goods_info也要保持同步)</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>签名,签名生成方式详见<a href="https://www.showdoc.cc/dmc?page_id=2665110292878346" title="这里">这里</a></td>
</tr>
<tr>
<td style="text-align: left;">ckehuid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>子账户id,如有子账户,子账户订单生成时必传此字段</td>
</tr>
<tr>
<td style="text-align: left;">code_buy</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>如是兑换码兑换,则传入兑换码,否则不用传此参数</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>省,例如‘河北省’、‘山东省’、''新疆维吾尔自治区</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>市,例如‘浙江市’、‘石家庄市’、‘阿里地区’</td>
</tr>
<tr>
<td style="text-align: left;">district</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>区/县,例如‘海淀区’、‘汶川县’、'察哈尔右翼前旗'</td>
</tr>
<tr>
<td style="text-align: left;">zipcode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>邮编</td>
</tr>
<tr>
<td style="text-align: left;">freight</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">float</td>
<td>该订单运费</td>
</tr>
<tr>
<td style="text-align: left;">postscript</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注信息</td>
</tr>
<tr>
<td style="text-align: left;">pay_status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>订单付款状态,默认2已付款,0未付款,1付款中</td>
</tr>
<tr>
<td style="text-align: left;">is_kehuowngood</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>客户自有商品标识,默认为0非自有,如是自有商品订单,请传入客户id</td>
</tr>
</tbody>
</table>
<p><strong>goods_info格式</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">good_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>大麦城商品ID</td>
</tr>
<tr>
<td style="text-align: left;">number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商品数量</td>
</tr>
<tr>
<td style="text-align: left;">goods_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">use_jifen</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>商品积分价格</td>
</tr>
</tbody>
</table>
<pre><code>{
"100089":{
"good_id":100089,
"good_name":"abcd", //可不传,以大麦城为准
"number":2, //数量
"use_jifen ":20,
},
"100090":{
"good_id":100090,
"good_name":"1234", //可不传,以大麦城为准
"number":2,
"use_jifen ":20,
}
}</code></pre>
<p><strong>请求示例</strong></p>
<pre><code>{"sign":"A321E14233894219D05ED2752CCECFEB","consignee":"\u6d4b\u8bd5\u7528\u6237","postscript":"","zipcode":"","order_sn":"201608101000002","goods_info":{"100089":{"good_id":100089,"good_name":"","number":1,"shop_price":"","use_jifen":1}},"useraccount":"","order_status":1,"alladdress":"\u6d59\u6c5f\u7701\u676d\u5dde\u5e02\u6ee8\u6c5f\u533a\u7a0e\u53cb\u5927\u53a61001","mobile":"13567433561","kehuid":31}</code></pre>
<p><strong>最终post过去的数据</strong></p>
<pre><code>{"addtime":"2019-02-18 13:45:20","alladdress":"北京市北京市东城区东华门街道哇哇哇","city":"北京市","consignee":"金","district":"东城区","goods_info":{"103988":{"good_id":"103988","number":1,"use_jifen":100}},"kehuid":"31","mobile":"18072128027","order_sn":"20190218133810001341","order_status":"1","province":"北京市","sign":"EEE52881483405F9D3B4A37F28216B78","useraccount":"20181222000697010018010000010","zipcode":""}</code></pre>
<p><strong>加密前的字符串</strong></p>
<pre><code>5d2812b3093f8cc92c6f0051b869b46caddtime=2019-02-18 13:45:20&alladdress=北京市北京市东城区东华门街道哇哇哇&city=北京市&consignee=金&district=东城区&goods_info={"103988":{"good_id":"103988","number":1,"use_jifen":100}}&kehuid=31&mobile=18072128027&order_sn=20190218133810001341&order_status=1&province=北京市&useraccount=20181222000697010018010000010&zipcode=</code></pre>
<p><strong>最终的sign参数</strong></p>
<pre><code>EEE52881483405F9D3B4A37F28216B78</code></pre>
<p><strong>注意</strong></p>
<blockquote>
<p><strong>注:商品名称可能不定期有些小修改,最终以大麦城为准,good_id不会改变</strong></p>
</blockquote>
<p><strong>返回示例</strong></p>
<pre><code>{
"status": 0, //返回状态,1成功,0失败,不为1都可以认为失败,失败信息在message字段中返回
"order_id":R20190101100356589742, //大麦城订单号
"message": "订单不是未确认状态" //错误信息
}
</code></pre>
<p><strong>备注</strong></p>
<p>其他状态:
-1 => 失败
0 => 失败
1 => 成功
3 => 商品不存在
4 => 该商品为虚拟商品,请调用虚拟订单接口
5 => 该商品没有推荐或已经下架,请联系客服
6 => 库存不足
7 => 客户订单号已经存在,不能重复插入</p>