订单时段查询简单说明:
开放平台提供了根据下单时间段查询批量查询的接口。
接口最多一次查询7天数据,每次查询最多返回50条数据。开发者可根据返回数据中的hasNextPage字段判断是否有下一页数据。根据currentPage(当前页码),并使用pageOffset参数(currentPage+1)指定数据页码。
请求地址: https://m-api.lejian.com/open-api/V2/order/queryOrder?accessToken=ACCESS_TOKEN
请求协议:HTTPS
请求方式:POST
需要签名:否
URL参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| accessToken | 是 | string | 当前有效的accessToken |
| pageOffset | 否 | integer | 页码 |
POST参数示例
{"beginDate":"2017-08-10","endDate":"2017-08-16","pageOffset":"2"}
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| beginDate | 是 | string | 开始查询时间 |
| endDate | 是 | string | 结束查询时间 |
| pageOffset | 是 | integer | 数据分页时的页码,如果返回数据hasNextPage为true,则 pageOffset = currentPage+1 |
起始时间和结束时间跨度最大不超过7天,且结束时间当天的订单不会被查询。
返回示例:
{"data": {"currentPage": 1,"hasNextPage": false,"orders": [{"address": "浙江省杭州市西湖区紫金港路21号","beginPeriod": "7:30","brandId": 3,"brandName": "爱康国宾","canChangeDate": false,"canRevoke": false,"checkItems": [],"companyId": 4310023,"createTime": "2025-08-11 13:29:50","endPeriod": "10:30","examDate": "2025-08-17","exportStatus": 1,"hospitalId": 1807,"hospitalName": "爱康西溪天堂旗舰体检中心","items": [{"discount": true,"id": 4443150,"name": "一般检查A","price": 1333,"typeToMeal": 1},{"discount": true,"id": 4443151,"name": "内科","price": 1333,"typeToMeal": 1}],"orderId": 32418347,"orderNum": "20250811132950235583909","orderPrice": 32000,"orderStatus": "finish","settlementDiscount": 1.0,"status": 3,"useInfo": {"department": "上饶市桔籽科技有限公司杭州分公司","employeeId": "D97488","gender": 0,"idCard": "xxx","marriageStatus": 1,"mobile": "xxx","name": "xxx","relationship": 7}}]},"msg": "success","success": "T"}
返回参数说明:
通俗易懂的参数不再说明
| 字段 | 类型 | 说明 |
|---|---|---|
| currentPage | integer | 当前页码 |
| hasNextPage | boolean | 本次查询是否还有下一页数据 |
| orders | Array | 订单列表 |
| items | JSONObject | 订单单项 |
| exportStatus | integer | 订单导出状态(0:未导出 1:已导出) |
| refundAmount | integer | 订单退款金额(当订单状态为examined时,会返回) |
| openId | String | 用户在开放平台的唯一标识(用户注册下单则返回该信息) |
| status | int | 订单状态,可能民营机构会存在中间态,如预约中,对接消息推送会获取终态(订单状态 0:未付款 1:已支付 2:已预约 3:体检完成 4:未到检 5:已撤销 6:已删除 7:支付中 8:已关闭 9:部分退 10:导出失败 11.现场支付) |
| orderId | integer | 自增主键 |
| orderNum | String | 订单号 |
| beginPeriod | String | 开始时段 |
| endPeriod | String | 结束时段 |
| examDate | String | 预约的体检日期 |
| systemFinishTime | String | 体检完成时间 |
| hospitalId | integer | 体检机构ID |
| hospitalName | String | 体检机构名称 |
| orderPrice | integer | 订单金额,单位分 |
| useInfo | JSONObject | 体检人信息 |
| -department | String | 三方员工部门 |
| -employeeId | String | 三方员工标识 |
| -gender | integer | 性别:1女,0男 |
| -idCard | String | 证件号码 |
| -addAccountType | String | 证件类型:idCard(“身份证”), employeeNo(“员工号”), passport(“护照添加”), officeCert(“军官证添加”), hmCard(“港澳身份证添加”), taiWanIdCard(“台胞证添加”), gat(“港澳通行证”), fprIdCard(“外国人永久居留身份证”), hmPass(“港澳居民来往内地通行证”), hmRP(“港澳居民居住证”), taiwanPass(“台湾居民来往内地通行证”), other(“其他”) |
| -mobile | String | 手机号 |
| -name | String | 姓名 |
| -relationship | integer | 体检人关系 0 其他 1 配偶 2 子女 3 母亲 4 父亲 5 兄弟姐妹 6 亲戚朋友 7 本人 |
注意:公立医院订单导出状态指的是该订单信息是否进入到体检中心系统,如果为已导出状态(错误码:201017),说明该订单已经进入体检中心系统,接口不能进行改期和撤销操作,如果确实需要进行以上操作,请人工联系每天健康客服
status对照表状态流转
| 状态 | 说明 |
|---|---|
| 0 | 待支付 |
| 2 | 已预约 |
| 20 | 预约失败 |
| 21 | 预约中 |
| 3 | 体检完成 |
| 41 | 改期中 |
| 5 | 已撤销 |
| 51 | 撤销中 |
| 6 | 删除 |
| 8 | 关闭 |
注意:黑体加粗状态只会出现在爱康、美年、瑞慈、慈铭民营医院
备注:
- 更多返回错误代码请看接口返回码说明
文档更新时间: 2026-01-19 11:58