文档中心 > API类目 > 国内机票订单API

taobao.jipiao.agent.order.ticket (【机票代理商订单】订单回填票号/成功订单)

淘宝机票代理商回填票号/成功订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 123 淘宝系统订单id
success_info String [] 必须 订单中航班号1;旧乘机人姓名1;新乘机人姓名1;票号1,订单中航班号2;旧乘机人姓名2;新乘机人姓名2;票号2
  • 最大列表长度:18
  • 成功订单参数:列表元素结构为—— 1.航班号(注:是订单里的航班号,非实际承运航班号); 2.旧乘机人姓名; 3.新乘机人姓名; 4.票号 (乘机人、航段对应的票号) 说明: 1.往返订单,2段航班对应1个票号的,需要2条success_info记录,分别对应去程、回程; 2.有时用户输入的乘机人姓名输入错误或者有生僻字,代理商必须输入新的名字以保证验真通过;即旧乘机人姓名和新乘机人姓名不需要变化时可以相同

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 返回操作成功失败信息
    is_ticket_success Boolean true 返回回填票号操作成功失败信息
    is_order_success Boolean true 返回接口调用完成后,整个订单是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    JipiaoAgentOrderTicketRequest req = new JipiaoAgentOrderTicketRequest();
    req.setOrderId(123L);
    req.setSuccessInfo("订单中航班号1;旧乘机人姓名1;新乘机人姓名1;票号1,订单中航班号2;旧乘机人姓名2;新乘机人姓名2;票号2");
    JipiaoAgentOrderTicketResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <jipiao_agent_order_ticket_response>
        <is_success>true</is_success>
        <is_ticket_success>true</is_ticket_success>
        <is_order_success>true</is_order_success>
    </jipiao_agent_order_ticket_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:error 参数不正确+错误参数信息 根据文档设置参数
    isv.remote-service-error 系统错误+错误的原因 向运营咨询
    isv.remote-service-error:NO_DATA 订单数据不存在 确认查询条件,调整查询条件
    isv.remote-service-error:USER_AUTH_FAIL 访问权限不够,Appkey未授权或者Appkey绑定非授权用户 向运营咨询处理方案
    isp.service-unavailable

    API工具

    如何获得此API

    拥有此API的权限组 可获得/可申请此API权限组的应用类型
    国内机票_代理商订单接口(新) 飞猪-国际机票   飞猪-系统商  

    FAQ

    返回
    顶部