国内机票订票 聚合数据 企业专用

签订协议或更多需求,请与商务联系。为保证后续正常使用,测试完毕后请联系开通正式生产环境

数据ID:152

接口状态:正常

连接应用数:1461

接入服务商:聚合数据

  • API
  • 错误码参照
  • 价格与请求限制
  • 示例代码
  • 其他相关
接口地址:http://api2.juheapi.com/zteict_test/order/create
支持格式:json
请求方式:http get/post
请求示例:http://api2.juheapi.com/zteict_test/order/create?totalAmount=1100&paymentFlag=T&orderFlights={"takeoffPort":"SZX","landingPort":"CSX","flightDate":"2015-06-17","flightNum":"CZ6890","cabin":"Y"}&passengers=[{"passengerType":"ADULT","passengerName":"XX","passengerMobile":"1866xxxxxxx","idType":"0","idNumber":"3212xxxxxxxxxx","finallyPrice":"970","airportPrice":"50","fuelPrice":"60","extInfo":{"tripInsuCount":"1","birthday":"1989-12-24"}}]&orderId=test3&key=您申请的key
接口备注:根据查询选择航班信息和乘机人信息创建国内机票订单(不能定共享航班)
调用样例及调试工具:API测试工具
请求参数说明:
名称 类型 必填 说明
  totalAmount string 总金额(乘机人金额 (票价+机建税+燃油税+保费) 的合计)
  paymentFlag string 支付标识(是否出票(Y/N) Y:自动扣款,无需再调用支付接口,无法取消订单,如果是N,则需要调用支付接口)
  orderFlights orderFlight 航段信息
  passengers passenger 乘机人信息
  orderId string 用户订单号
  key string 应用APPKEY(应用详细页查询)
 
  orderFlight参数详情:
  takeoffPort string 出发机场三字码
  landingPort string 降落机场三字码
  flightDate string 起飞日期
  flightNum string 航班号(从航班信息中来)
  cabin string 舱位代码(从航班舱位信息中来)
 
  passenger参数详情:
  passengerType string 乘机人类型(ADULT:成人 CHILD:儿童 BABY:婴儿)
  passengerName string 乘机人姓名(如果是英文名:姓在前,名在后,中间加/,如果英文名长度超过26,中间名可以省略,名字可以缩写,姓氏不可以缩写)
  passengerMobile string 乘机人手机
  idType string 证件类型 (0:身份证 1:护照 2:其他)
  idNumber string 证件号
  finallyPrice string 票价(从航班舱位信息中来)
  airportPrice string 机建税(从航班信息中来)
  fuelPrice string 燃油税(从航班信息中来)
  extInfo Info 扩展信息
 
  Info参数详情:
  tripInsuCount string 去程保险份数(每份保险固定20元,指航空意外险, 每人上限为2份)
  birthday string 乘机人生日(格式为YYYY-MM-DD,购买保险此值必填)
返回参数说明:
名称 类型 说明
 
JSON返回示例:
{
  "error_code": "200",
  "reason": "请求成功",//当创建订单失败时,会有对应的错误信息返回
  "result": ""
}
XML返回示例:
回调格式说明:
用户可以根据orderStateInfo这个字段进行状态的更新,其他字段是对之前版本的兼容
当出票成功或者出票失败时,orderStateInfo.returnNum指billNum,即单据号
当退票成功或者退票失败时,orderStateInfo.returnNum指refundNum,即退票号
当改签成功或者改签失败时,orderStateInfo.returnNum指changeNum,即改签号

//出票失败
{
    "billnum": "101702070216",
    "ticketnum": "",
    "stateType": "FAIL_ISSUE",
    "orderStateInfo": {
        "memo": "xxxxxxxxxx",//出票失败说明
        "extInfo": null,//附加信息
        "amount": null,//发生金额
        "tickets": null,//票务信息
        "stateType": "FAIL_ISSUE",//回调状态
        "returnNum": "101702070216"
    },
    "extInfo": null
}
//出票成功
{
    "billnum": "101702070216",
    "ticketnum": null,
    "stateType": "SUCC_ISSUE",
    "orderStateInfo": {
        "memo": null,
        "extInfo": null,
        "amount": null,
        "tickets": [
            {
                "idType": "0",
                "idNumber": "0000000000000000",
                "ticketNum": "661-2020034817",
                "extInfo": [
                    {
                        "value": "101702060367_1",
                        "key": "orderNum"
                    }
                ],
                "takeoffPort": "NGB",
                "landingPort": "KWE"
            },
            {
                "idType": "0",
                "idNumber": "11111111111111",
                "ticketNum": "661-2020034817",
                "extInfo": [
                    {
                        "value": "101702060367_2",
                        "key": "orderNum"
                    }
                ],
                "takeoffPort": "NGB",
                "landingPort": "KWE"
            }
        ],
        "stateType": "SUCC_ISSUE",
        "returnNum": "101702070216"
    },
    "extInfo": null
}
//退票成功
{
    "billnum": "101702070216",
    "ticketnum": null,
    "stateType": "SUCC_REFUND",
    "orderStateInfo": {
        "memo": null,
        "amount": "35.0",
        "extInfo": [
            {
                "value": "-1070.0",
                "key": "ticketPrice"
            },
            {
                "value": "-50.0",
                "key": "airportPrice"
            },
            {
                "value": "0.0",
                "key": "fuelPrice"
            },
            {
                "value": "35.0",
                "key": "refundAmount"
            },
            {
                "value": "0.0",
                "key": "insuAmount"
            }
        ],
        "stateType": "SUCC_REFUND",
        "returnNum": "RT9018162",
        "tickets": null
    },
    "extInfo": null
}
//退票失败
{
    "billnum": "101702070216",
    "ticketnum": null,
    "stateType": "FAIL_REFUND",
    "orderStateInfo": {
        "memo": "一些退票失败的信息",
        "amount": null,
        "extInfo": null,
        "stateType": "FAIL_REFUND",
        "returnNum": "RT9018163",
        "tickets": null
    },
    "extInfo": null
}
//改签失败
{
    "billnum": "101702070216",
    "ticketnum": null,
    "stateType": "FAIL_CHANGE",
    "orderStateInfo": {
        "memo": "xiaoyangoni",
        "amount": null,
        "extInfo": null,
        "stateType": "FAIL_CHANGE",
        "returnNum": "CT9019022",
        "tickets": null
    },
    "extInfo": null
}
//改签成功
{
    "billnum": "101702070216",
    "ticketnum": "888-22222222",
    "stateType": "FAIL_CHANGE",
    "orderStateInfo": {
        "memo": null,
        "amount": "650.0",
        "extInfo": [
            {
                "value": "888-22222222",
                "key": "ticketNum"
            },
            {
                "value": "0.0",
                "key": "ticketPrice"
            },
            {
                "value": "0.0",
                "key": "airportPrice"
            },
            {
                "value": "0.0",
                "key": "fuelPrice"
            },
            {
                "value": "650.0",
                "key": "changeAmount"
            },
            {
                "value": "0.0",
                "key": "insuAmount"
            }
        ],
        "stateType": "SUCC_CHANGE",
        "returnNum": "CT9018947",
        "tickets": null
    },
    "extInfo": [
        {
            "value": "888-22222222",
            "key": "ticketNum"
        },
        {
            "value": "0.0",
            "key": "ticketPrice"
        },
        {
            "value": "0.0",
            "key": "airportPrice"
        },
        {
            "value": "0.0",
            "key": "fuelPrice"
        },
        {
            "value": "650.0",
            "key": "changeAmount"
        },
        {
            "value": "0.0",
            "key": "insuAmount"
        }
    ]
}
服务级错误码参照(error_code):
  错误码 说明
  215201 聚合权限验证失败,请联系客服
  215202 聚合MD5校验失败,请联系客服
  215203 其他异常
  215204 订单号已存在
  215205 账户余额不足
  215206 无此订单
  215207 非预定票,不能进行取消预定或付款操作
  215208 此预订票已取消
  215209 非成功付款订单,或已退款
  215210 分页参数有误
  215211 退票验证失败
  215212 改签验证失败
  215213 订单验证失败
  215214 出票处理中,请稍后再试
系统级错误码参照:
  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121
错误码格式说明(示例:200201):
  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
《国内机票订票》资费说明:
  名称 价格 次数 说明
  赠送包 ¥0.00   30    
为什么选择聚合数据?我们来做个比较!
 购买聚合数据的服务支出 << 服务器(600元/月)+带宽(100元/月)+技术人员(6000元/月)+...
完整教学代码示例:
  语言 标题 提供者 时间
常见问题:
  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1487524040
其他相关内容
  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 0512-62391880
  在线客服QQ: 800076065
  商务合作QQ: 603866358

推荐接口/API

活动推荐/Activity