文档中心 > 综合交通-商家对接

alitrip.ship.order.notify (订单信息回填(出票回调))

此接口为接入商调用飞猪旅行接口回填票号、密码(验证码)等订单信息。接口根据alitripOrderId幂等。若第一次调用失败,后续调用仍然可以回填票号、密码(验证码)成功。第一次调用成功后,后续调用会直接返回第一次的调用结果,不会再产生更新操作。多张票同时出票回填时,保证原子性,只允许全部成功或者全部失败,不能存在部分成功或者失败

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
confirm_book_r_q ShipAgentConfirmBookRq 可选 出票入参
  • └ agent_order_id
  • String
  • 必须
  • 13334099888
  • 商家订单id
  • └ alitrip_order_id
  • String
  • 必须
  • 3892200000033
  • 飞猪订单id
  • └ fetch_tickets_address
  • String
  • 可选
  • 人民广场信息
  • 取票地址信息
  • └ fetch_tickets_number
  • String
  • 可选
  • 344420
  • 取票号
  • └ fetch_tickets_pwd
  • String
  • 可选
  • 4502039
  • 取票密码
  • └ main_biz_order_id
  • Number
  • 可选
  • 3892200000033
  • 淘宝订单Id
  • └ message
  • String
  • 可选
  • 短信内容
  • 取票短信内容
  • └ order_attr
  • String
  • 可选
  • json属性
  • 扩展属性
  • passenger_list
  • ShipAgentConfirmBookPassengerInfo []
  • 可选
  • 乘客列表
  • └ passenger_cert_no
  • String
  • 可选
  • 212100198902171763
  • 乘客证件号
  • └ passenger_cert_type
  • String
  • 可选
  • 1
  • 乘客证件类型
  • └ passenger_id
  • String
  • 可选
  • 30303029
  • 乘客id
  • └ passenger_name
  • String
  • 可选
  • 罗大佑
  • 乘客姓名
  • ticket_list
  • ShipAgentConfirmBookTicketInfo []
  • 可选
  • 票信息
  • └ e_ticket_no
  • String
  • 可选
  • e3393939
  • 电子票号
  • └ ticket_desc
  • String
  • 可选
  • 票描述
  • 票描述
  • └ ticket_id
  • String
  • 必须
  • 29018383839
  • 票Id
  • └ ticket_no
  • String
  • 可选
  • 3404040
  • 票号
  • └ ticket_price
  • Number
  • 必须
  • 100
  • 票价格(分)
  • └ ticket_pwd
  • String
  • 可选
  • 22d9d9d
  • 取票密码
  • └ ticket_seat_no
  • String
  • 可选
  • 坐席号
  • 座位号
  • └ ticket_status
  • String
  • 可选
  • 1
  • 票状态:1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败
  • └ ticket_sub_type
  • String
  • 可选
  • 11
  • 子票种类型11-去程;12-往返;21普通门票;31酒店
  • └ ticket_title
  • String
  • 可选
  • 票标题
  • 票标题
  • └ ticket_type
  • String
  • 必须
  • 1
  • 票种类别1-船票;2-门票;3-酒店;4-其他
  • └ ext_attr
  • String
  • 可选
  • json属性
  • 扩展属性数据
  • └ expire_time
  • Date
  • 可选
  • 2019-12-20 00:00:00
  • 过期时间
  • └ success
  • Boolean
  • 必须
  • true
  • 出票结果
  • └ ticket_count
  • Number
  • 可选
  • 3
  • 票数
  • └ ticket_wicket
  • String
  • 可选
  • xx检票口
  • 检票口
  • └ total_price
  • Number
  • 可选
  • 23000
  • 总价
  • └ failed_code
  • String
  • 可选
  • 参考错误码文档
  • 出票失败错误码

响应参数

名称 类型 示例值 描述
ret_code String demo 错误码
ret_msg String demo 错误描述
ret_success Boolean false 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripShipOrderNotifyRequest req = new AlitripShipOrderNotifyRequest();
AlitripShipOrderNotifyRequest.ShipAgentConfirmBookRq obj1 = new AlitripShipOrderNotifyRequest.ShipAgentConfirmBookRq();
obj1.setAgentOrderId("13334099888");
obj1.setAlitripOrderId("3892200000033");
obj1.setFetchTicketsAddress("人民广场信息");
obj1.setFetchTicketsNumber("344420");
obj1.setFetchTicketsPwd("4502039");
obj1.setMainBizOrderId(3892200000033L);
obj1.setMessage("短信内容");
obj1.setOrderAttr("json属性");
List<AlitripShipOrderNotifyRequest.ShipAgentConfirmBookPassengerInfo> list3 = new ArrayList<AlitripShipOrderNotifyRequest.ShipAgentConfirmBookPassengerInfo>();
AlitripShipOrderNotifyRequest.ShipAgentConfirmBookPassengerInfo obj4 = new AlitripShipOrderNotifyRequest.ShipAgentConfirmBookPassengerInfo();
list3.add(obj4);
obj4.setPassengerCertNo("212100198902171763");
obj4.setPassengerCertType("1");
obj4.setPassengerId("30303029");
obj4.setPassengerName("罗大佑");
List<AlitripShipOrderNotifyRequest.ShipAgentConfirmBookTicketInfo> list7 = new ArrayList<AlitripShipOrderNotifyRequest.ShipAgentConfirmBookTicketInfo>();
AlitripShipOrderNotifyRequest.ShipAgentConfirmBookTicketInfo obj8 = new AlitripShipOrderNotifyRequest.ShipAgentConfirmBookTicketInfo();
list7.add(obj8);
obj8.setETicketNo("e3393939");
obj8.setTicketDesc("票描述");
obj8.setTicketId("29018383839");
obj8.setTicketNo("3404040");
obj8.setTicketPrice(100L);
obj8.setTicketPwd("22d9d9d");
obj8.setTicketSeatNo("坐席号");
obj8.setTicketStatus("1");
obj8.setTicketSubType("11");
obj8.setTicketTitle("票标题");
obj8.setTicketType("1");
obj8.setExtAttr("json属性");
obj8.setExpireTime(StringUtils.parseDateTime("2019-12-20 00:00:00"));
list5.setTicketList(list7);
obj1.setPassengerList(list3);
obj1.setSuccess(true);
obj1.setTicketCount(3L);
obj1.setTicketWicket("xx检票口");
obj1.setTotalPrice(23000L);
obj1.setFailedCode("参考错误码文档");
req.setConfirmBookRQ(obj1);
AlitripShipOrderNotifyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ship_order_notify_response>
    <ret_code>demo</ret_code>
    <ret_msg>demo</ret_msg>
    <ret_success>false</ret_success>
</alitrip_ship_order_notify_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部