生成未支付订单接口

使用开放平台进行单个下单操作。此操作只包含下单，订单处于未支付状态。

请求URL:

https://m-api.lejian.com/open-api/V2/order/reserve?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN

请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:
参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值

关于nonce和sign请查看 数据签名。

POST参数示例
  1. {
  2.     "examDate":"2017-09-18",
  3.     "examTimeIntervalId":1020,
  4.     "mealId":"12878",
  5.     "mobile":"18668182661",
  6.     "examAccountName":"测试A",
  7.     "idCard":"220102199003077434",
  8.     "married":1,
  9.     "gender":0,
  10.     "age":30,
  11.     "nationality":"汉族",
  12.     "orderPrice":17500
  13. }
参数名 是否必须 类型 说明
examDate 是 string 体检日期（格式：yyyy-mm-dd）
examTimeIntervalId 是 int 体检时段，取返回值period,参考套餐可约时间查询
mealId 是 int 套餐id
mobile 是 string 体检人手机号码
idCard 是 string 体检人证件号
examAccountName 是 string 体检人姓名
married 是 int 婚否，默认值为未婚，0:未婚，1：已婚
gender 是 int 性别 0：男 1：女
age 是 int 年龄
nationality 否 string 民族
companyId 否 int 单位， 默认为空，特殊逻辑情况下，每天健康这边会提供
orderPrice 是 int 订单价格
idType 是 int 证件类型 默认身份证 1:身份证 2：护照 3：军官证 4：港澳身份证 注意：检查机构是否支持2，3，4请查看体检中心查询接口的返回值supportMultipleCertificate

返回示例:

正确时返回:

  1.  {
  2.     "success":"T",
  3.     "data":{
  4.             "examDate":"2017-09-18 12:00:00",
  5.             "hospitalId":23,
  6.             "hospitalName":"浙江省中医院下沙院区体检中心",
  7.             "items": [
  8.                 {
  9.                     "name":"血压",
  10.                     "price":0
  11.                 }
  12.             ],
  13.             "mealName":"普通入职体检(男)"
  14.             "orderNum":"20170822194904339001236",
  15.             "orderPrice":17500,
  16.             "orderStatus":"unpay"
  17.     },
  18.     "msg":"success"
  19. }

返回参数说明:

参数名 类型 说明
openId string 当前注册用户在开放平台的唯一标识符
hospitalName String 体检中心名称
hospitalId int 体检中心id
mealName string 套餐名称
orderPrice int 订单价格
orderNum string 订单号
examDate string 体检日期
orderStatus string 订单状态
items JSONObject 订单单项

订单状态对照表

状态 说明
unpay 未付款
success 预约成功
unexamined 用户预约成功后未去体检中心体检
cancel 订单取消
examined 用户体检完成，但是有退款产生
finish 用户体检完成

主要异常场景：
1、入参必传字段为空

  1.  {
  2.     "success":"F",
  3.     "errCode":"201003",
  4.     "msg":"Book fields is null: {0}"  //0为具体异常信息
  5. }

2、用户信息不匹配，需要先更新用户信息

  1.  {
  2.     "success":"F",
  3.     "errCode":"201007",
  4.     "msg":"ExamPerson info need update"
  5. }

这个异常是用户手机号和姓名与注册时不同。

3、渠道账户余额不足，需要充值

  1.  {
  2.     "success":"F",
  3.     "errCode":"201012",
  4.     "msg":"balance not enough"
  5. }

4、套餐信息与单项信息不匹配

  1.  {
  2.     "success":"F",
  3.     "errCode":"201009",
  4.     "msg":"Order book examItemIds uncorrected"
  5. }

这个异常产生的原因是第三方套餐信息与我方(每天健康)套餐信息不匹配，需要重新拉取套餐信息。

备注:

文档更新时间: 2021-06-02 21:48