修改日志 2021-05
# 2021-05-01
### 原 order/cart 接口变更
==1.增加返回字段 [data/hang_count]==
`hang_count: 可取值为0或正整数，用于返回挂单数量`
# 2021-06-10
### 原 order/pay 接口变更
==1.入口字段 [operate] 的含义发生变更==
> ~~`[operate=400]: 临时增加，`
`operate=400(这个400是新增的值，专门用来处理这个场景)`
`code=享钱服务器返回的线上支付订单号`
`amount=0`~~
`[operate=400] 该项取值是上一版本的临时产物，新版本中已经去除(移动支付回归到正常流程)`
==1.移除3个返回字段 [data/xdd_xxx]==
> ~~`[xdd_flag] 临时字段（1:需要前端进行享钱支付/其它值:无意义）`
`[xdd_order_id] 临时字段（线下订单号[销售小票号]）`
`[xdd_amt] 临时字段（要支付的金额[两位小数]）`~~
`这三个字段是上一版本的临时产物，新版本中已经去除(移动支付回归到正常流程)`
# 2021-06-23
### 原 order/pay 接口变更
==1.增加返回字段 [data/list/pay_order]==
`pay_order: 支付订单号（支付平台订单号）`
### 程序启动时增加命令行参数
`启动程序时需要传入参数，原来在login接口中传入的参数，比如设备id/机器名等，全部改在命令行参数中(组合成一个json字符串传入)`
==1.Android平台==
`原来的启动命令为：./kpossrv`
`新的启动示例：./kpossrv[空格]'{"product_id":"Retail-Android","product_name":"零售Android版","product_version":"1.0.3","host_name":"KM8084","device_id":"25DE2C192F6AE626D44E21D670BD0F9D1648A874","host_mac":"0C:25:76:10:7B:CA","host_ip":"192.168.214.11","screen_width":"1920","screen_height":"1080","device_type": "Android POS","device_model":"商米S02","data_path":"/Users/gardonzou/Documents/golang/pos","port":"9090"}'`
==1.Windows平台==
`原来的启动命令为：run kpossrv.win32.exe.`
`新的启动示例：run kpossrv.win32.exe[空格]'{"product_id":"Retail-Android","product_name":"零售Android版","product_version":"1.0.3","host_name":"KM8084","device_id":"25DE2C192F6AE626D44E21D670BD0F9D1648A874","host_mac":"0C:25:76:10:7B:CA","host_ip":"192.168.214.11","screen_width":"1920","screen_height":"1080","device_type": "Android POS","device_model":"商米S02","data_path":"/Users/gardonzou/Documents/golang/pos","port":"9090"}'`
### 原 user/login 接口变更
`入参和出参都有变化，仔细查看login接口的参数定义`
==1.去除多个入口参数字段==
`仅保留以下2个字段，其它字段全部作为run命令的参数传入`
`[account]`
`[password]`
==2.去除[data/user]中2个返回字段==
~~`[user_id]`~~
~~`[branch_id]`~~
==3.变更[data/user]中1个返回字段的命名==
`[company_id]变更为[company_code]`
### 原 user/heartbeat 接口变更
==1.去除返回字段 [data/sync_status]==
~~`sync_status: 是否正在进行数据同步（0/1）`~~
`该字段原本作用是用来判断程序当前是否处于数据同步过程中。对于登录时进行的数据同步的进度信息，由[user/heartbeat]的返回字段[data/login_rate][data/login_msg]替代；对于系统运行过程中的数据同步，由possrv静默处理，不需要反应到前端`
==2.增加3个返回字段==
`registered: 当前pos机是否已注册(0/1)（未注册则需要首先调用register接口，否则在login接口中会提示pos机尚未注册的错误信息）`
`login_rate: 登录进度（0-100）（登录过程包括：登录认证，数据同步，本地数据加载等一系列步骤。此字段初初始值为0，当用户在登录界面点击确定时调用login接口，此字段从0-100开始变化，当这些所有登录步骤完成后，此字段变成100，代表系统可以进入主界面等待用户操作了）`
`login_msg: 登录信息提示（配合login_rate显示提示信息）`
### 增加新接口 user/register
`前端程序在启动后，首先调用[heartbeat]接口，通过返回字段[data/registered]来判断本机是否已经注册，如果返回值为[0]表示未注册，则需要先调用[user/register]接口进行注册`