马蜂窝开放平台

将订单设为已出单状态并回传门票票务信息

此接口主要完成两步操作：
1）将订单从“已支付”或“已确认”状态变更为“已出单”状态；
2）回传用于核销的凭证码信息；
注意：
－调用此接口会直接将订单变更为出单状态，即同时完成“已联系用户并确认库存（12）”，“已发确认单（13）”两步状态变更；若商家需要完成“已联系用户并确认库存（12）”状态的单独变更，请调用已有的接口action：sales.order.status.update
－现有接口action：sales.order.status.update 仍然支持对景点门票订单更新状态态，但是调用此接口修改订单状态为“已发确认单（13）”时，将无法完成后续的核销流程；
－请商家传递真实有效的凭证码信息，此凭证码将在前台页向客人进行展示，若商家没有真实有效的凭证码，需按照vouchers的结构回传空字符串；马蜂窝将根据voucher_type的取值向商家返回马蜂窝生成的凭证码，供商家核销使用；

调用频次

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

请求URL

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

请求Action

action：sales.ticket.order.status.update

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	306255201712015312162	旅行商城业务订单号
memo	string	否	邮件已发，请查收邮件	订单状态的备注信息。该备注对用户可见，请谨慎填写，并有300个字符的限制
ticket_vouchers	array	是	[]	订单对应的票务信息
{}	object	是	0
└ sku_id	int	否	248838	马蜂窝sku_id，马蜂窝sku_id与ota_sku_id商家编码二选一
└ ota_sku_id	string	否	S121325	商家设置的SKU外部编码，sku_id与ota_sku_id二选一
└ type	int	是	1	1－一码一验，一个库存对应一个凭证码； 2－一码多验，多个库存对应一个凭证码；
└ quantity	int	否	5	一码多验订单，如果需要根据购票数量进行核销，则回传此笔订单购买的门票数量
vouchers	array	是	[]	票务信息
{}	object	是	0
└ voucher	string	否	GAL3096229	请商家传递真实有效的凭证码信息，此凭证码将在前台页向客人进行展示，若商家没有真实有效的凭证码，马蜂窝将根据voucher_type的取值向商家返回马蜂窝生成的凭证码，供商家核销使用；
└ voucher_pic	string	否		图片码凭证，传图片链接地址, 有多个时，顺序必须与vouchers的顺序一致，马蜂窝将以此顺序与voucher顺序进行一一对应；
travelers	array	否	[]	出行人信息
└ 127845	int	否	0	出行人ID
└ status	int	是	1	凭证状态：1-未使用，2-已使用，3-已退款，4-已废弃（对应的门票还未消费，但是此凭证码作废了）【添加时状态只能是 1 未使用】

响应参数

参数名称	参数类型	示例	描述
order_id	string	306255201712015312162	旅行商城业务订单号
ticket_vouchers	array	[]
{}	object	0
└ sku_id	int	248838	马蜂窝sku_id
└ ota_sku_id	string	S121325	商家设置的SKU外部编码
└ type	int	1	1－一码一验，一个库存对应一个凭证码； 2－一码多验，多个库存对应一个凭证码；
vouchers	array	[]
{}	object	0
└ voucher	string	GAL3096229	凭证码
└ voucher_pic	string		图片码凭证，传图片链接地址, 有多个时，顺序必须与vouchers的顺序一致，马蜂窝将以此顺序与voucher顺序进行一一对应；
└ status	int	1	凭证状态：1-未使用，2-已使用，3-已退款，4-已废弃（对应的门票还未消费，但是此凭证码作废了）；
└ quantity	int	1	购买数量

响应示例

{
    "order_id":"306255201712015312162",
    "ticket_vouchers":[
        {
            "sku_id":"248838",
            "ota_sku_id":"S121325",
            "type":"1",
            "vouchers":[
                {
                    "voucher":"GAL3096229",
                    "voucher_pic":"",
                    "status":"1"
                }
            ],
            "quantity":"1"
        }
    ]
}

异常错误码

异常码	异常信息
10060029	核销图片数量异常
10060025	quantity数量与购买数量不匹配
10060024	操作频繁，稍后再试
10060023	出单失败(出行人信息待补充)
10060022	核销码长度不能超过64
10060021	核销参数结构错误
10060020	订单信息有误
10060019	订单账号异常
10060018	没有操作权限
10060017	订单状态异常
10060016	订单出行日期有误
10060015	订单号异常
10060014	SKU_ID重复添加
10060013	传入数量与用户购买数量不匹配
10060012	订单号与SKU_ID不匹配
10060011	凭证码状态有误
10060010	凭证码数量有误
10060009	凭证码类型不正确
10060007	更新失败
10060006	更新检查失败
10060005	超过单次更新最大数量限制(30)
10060004	没有操作权限
10060003	添加核销信息失败
10060002	参数格式错误
10060001	当前订单不是门票订单