马蜂窝开放平台

票务核销通知接口

接口说明：
此接口用于商家更新订单下凭证码的状态，商家可在门票已使用、订单已完成退款时通过此接口修改凭证码状态。马蜂窝订单将根据凭证码的状态来控制客人在前台的退款单申请；
1）一码一验订单，用户在提交退款申请时系统将校验每个码的核销状态，SKU可申请退款数量 <＝ SKU总数量－已使用或已退款的SKU数量；
2）一码多验订单，直接根据SKU关联的唯一验证码进行识别，如果SKU对应的凭证码状态为已退款或者已使用，则用户端不可申请退款；

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.ticket.consume.notice

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	2253329201801103938959	旅行商城业务订单号
ticket_voucher_status	array	是	[]	本次核销的票务信息和状态
{}	object	是	0
└ sku_id	int	否	660	马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一
└ ota_sku_id	string	否	S12346	商家设置的SKU外部编码，sku_id与ota_sku_id二选一
vouchers	array	是	[]
{}	object	是	0
└ voucher	string	是	GAL30962293101990111	请商家传递真实有效的凭证码信息，此凭证码将在前台页向客人进行展示，若商家没有真实有效的凭证码，马蜂窝将根据voucher_type的取值向商家返回马蜂窝生成的凭证码，供商家核销使用。
└ status	int	是	1	凭证状态：1-未使用，2-已使用，3-已退款，4-已废弃（对应的门票还未消费，但是此凭证码作废了）；

响应参数

参数名称	参数类型	示例	描述
order_id	string	2253329201801103938959	旅行商城业务订单号
info	array	[]
{}	object	0
└ voucher	string	GAL30962293101990111	凭证码
└ error_info	string	凭证码异常订单无法核销	核销异常信息

响应示例

{
    "order_id":"2253329201801103938959",
    "info":[
        {
            "voucher":"GAL30962293101990111",
            "error_info":"凭证码异常订单无法核销"
        }
    ]
}

异常错误码

异常码	异常信息
10060020	订单信息有误
10060013	传入数量与用户购买数量不匹配
10060012	订单号与SKU_ID不匹配
10060008	退款异常
10060007	更新失败
10060006	更新检查失败
10060005	超过单次更新最大数量限制(30)
10060004	没有操作权限
10060002	参数格式错误
10060001	当前订单不是门票订单