接口文档 / 体检接口

创建体检单

POST/api/v2/open-agency/pe-orders在线调试

请求参数

名称	说明	类型
Body 参数
`patientId`必填	患者ID	`string`
`businessTime`可选	体检时间格式：date-time	`string`
`reportGetWay`可选	取报告方式 0:到店自取 1:快递 2:电子报告示例：`0` 最小：0	`integer`
`address`可选	邮寄地址	`object`
`forms`可选	体检项目	`array<object>`
`expectedTotalPrice`可选	订单金额（小数点前最多为12位，小数点后最多4位）,为空默认使用商品系统价格示例：`1000`	`number`
`operatorId`可选	操作人ID 示例：`00000000000000000000000000000000`	`string`

请求示例

json

{
  "patientId": "string",
  "businessTime": "2026-01-01T00:00:00Z",
  "reportGetWay": 0,
  "address": {
    "addressProvinceId": 510000,
    "addressProvinceName": "四川",
    "addressCityId": 510100,
    "addressCityName": "成都市",
    "addressDistrictId": 510109,
    "addressDistrictName": "高新区",
    "addressDetail": "交子大道180号"
  },
  "forms": [
    {
      "type": 0,
      "salesEmployeeId": "string",
      "salesDepartmentId": "string",
      "items": [
        {
          "productId": "483ac61f811640f5849a3d3aabceea58",
          "productShortId": 1907765200,
          "salesEmployeeId": "string",
          "salesDepartmentId": "string",
          "expectedUnitPrice": 0
        }
      ]
    }
  ],
  "expectedTotalPrice": 1000,
  "operatorId": "00000000000000000000000000000000"
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`可选	订单id	`string`
`patient`可选	患者信息	`object`
`patientOrderId`可选	体检就诊单id	`string`
`name`可选	订单名称	`string`
`no`可选	体检单号	`string`
`orderNo`可选	订单编号	`string`
`type`可选	订单类型 0 个检 10 团检	`integer`
`businessTime`可选	体检时间 yyyy-MM-dd	`string`
`orderCreated`可选	下单时间格式：date-time	`string`
`reportGetWay`可选	取报告方式	`integer`
`status`可选	订单状态 10:待预约 20:已预约-待登记 30:已登记-体检中 40:已体检-待交表 50:已交表 60:待总评 70:待审核 80:待发布 90:已发布	`integer`
`totalFee`可选	订单金额	`number`
`chargeStatus`可选	订单收费状态 0:未收费 10:部分收费 20:已收费	`integer`
`sheetSubmitted`可选	已检时间-交表时间格式：date-time	`string`
`reportApproved`可选	总评时间-审核通过格式：date-time	`string`
`reportReleased`可选	发布时间格式：date-time	`string`
`sourceType`可选	订单来源 0:PC 100:OPEN_API	`integer`
`patientImageUrl`可选	体检单头像照片	`string`
`address`可选	客户地址	`object`
`forms`可选	患者照片url	`array<object>`
`salesEmployee`可选	销售员工	`object`
`salesDepartment`可选	销售科室信息	`object`
`chargeSheet`可选	体检收费订单	`object`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": "string",
    "patient": {
      "id": "000000fc446f4dbd989857e305b00d6s",
      "name": "张三",
      "mobile": 18080000000,
      "sex": "男",
      "birthday": "1970-08-14",
      "age": "60岁2月1天",
      "idCard": 630101200010075800,
      "idCardType": "身份证",
      "visitReason": "string"
    },
    "patientOrderId": "string",
    "name": "string",
    "no": "string",
    "orderNo": "string",
    "type": 0,
    "businessTime": "string",
    "orderCreated": "2026-01-01T00:00:00Z",
    "reportGetWay": 0,
    "status": 0,
    "totalFee": 0,
    "chargeStatus": 0,
    "sheetSubmitted": "2026-01-01T00:00:00Z",
    "reportApproved": "2026-01-01T00:00:00Z",
    "reportReleased": "2026-01-01T00:00:00Z",
    "sourceType": 0,
    "patientImageUrl": "string",
    "address": {
      "addressProvinceId": 510000,
      "addressProvinceName": "四川",
      "addressCityId": 510100,
      "addressCityName": "成都市",
      "addressDistrictId": 510109,
      "addressDistrictName": "高新区",
      "addressDetail": "交子大道180号"
    },
    "forms": [
      {
        "id": 0,
        "type": 0,
        "salesEmployee": {
          "id": "string",
          "name": "string"
        },
        "salesDepartment": {
          "id": "string",
          "name": "string",
          "departmentAddress": "string"
        },
        "items": [
          {
            "id": 0,
            "productId": "string",
            "productType": 0,
            "productSubType": 0,
            "productName": "string",
            "status": 0,
            "sourceUnitPrice": 0,
            "unitPrice": 0,
            "salesEmployee": {
              "id": "string",
              "name": "string"
            },
            "salesDepartment": {
              "id": "string",
              "name": "string",
              "departmentAddress": "string"
            },
            "scheduleTime": "string",
            "remark": "string",
            "children": [
              null
            ]
          }
        ],
        "chargeStatus": 0,
        "totalFee": 0
      }
    ],
    "salesEmployee": {
      "id": "string",
      "name": "string"
    },
    "salesDepartment": {
      "id": "string",
      "name": "string",
      "departmentAddress": "string"
    },
    "chargeSheet": {
      "id": "string",
      "totalFee": 0
    }
  },
  "error": null
}

业务失败包装示意

json

{
  "data": null,
  "error": {
    "code": 11003,
    "message": "不支持的授权类型{grantType}"
  }
}

查看 HTTP 状态与业务码排查