单据撤销
1、会员管理软件-系统维护-单据管理中的单据，都支持撤销;2、消费收银单据支持部分退货，其他单据只能全单撤销
请求地址(POST)
https://openapi.1card1.cn/OpenApi/ReturnGoods?openId=[OpenId]&signature=[Signature]×tamp=[TimeStamp]
| 字段 | 说明 |
|---|---|
| OpenId | 登陆开放平台生成的OpenId |
| Signature | 签名=md5(OpenId+Secret+Timestamp+data),格式:32位md5大写加密 |
| TimeStamp | 发起请求的时间戳,查看标准timestamp |
请求说明
data={"userAccount":"10000","billNumber":"XF20160812000006","returnMoney":"9.9", "meno":"","returnItems":[{"ReturnNumber":1,"GoodsItemGuid":"17acd061-fe55-e611-a1d6-7c0507895043","Guid":"cc98a421-2c60-e611-881c-7c0507895043"}]}
或者
data={"userAccount":"10000","orderNo":"2019102800000009","returnMoney":"9.9", "meno":"","returnItems":[{"ReturnNumber":1,"GoodsItemGuid":"17acd061-fe55-e611-a1d6-7c0507895043","Guid":"cc98a421-2c60-e611-881c-7c0507895043"}]}
或者
data={"userAccount":"10000","thirdTradeNo":"9000259732120002","returnMoney":"9.9", "meno":"","returnItems":[{"ReturnNumber":1,"GoodsItemGuid":"17acd061-fe55-e611-a1d6-7c0507895043","Guid":"cc98a421-2c60-e611-881c-7c0507895043"}]}
| 字段 | 是否必须 | 说明 |
|---|---|---|
| userAccount | 是 | 工号 |
| billNumber | 否 |
业务单据号(共16位，以XF,或者CZ开头的,后面跟14位数字)
billNumber、orderNo、thirdTradeNo 不能同时为空,优先取orderNo |
| orderNo | 否 |
移动支付订单号(14位数字，取自“B扫C”返回的orderNo)
billNumber、orderNo、thirdTradeNo 不能同时为空,优先取orderNo |
| thirdTradeNo | 否 |
微信、支付宝账单详情页面的商家订单号（可以扫条码获得）
billNumber、orderNo、thirdTradeNo 不能同时为空,优先取orderNo |
| meno | 是 | 备注 |
| returnItems | 否 | 退货明细（仅对消费收银单据有效。Json格式数组，ReturnNumber：此次退货数量;GoodsItemGuid：退货商品唯一标识，通过“获取消费明细”获得GoodsItemGuid字段;Guid：单据明细唯一标识,通过“获取消费明细”获得Guid字段） |
| returnMoney | 否 |
退款金额，仅当该单据为快速消费单据、无商品的自助买单单据时，此字段有效
不能大于“B扫C”接口传入的totalFee(支付金额) |
返回说明
成功时返回：
{"status":0,"message":"撤销成功！","billNumber":"TH20140524000015", "consumeBillNumber":"XF20160812000006","availablePoint":999,"availableValue":888, "refundMessage":"退款中", "refundStatus":"2020032000000016", "refundStatus":"0", }
失败时返回：
{"status":-1,"message":"单据撤销失败及原因"}
| 字段 | 是否必须 | 说明 |
|---|---|---|
| status | 是 | 状态(0,成功;-1，失败) |
| message | 是 | 撤销是否成功及提示 |
| billNumber | 否 | 撤销成功之后的单据号 |
| availablePoint | 否 | 剩余积分 |
| availableValue | 否 | 剩余储值 |
| consumeBillNumber | 否 | 原单据号 |
| refundMessage | 否 | 退单信息（仅当该笔单据使用移动支付时返回） |
| refundStatus | 否 | 退款状态（仅当该笔单据使用移动支付时返回，-1：退款失败，0：退款中，1：退款成功） |
| refundOrderNo | 否 | 退单单据号（仅当该笔单据使用移动支付时返回，可用于 查询退单状态 ） |