文档

测试

register（POS机注册）

websocket测试

POST

http://localhost:9090/api/v1/user/register

接口描述

程序初次启动时将POS机注册到后台系统中

请求参数

参数名

类型

描述

必填

server_type

string

后端系统类型（1:SaaS/2:ERP）

必填

server_name

string

服务器地址（server_type=1时为域名；server_type=2时为域名/IP:商品号）

必填

company_code

string

商户编码

必填

branch_code

string

门店编码

必填

pos_code

string

POS机编码（如果该值为空，则由服务器自动生成POS机号）

必填

auth_user_code

string

授权账号编码

必填

auth_user_password

string

授权账号密码

必填

is_force

string

是否强制注册新pos机号，当pos机已注册过的pos机编码和当前参数的pos机编码不一致时，经收银员确认后，强制注册新pos机号(0否，1是)

必填

响应参数

参数名

类型

描述

必填

code

string

状态码（0:成功/100:通道被占用/200:pos机已注册,需要提醒是否注册新pos机号其它值:错误）

必填

message

string

错误信息（仅在发生错误时有意义，code等于200时，错误信息exp 当前设备已注册Pos编码[892],是否需要重新注册新的Pos编码[896]

必填

data

json

json对象

必填

pos_code

string

注册成功后的POS机编码,code等于0有效

必填

说明 / 示例

### 入口参数 [scene] 定义 `该参数用来指明调用场景，可取值：` > `[1]:对接SaaS时进行POS机注册` `scene = 1` `server_name 无意义` `server_port 无意义` `company_code 必备参数` `branch_code 必备参数` `pos_code 可选，未指定该值则由服务器生成POS机号` > `[2]:对接ERP时进行POS机注册` `scene = 2` `server_name 必备参数` `server_port 必备参数` `company_code 必备参数` `branch_code 必备参数` `pos_code 可选，未指定该值则由服务器生成POS机号` > `[3]:重定向服务器（仅用于对接ERP的情况，用户的服务器环境可能发生变化，这种情况下POS机不需要重新注册，但是要重新指定服务器的地址和端口）` `scene = 3` `server_name 必备参数` `server_port 必备参数` `company_code 无意义` `branch_code 无意义` `pos_code 无意义` > `[其它值]:参数错误`

上一篇 needupgrade（是否升级）

nextDoc ping(注册服务器是否联通)