• 152
  • 1550
  • 51

国内机票订票

聚合数据 企业专用

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

  • 按实际订单计费

¥ *** 价格详情请联系客服

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://v.juhe.cn/zteict_test/order/create
返回格式:json
请求方式:http get/post
请求示例:http://v.juhe.cn/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
接口备注:根据查询选择航班信息和乘机人信息创建国内机票订单(不能定共享航班)

请求参数说明:

名称 必填 类型 说明
  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) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1527494346

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-8827-715
  在线客服QQ: 800076065

现在注册,百款接口免费测试

免费注册