文档
测试

30.1 员工白名单下发

POST
syncCustomers

接口描述

用于脱机模式,员工白名单同步,下发数据;请求参数lastSyncDate为最后同步的时间戳,首次同步传0,0将会全量同步,非0将增量同步,即此时间戳后变更(增删改)的员工数据将下发

请求参数

参数名
类型
描述
必填
token
String
登录TOKEN
必填
appid
String
商户appid
必填
lastSyncDate
Long
最后同步的时间戳,首次同步传0,0将会全量同步,非0将增量同步
必填
current_page
int
页数,即第几页,默认1
必填
page_size
int
每页记录条数,默认500
必填

响应参数

参数名
类型
描述
必填
code
int
错误码,成功返回 200,失败返回其它
必填
message
String
错误描述
必填
data
Object
业务响应数据
必填
customer_list
Array
会员(员工)白名单数组,重要字段详见下方文档
必填
可选
customer_sn
String
会员芯片ID,就是刷卡取到的,会员的唯一识别。
必填
enabled
int
会员状态:1使用中,0挂失,-1注销
必填
del_flag
int
删除标识:0未删除正常可用,1已删除,白名单同步下发时,如果已删除,本地数据要处理。
必填
last_sync_date
Long
本次同步时间戳:下次增量同步时传入
必填
is_complete
int
是否取完:当为1时已取完,不需要再翻页,如果为0,需要进一步翻页
必填

说明 / 示例

### 请求示例 ``` https://api3-test.poslite.cn/cm/syncCustomers?token=16F4BE59741BB82A664D26A9E36BECF8&appid=jb8ca19c66039e56f0&lastSyncDate=0&current_page=1&page_size=10 ``` ### 返回示例 #### 请求成功返回 JSON ``` { "code": 200, "message": "success", } ``` ##### 业务成功返回 JSON ``` { "code": 200, "message": "success", "data": { "result_msg": "ok", "last_sync_date": 1716272524492, "customer_list": [ { "del_flag": 0, "phone_number": "19914501543", "customer_name": "姚大吊", "customer_sn": "19914501543", "customer_id": 32098, "enabled": 1 }, { "del_flag": 0, "phone_number": "18233334444", "customer_name": "1122", "customer_sn": "4181011606", "customer_id": 32016, "enabled": 1 }, { "del_flag": 0, "phone_number": "18598717391", "customer_name": "sy2", "customer_sn": "18598717391", "customer_id": 32185, "enabled": 1 }, { "del_flag": 0, "phone_number": "17721314411", "customer_name": "测试密码", "customer_sn": "17721314411", "customer_id": 32169, "enabled": 1 }, { "del_flag": 0, "phone_number": "17359287910", "customer_name": "FANDY", "customer_sn": "3487337281", "customer_id": 32087, "enabled": 1 }, { "del_flag": 0, "phone_number": "18598717392", "customer_name": "sy", "customer_sn": "18598717392", "customer_id": 32184, "enabled": 1 }, { "del_flag": 0, "phone_number": "17375260550", "customer_name": "laughing", "customer_sn": "17375260550", "customer_id": 32183, "enabled": 1 }, { "del_flag": 0, "phone_number": "19155225657", "customer_name": "静静", "customer_sn": "11", "customer_id": 32175, "enabled": 1 }, { "del_flag": 0, "phone_number": "15056394606", "customer_name": "欣欣子", "customer_sn": "123", "customer_id": 32176, "enabled": 1 }, { "del_flag": 0, "phone_number": "15056394606", "customer_name": "家欣", "customer_sn": "123456", "customer_id": 32010, "enabled": -1 } ], "result_code": "success", "is_complete": 0 } } ``` ##### 返回会员对象(员工对象)重要字段 JSON ``` { "customer_sn": "3429593549", "enabled": 1, "del_flag":0, "customer_id": 1234, "customer_name": "张三, "phone_number": "13022229999" } ``` **说明** ==会员卡芯片号customer_sn、会员状态enabled、删除标识del_flag必下发== - customer_sn:必下发,会员卡芯片号,脱机刷卡获取的就是这个,用来表示唯一的会员(员工),必下发 - enabled:必下发,会员状态,1正常可用,0挂失,-1注销 - del_flag:必下发,删除标记,1已删除,本地白名单需要处理,不用刷卡;0正常 ==会员ID customer_id、会员名customer_name、手机号phone_number 非必下发,预售备用== ##### 业务失败返回 JSON ``` { "code": 200, "message": "success", "data":{ "result_code":"fail", "result_msg": "失败原因" } } ``` #### 请求失败返回 ``` "code": 1503, "message": "business.error.outlet.in.session", "data": "" } ``` ==business.error.outlet.in.session== 门店APPID错误