大麦城积分商城

大麦城积分商城


提交实物订单

<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&amp;alladdress=北京市北京市东城区东华门街道哇哇哇&amp;city=北京市&amp;consignee=金&amp;district=东城区&amp;goods_info={"103988":{"good_id":"103988","number":1,"use_jifen":100}}&amp;kehuid=31&amp;mobile=18072128027&amp;order_sn=20190218133810001341&amp;order_status=1&amp;province=北京市&amp;useraccount=20181222000697010018010000010&amp;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 =&gt; 失败 0 =&gt; 失败 1 =&gt; 成功 3 =&gt; 商品不存在 4 =&gt; 该商品为虚拟商品,请调用虚拟订单接口 5 =&gt; 该商品没有推荐或已经下架,请联系客服 6 =&gt; 库存不足 7 =&gt; 客户订单号已经存在,不能重复插入</p>

页面列表

ITEM_HTML