创建订单(锁定座席)成功之后,调用订单出票接口,要求幂等。商家以agentOrderId或者alitripOrderId字段为关键字做幂等(即多次调用返回一致的结果)。同时商家要保证,订单状态与所有的票状态事务一致性,即如果订单状态为出票成功,那么必须所有的票都是已出票状态。选择不选择进行出票结果回填,那么此接口的信息商家要把数据填写完整。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
agent_order_id | String | 必须 | 22222 | 分销商订单Id | |
alitrip_order_id | String | 必须 | 33333 | 飞猪平台订单id | |
extAttr | String | 必须 | {"param":"param"} | 扩展属性 json格式 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ret_desc | String | 成功 | 业务结果描述 |
status_desc | String | 出票成功 | 订单状态描述 |
agent_order_id | String | 13334099888 | 商家订单Id |
fetch_ticket_spot | String | 成都人民广场 | 取票地址 |
ship_number | String | 川A 88899 | 航班号 |
success | Boolean | true | 业务结果状态 |
ticket_wicket | String | 检票口 | 检票口详细信息 |
sms_content | String | 出票成功,恭喜您购票,请于2018-11-30日21:30:00准时乘车 | 短信 |
agent_issue_time | String | 2018-11-29 21:00:00 | 出票成功时间 |
alitrip_order_id | String | 3892200000033 | 飞猪订单id |
passenger_list | Passenger [] | 乘客信息 | |
|
|||
ret_code | String | 0 | 业务结果编码 |
status | String | 3 | 订单状态参考订单状态码 |
1 2 3 4 5 6 7 | QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret); AlitripShipOrderConfirmRequest req = new AlitripShipOrderConfirmRequest(); req.setAgentOrderId( "22222" ); req.setAlitripOrderId( "33333" ); req.setExtAttr( "{\"param\":\"param\"}" ); AlitripShipOrderConfirmResponse rsp = client.execute(req); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | < ret_desc >成功</ ret_desc > < status_desc >出票成功</ status_desc > < agent_order_id >13334099888</ agent_order_id > < fetch_ticket_spot >成都人民广场</ fetch_ticket_spot > < ship_number >川A 88899</ ship_number > < success >true</ success > < ticket_wicket >检票口</ ticket_wicket > < sms_content >出票成功,恭喜您购票,请于2018-11-30日21:30:00准时乘车</ sms_content > < agent_issue_time >2018-11-29 21:00:00</ agent_issue_time > < alitrip_order_id >3892200000033</ alitrip_order_id > < passenger_list > < passenger > < passenger_name >罗大佑</ passenger_name > < ticket_list > < ticket > < ticket_title >公园门票</ ticket_title > < ticket_pwd >223345</ ticket_pwd > < ticket_no >388888</ ticket_no > < ticket_seat_no >48</ ticket_seat_no > < ticket_price >100</ ticket_price > < e_ticket_no >3333099</ e_ticket_no > < ticket_desc >当日使用</ ticket_desc > < ticket_type >1</ ticket_type > < ticket_sub_type >12</ ticket_sub_type > < ticket_id >票id</ ticket_id > < ticket_status >1</ ticket_status > < ticket_expire_time >票过期时间</ ticket_expire_time > </ ticket > </ ticket_list > < passenger_certificate_no >212100198902171763</ passenger_certificate_no > < passenger_certificate_type >1</ passenger_certificate_type > < passenger_id >2903345</ passenger_id > < passenger_type >乘客类型</ passenger_type > </ passenger > </ passenger_list > < ret_code >0</ ret_code > < status >3</ status > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|