一码多验订单门票数量状态更新
－ 商家在调用action：sales.ticket.order.status.update完成订单状态更新和核销凭证码回传时，对于一码多验的订单，如果回传了quantity参数，则可通过调用此接口同步更新一码多验订单对应门票数量状态，马蜂窝将根据对应数量的状态对用户提交的退款申请进行控制；
－ 调用此接口需要回传全量的数量状态，如一个订单5张票，其中4张未使用，1张已使用，则需回传：not_used_quantity: 4, used_quantity: 1, refunded_quantity: 0;
－ 在完成马蜂窝退款之后，马蜂窝不会自动修改数量状态，商家需要及时调用接口更新对应数量状态，保证一致性，避免影响后续的退款操作；
－ 数量状态包括：“未使用”、“已使用”、“已退款”三个状态，状态变更不可逆，如不能将“已退款”变更为“已使用”或“未使用”；
请求URL
正式环境：https://openapi.mafengwo.cn/deals/rest
请求Action
action：sales.ticket.quantity.update
请求参数
| 参数名称 |
参数类型 |
必填 |
示例 |
描述 |
| order_id |
string |
是 | 2124976201711275278834 |
旅行商城业务订单号 |
| sku_id |
int |
否 | 248838 |
马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一 |
| ota_sku_id |
string |
否 | S121325 |
商家设置的SKU外部编码，sku_id与ota_sku_id二选一 |
| quantity_status_info |
object |
是 | {} |
一码多验 门票数量状态信息 |
| └ not_used_quantity |
int |
否 | 1 |
未使用数量 |
| └ used_quantity |
int |
否 | 1 |
已使用数量 |
| └ refunded_quantity |
int |
否 | 1 |
已退款数量 |
响应参数
| 参数名称 |
参数类型 |
示例 |
描述 |
| order_id |
string |
2124976201711275278834 |
旅行商城业务订单号 |
响应示例
{
"order_id":"2124976201711275278834"
}
异常错误码
| 异常码 |
异常信息 |
| 10060030 |
无效的核销数量 |
| 10060029 |
核销图片数量异常 |
| 10060028 |
数量核销状态不可逆 |
| 10060027 |
核销数量异常 |
| 10060026 |
不支持数量核销 |
| 10060025 |
quantity数量与购买数量不匹配 |
| 10060020 |
订单信息有误 |
| 10060007 |
更新失败 |
| 10060006 |
更新检查失败 |
| 10060004 |
没有操作权限 |
| 10060001 |
当前订单不是门票订单 |
