线上小程序-ERP

ERP更新线上小程序上的商品、价格、库存;销售订单的SN码;会员积分,基本信息,申请发票及获取发票,获取优惠券。


顾客创建订单

<p><strong>简要描述:</strong> </p> <ul> <li>在顾客购买商品或者退货产生订单时,调用该接口</li> <li>1.方案A同步串行(小程序创建订单时就要和ERP联动,ERP锁定SN码并返回给小程序, 这样可以保证该订单的库存和SN码有效性):该接口返回成功后,才能说明该订单在小程序有效。</li> <li>2.方案B异步并行(小程序创建订单后推送给ERP,订单付款时需检查商品是否有SN码,没有需再调【获取订单附加信息】接口获取SN码, 有几率存在订单创建没问题,付款的时候会库存不足):该接口无论是否返回成功,不影响该订单的后续操作。</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://moa.58lz.com:803/api/OGBAPP/sellord?mode=CRT&amp;amp;client_secret=*******</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <p>输入参数结构 等同【订单查询】API输出的订单详情参数结构 </p> <p><strong>请求示例</strong></p> <pre><code>{                 &amp;quot;id&amp;quot;: 7,                 &amp;quot;order_pay_id&amp;quot;: 8,                 &amp;quot;order_number&amp;quot;: &amp;quot;2511051835178790&amp;quot;,                 &amp;quot;merchant_id&amp;quot;: 1,                 &amp;quot;member_id&amp;quot;: 29,                 &amp;quot;integral&amp;quot;: 0,                 &amp;quot;integral_price&amp;quot;: 0,                 &amp;quot;platform_coupon_id&amp;quot;: null,                 &amp;quot;platform_member_coupon_id&amp;quot;: null,                 &amp;quot;platform_coupon_price&amp;quot;: 0,                 &amp;quot;merchant_coupon_id&amp;quot;: null,                 &amp;quot;merchant_member_coupon_id&amp;quot;: null,                 &amp;quot;merchant_coupon_price&amp;quot;: 0,                 &amp;quot;member_address_id&amp;quot;: null,                 &amp;quot;member_address_data&amp;quot;: null,                 &amp;quot;store_id&amp;quot;: 1,                 &amp;quot;store_data&amp;quot;: {                     &amp;quot;id&amp;quot;: 1,                     &amp;quot;lat&amp;quot;: 45.809398,                     &amp;quot;lng&amp;quot;: 126.537116,                     &amp;quot;code&amp;quot;: &amp;quot;10010&amp;quot;,                     &amp;quot;name&amp;quot;: &amp;quot;100H1236 万象汇店&amp;quot;,                     &amp;quot;sort&amp;quot;: 0,                     &amp;quot;enable&amp;quot;: true,                     &amp;quot;address&amp;quot;: &amp;quot;哈尔滨市松北区世茂大道555号万象汇(哈尔滨店)&amp;quot;,                     &amp;quot;area_id&amp;quot;: 230109,                     &amp;quot;city_id&amp;quot;: 230100,                     &amp;quot;contact&amp;quot;: &amp;quot;13633663366&amp;quot;,                     &amp;quot;work_time&amp;quot;: &amp;quot;09:00-20:00&amp;quot;,                     &amp;quot;created_at&amp;quot;: &amp;quot;2025-11-05 17:26:46&amp;quot;,                     &amp;quot;updated_at&amp;quot;: &amp;quot;2025-11-05 17:26:46&amp;quot;,                     &amp;quot;province_id&amp;quot;: 230000                 },                 &amp;quot;take_data&amp;quot;: {                     &amp;quot;mark&amp;quot;: &amp;quot;测试&amp;quot;,                     &amp;quot;phone&amp;quot;: &amp;quot;18746008422&amp;quot;,                     &amp;quot;contact&amp;quot;: &amp;quot;李李李&amp;quot;                 },                 &amp;quot;write_off_code&amp;quot;: &amp;quot;2511051835179377&amp;quot;,                 &amp;quot;remark&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;merchant_remark&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;status&amp;quot;: &amp;quot;done&amp;quot;,                 &amp;quot;price_goods&amp;quot;: 0.02,                 &amp;quot;price_delivery&amp;quot;: 0,                 &amp;quot;price_discount_total&amp;quot;: 0,                 &amp;quot;price_discount_platform&amp;quot;: 0,                 &amp;quot;price_discount_merchant&amp;quot;: 0,                 &amp;quot;price_total&amp;quot;: 0.02,                 &amp;quot;total_weight&amp;quot;: 1,                 &amp;quot;total_size&amp;quot;: 1.5,                 &amp;quot;total_num&amp;quot;: 1,                 &amp;quot;remain_price&amp;quot;: 0.02,                 &amp;quot;remain_num&amp;quot;: 1,                 &amp;quot;cancel_at&amp;quot;: null,                 &amp;quot;write_off_member&amp;quot;: &amp;quot;张珊珊&amp;quot;,                 &amp;quot;write_off_at&amp;quot;: &amp;quot;2025-11-05 18:35:52&amp;quot;,                 &amp;quot;receive_at&amp;quot;: null,                 &amp;quot;done_at&amp;quot;: null,                 &amp;quot;close_at&amp;quot;: null,                 &amp;quot;auto_close_at&amp;quot;: &amp;quot;2025-11-05 18:45:17&amp;quot;,                 &amp;quot;after_sales_expire_at&amp;quot;: null,                 &amp;quot;refund_price&amp;quot;: 0,                 &amp;quot;refund_delivery&amp;quot;: false,                 &amp;quot;delivery_company&amp;quot;: null,                 &amp;quot;delivery_number&amp;quot;: null,                 &amp;quot;delivery_remark&amp;quot;: null,                 &amp;quot;created_at&amp;quot;: &amp;quot;2025-11-05 18:35:17&amp;quot;,                 &amp;quot;updated_at&amp;quot;: &amp;quot;2025-11-05 18:36:15&amp;quot;,                 &amp;quot;order_pay&amp;quot;: {                     &amp;quot;id&amp;quot;: 8,                     &amp;quot;order_number&amp;quot;: &amp;quot;2511051835179288&amp;quot;,                     &amp;quot;price&amp;quot;: &amp;quot;0.02&amp;quot;,                     &amp;quot;pay_method&amp;quot;: &amp;quot;member_balance&amp;quot;,                     &amp;quot;transaction_id&amp;quot;: &amp;quot;2511051835191789&amp;quot;,                     &amp;quot;pay_price&amp;quot;: &amp;quot;0.02&amp;quot;,                     &amp;quot;was_pay&amp;quot;: true,                     &amp;quot;pay_at&amp;quot;: &amp;quot;2025-11-05 18:35:19&amp;quot;,                     &amp;quot;created_at&amp;quot;: &amp;quot;2025-11-05 18:35:17&amp;quot;,                     &amp;quot;updated_at&amp;quot;: &amp;quot;2025-11-05 18:35:19&amp;quot;                 },                 &amp;quot;order_goods&amp;quot;: [                     {                         &amp;quot;id&amp;quot;: 7,                         &amp;quot;order_id&amp;quot;: 7,                         &amp;quot;member_id&amp;quot;: 29,                         &amp;quot;merchant_id&amp;quot;: 1,                         &amp;quot;goods_id&amp;quot;: 1,                         &amp;quot;cart_id&amp;quot;: null,                         &amp;quot;integral&amp;quot;: 0,                         &amp;quot;integral_price&amp;quot;: 0,                         &amp;quot;platform_coupon_id&amp;quot;: null,                         &amp;quot;platform_member_coupon_id&amp;quot;: null,                         &amp;quot;platform_coupon_price&amp;quot;: 0,                         &amp;quot;merchant_coupon_id&amp;quot;: null,                         &amp;quot;merchant_member_coupon_id&amp;quot;: null,                         &amp;quot;merchant_coupon_price&amp;quot;: 0,                         &amp;quot;goods_name&amp;quot;: &amp;quot;HUAWEI POCKET2 优享版&amp;quot;,                         &amp;quot;attr_type&amp;quot;: &amp;quot;multi&amp;quot;,                         &amp;quot;attr_data&amp;quot;: {                             &amp;quot;key&amp;quot;: &amp;quot;8Gú128G&amp;quot;,                             &amp;quot;code&amp;quot;: &amp;quot;&amp;quot;,                             &amp;quot;cost&amp;quot;: 1,                             &amp;quot;name&amp;quot;: &amp;quot;8G,128G&amp;quot;,                             &amp;quot;size&amp;quot;: 1.5,                             &amp;quot;price&amp;quot;: 0.02,                             &amp;quot;stock&amp;quot;: 100,                             &amp;quot;weight&amp;quot;: 1,                             &amp;quot;name_arr&amp;quot;: [                                 &amp;quot;8G&amp;quot;,                                 &amp;quot;128G&amp;quot;                             ],                             &amp;quot;shop_price&amp;quot;: 1,                             &amp;quot;primary_image&amp;quot;: &amp;quot;/upload/ba/ba174871ed7b5a4bb3f4dda35cb65dc6_n.png&amp;quot;                         },                         &amp;quot;price&amp;quot;: 0.02,                         &amp;quot;num&amp;quot;: 1,                         &amp;quot;weight&amp;quot;: &amp;quot;1.00&amp;quot;,                         &amp;quot;size&amp;quot;: &amp;quot;1.50&amp;quot;,                         &amp;quot;price_discount&amp;quot;: &amp;quot;0.00&amp;quot;,                         &amp;quot;price_discount_merchant&amp;quot;: &amp;quot;0.00&amp;quot;,                         &amp;quot;price_discount_platform&amp;quot;: &amp;quot;0.00&amp;quot;,                         &amp;quot;price_refund&amp;quot;: &amp;quot;0.00&amp;quot;,                         &amp;quot;remain_price&amp;quot;: &amp;quot;0.02&amp;quot;,                         &amp;quot;remain_num&amp;quot;: 1,                         &amp;quot;custom_message&amp;quot;: [],                         &amp;quot;was_evaluate&amp;quot;: true,                         &amp;quot;was_refund&amp;quot;: false,                         &amp;quot;request_refund&amp;quot;: false,                         &amp;quot;created_at&amp;quot;: &amp;quot;2025-11-05 18:35:17&amp;quot;,                         &amp;quot;updated_at&amp;quot;: &amp;quot;2025-11-05 18:36:15&amp;quot;                     }                 ],                 &amp;quot;member&amp;quot;: {                     &amp;quot;id&amp;quot;: 29,                     &amp;quot;id_applet_wechat&amp;quot;: &amp;quot;oo3XU5GWpNmbryWhL-wRDr0mNPgA&amp;quot;,                     &amp;quot;nickname&amp;quot;: &amp;quot;超级无敌小花花&amp;quot;,                     &amp;quot;avatar&amp;quot;: &amp;quot;/upload/9e/9e62ffae8fe1ce6ca03abcd6cee3806b_n.jpeg&amp;quot;,                     &amp;quot;phone&amp;quot;: &amp;quot;18746008422&amp;quot;,                     &amp;quot;type&amp;quot;: &amp;quot;worker&amp;quot;,                     &amp;quot;country_code&amp;quot;: &amp;quot;86&amp;quot;,                     &amp;quot;enable&amp;quot;: true,                     &amp;quot;collect_num_goods&amp;quot;: 0,                     &amp;quot;collect_num_store&amp;quot;: 0,                     &amp;quot;history_num&amp;quot;: 0,                     &amp;quot;integral&amp;quot;: 0,                     &amp;quot;integral_locked&amp;quot;: 0,                     &amp;quot;balance&amp;quot;: 9600.95,                     &amp;quot;real_name&amp;quot;: &amp;quot;李李李&amp;quot;,                     &amp;quot;id_card&amp;quot;: &amp;quot;230121199503255824&amp;quot;,                     &amp;quot;remark&amp;quot;: null,                     &amp;quot;vip_expired_at&amp;quot;: &amp;quot;2026-11-05 23:59:59&amp;quot;,                     &amp;quot;created_at&amp;quot;: &amp;quot;2025-08-22 18:45:00&amp;quot;,                     &amp;quot;updated_at&amp;quot;: &amp;quot;2025-11-11 11:37:46&amp;quot;                 },                 &amp;quot;settle_distribution&amp;quot;: []             }</code></pre> <p><strong>返回示例</strong></p> <pre><code> { &amp;quot;revcode&amp;quot;: 0, &amp;quot;revmsg&amp;quot;: &amp;quot;ok&amp;quot; &amp;quot;revobj&amp;quot;:{ &amp;quot;ordno&amp;quot;:&amp;quot;2511051835179288&amp;quot;, &amp;quot;7&amp;quot;:{&amp;quot;barcode&amp;quot;:&amp;quot;6945654322&amp;quot;,&amp;quot;sn&amp;quot;:&amp;quot;4555/55335&amp;quot;} } }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">revcode</td> <td style="text-align: left;">int</td> <td>0成功,非0失败错误编码</td> </tr> <tr> <td style="text-align: left;">revmsg</td> <td style="text-align: left;">string</td> <td>返回提示词</td> </tr> <tr> <td style="text-align: left;">revobj</td> <td style="text-align: left;">json</td> <td>显示具体返回内容</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;lfloor; ordno</td> <td style="text-align: left;">string</td> <td>调用该接口传入的订单号</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;lfloor; ordempphone</td> <td style="text-align: left;">string</td> <td>订单自提时返回(如果没有,则取自提网点信息),自提联系人员手机号</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;lfloor; ordempname</td> <td style="text-align: left;">string</td> <td>订单自提时返回(如果没有,则取自提网点信息),自提联系人员名称</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;lfloor; key</td> <td style="text-align: left;">json</td> <td>key是订单order_goods的ID</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lfloor;&amp;lfloor; barcode</td> <td style="text-align: left;">string</td> <td>商品69条码</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lfloor;&amp;lfloor; IMEI</td> <td style="text-align: left;">string</td> <td>手机串码</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lfloor;&amp;lfloor; SN</td> <td style="text-align: left;">string</td> <td>商品SN码</td> </tr> <tr> <td style="text-align: left;">&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lfloor;&amp;lfloor; errmsg</td> <td style="text-align: left;">string</td> <td>revcode属于6100-6199时,会显示商品明细行的错误描述(例如 revcode=6101时,这个errmsg提示为库存不足)</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML