国内机票订单列表查询
国内机票订单列表查询
通过该接口查询国内机票订单列表。
遵循GDPR要求，默认只返回因公出行的订单。
接口URL
/napi/enterprise/cair/order/list
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| corpCode | 企业账号 | N | String | 1000 | 系统提供的企业账号,如果不传,将查询该租户下的订单 | |
| tenantUserId | 操作人帐号 | N | String | HW_000001 | 1、如果是系统维护，写“sysadmin”2、如果是普通员工维护，写员工登录名 | |
| orderId | 国内机票订单号 | N | String | F0215042408435860475 | 根据订单号查询 | |
| changeStartTime | 订单变化起始日期 | N | String | 20130423000000 | 格式yyyyMMddHHmmss。如果调用者置空，则默认当前时间的前一天 | |
| changeEndTime | 订单变化截止时间 | N | String | 20130424000000 | 格式yyyyMMddHHmmss。如果调用者置空，则默认当前时间 | |
| pageIndex | 查询的页码 | Y | String | 如1代表第1个分页 | ||
| size | 每页条数 | Y | String | 建议20，上限50 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| resultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 | |
| pageIndex | 当前的页码 | N | String | 1 | ||
| size | 每页条数 | N | String | 1 | ||
| total | 总记录数 | N | String | 1 | ||
| flightOrderList | 机票订单列表 | N | List<FlightOrder> |
国内机票订单FlightOrder
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| orderId | 订单号 | Y | String | F02130626111647367 | ||
| orderTime | 下订单时间 | N | String | 20180811113019 | yyyyMMddHHmmss | |
| orderStatus | 订单状态 | Y | String | 0：预订失败 1：待支付2：待出票3：已出票4：已取消5：出票失败6：暂缓出票8：价格变化待确认 9：出票中11：预订中 | 3、4为终态，可以获取详细数据 | |
| travelType | 出行方式 | N | String | 0：因公出行1：因私出行 | 默认返回因公出行订单 | |
| journeyType | 行程类型 | N | String | 0：单程1：普通往返2：联程3：特价往返 | ||
| totalPrice | 订单总价 | N | String | 115 | 订单总价，退改不更新订单总价。订单总价=总票面价+总机建费+总燃油费+总保险费用+总服务费 | |
| totalServiceFee | 总服务费 | N | String | 5 | 总服务费 | |
| Currency | 币种 | N | String | CNY | 国内机票目前都为人民币 | |
| OrderSource | 订单产品来源 | N | String | 0：前台web页面预订1：后台呼叫中心预订20：iOS客户端预订21：Android客户端预订3：PNR导入7：H5预订 | ||
| PayWay | 支付方式 | N | String | 1：个人在线支付 2：个人IVR支付（OP）3:现金 4:POS 6:因公欠款 7:vip欠款 8:担保欠款 10：外部月结 | ||
| PayStatus | 支付状态 | N | String | 0：未支付1：已支付 | ||
| htTrId | 慧通差旅审批单编号 | N | String | TA0315012116281300028 | ||
| changeTime | 订单变更时间 | N | String | TA0315012116281300028 |
样例
请求示例
{
"corpCode": "1234",
"tenantUserId": "sysadmin",
"changeStartTime": "20220922000000",
"changeEndTime": "20221022000000",
"orderId:"F0215042408435860475",
"size": "1",
"pageIndex": "1"
}
响应示例
{
"resultCode": "0",
"description": "Success",
"pageIndex": "11",
"size": "40",
"total": "436",
"flightOrderList": [{
"orderId": "F02130626111647367",
"orderTime": "20220925182102",
"orderStatus": "3",
"travelType": "0",
"journeyType": "0",
"totalPrice": "2879.00",
"totalServiceFee": "9.00",
"currency": "CNY",
"orderSource": "7",
"payWay": "10",
"payStatus": "0",
"htTrId": "TA0315012116281300028",
"changeTime": "20220925182102"
}]
}
错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10011 | 公司编号不能为空 | 检查入参 |
| 3404 | 时间戳信息错误，请确认后重试 | 检查入参 |
| 3401 | 企业账号不存在，请确认后重试 | 检查账号或者联系技术支持人员 |
| 10012 | 操作人帐号不能为空 | 检查入参 |
| 10013 | 操作人帐号不合法 | 检查账号或者联系技术支持人员 |
| 4000 | 系统繁忙，请稍后重试 | 未知错误，联系技术支持人员 |
| 4001 | 系统繁忙，请稍后重试 | 数据库错误，联系技术支持人员 |
| 4002 | 参数错误 | 根据描述信息检查入参 |
| 10109 | 页码设置错误，请确认后重试 | 检查入参 |
| 10110 | 每页条数需要在1~50之间 | 检查入参 |
| 10511 | 开始时间不能为空 | 检查入参 |
| 10512 | 结束时间不能为空 | 检查入参 |
| 10513 | 开始时间格式错误 | 检查入参 |
| 10514 | 结束时间格式错误 | 检查入参 |
| 10515 | 结束时间不能大于当前时间 | 检查入参 |
| 10516 | 结束时间距离开始时间不能超过24小时 | 检查入参 |
| 10518 | 该集团下无对应公司 | 检查是否集团查询 |
| 10519 | 集团编号不存在，请确认后重试 | 检查账号或者联系技术支持人员 |
| 230000100 | 系统繁忙，请稍后重试 | 未知错误，联系技术支持人员 |