文档
测试

30.2 订单批量上传【暂不使用】

POST
syncSaleOrders

接口描述

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

请求参数

参数名
类型
描述
必填
token
String
登录TOKEN
必填
appid
String
商户appid
必填
data
Arrray
订单数组:脱机订单数据,重要字段如下
可选
sale_order_type
int
脱机订单类型:0消费订单,1退款订单,默认为0
必填
sale_date
DateTime
交易时间,格式:yyyy-MM-dd HH:mm:ss
必填
sale_order_no
String
订单号,毫秒级时间戳+5位随机数字构成,如171574501784950652,必须唯一
必填
customer_sn
String
刷卡的会员卡芯片ID
必填
total_amount
Double
交易金额,单位为元,最多保留两位小数点
必填
employee_id
Long
本订单收银员ID
必填
start_date
DateTime
脱机订单的开始时间,格式:yyyy-MM-dd HH:mm:ss,可以传入脱机订单数据里最早的一个订单的交易时间
必填
end_date
DateTime
脱机订单的开始时间,格式:yyyy-MM-dd HH:mm:ss,可以传入脱机订单数据里最新的一个订单的交易时间
必填

响应参数

参数名
类型
描述
必填
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/syncSaleOrders?token=TOKEN&appid=jb25112e65f20e7dfe&data=[...]&start_date=xxx&end_date=yyy ``` ### 返回示例 #### 请求成功返回 JSON ``` { "code": 200, "message": "success", } ``` ##### 业务成功返回 JSON ``` { "code": 200, "message": "success", "data":{ "result_code":"success", "result_msg": "ok", "succ_count": 50, "fail_count": 1 "error_count": 0 } } ``` ##### 上传的订单对象重要字段 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 } ``` ==**说明**== - sale_order_type:订单类型,0为消费订单,1为退款单,默认为0 - sale_date:交易时间,格式:yyyy-MM-dd HH:mm:ss - sale_order_no:订单号,在订单数据里必须唯一,格式:毫秒级时间戳+5位随机数字 - customer_sn:刷卡员工的会员卡芯片ID,在白名单内要存在 - total_amount:交易金额,单位为元,最多保留两位小数点 - employee_id:本订单的收银员ID ##### 业务失败返回 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错误