文档
测试

30.3 单个订单上传

POST
syncSaleOrder

接口描述

用于脱机模式,订单同步,上传脱机时间内的订单数据

请求参数

参数名
类型
描述
必填
token
String
登录TOKEN
必填
appid
String
商户appid
必填
sale_date
DateTime
交易时间,格式:yyyy-MM-dd HH:mm:ss
必填
sale_order_no
String
订单号,18位数字,秒级时间戳+流水号,如171627131600000003,必须保证在同一个设备下唯一
必填
customer_sn
String
刷卡的会员卡芯片ID
必填
total_amount
Double
交易金额,单位为元,最多保留两位小数点
必填
employee_id
Long
本订单收银员ID
必填
sn
String
设备SN
必填

响应参数

参数名
类型
描述
必填
code
int
错误码,成功返回 200,失败返回其它
必填
message
String
错误描述
必填
data
Object
业务响应数据
必填
result_code
String
业务码,上传同步成功,返回success
必填
result_msg
String
业务错误信息,业务成功时,为ok
必填
succ_count
int
成功条数:订单同步成功的笔数
必填
fail_count
int
失败条数:订单同步失败笔数,比如同步时会员已删除了
必填
error_count
int
错误条数:订单同步错误笔数,比如订单数据不完整,数据格式错误等
必填

说明 / 示例

### 请求示例 ``` https://api2.XXX.cn/cm/syncSaleOrder?token=TOKEN&appid=jb25112e65f20e7dfe ``` ### 返回示例 #### 请求成功返回 JSON ``` { "code": 200, "message": "success", } ``` ##### 上传的订单对象重要字段 JSON ``` { "sale_order_type": 0, "sale_date": "2024-05-20 15:30:25", "sale_order_no":"171574501784950652", "customer_sn": "23423400343", "total_amount": 12.00, "employee_id": 123, "sn": "E4629C78D7270930" } ``` ==**请求参数说明**== - sale_date:交易时间,格式:yyyy-MM-dd HH:mm:ss - sale_order_no:订单号,18位数字,在同一个设备下订单数据里必须唯一,格式:秒级时间戳+流水号 - customer_sn:刷卡员工的会员卡芯片ID,在白名单内要存在 - total_amount:交易金额,单位为元,最多保留两位小数点 - employee_id:本订单的收银员ID - sn:设备SN #### 请求失败返回 ``` "code": 1503, "message": "business.error.outlet.in.session", "data": "" } ``` ==business.error.outlet.in.session== 门店APPID错误