接口文档 / 收费接口

创建零售收费单

POST/api/v2/open-agency/charge/sheets在线调试

请求参数

名称	说明	类型
Body 参数
`chargeForms`必填	收费处方列表	`array<object>`
`patientId`可选	患者ID 示例：`ffffffff0000000034de380221984001`	`string`
`sellerId`可选	开单人ID 示例：`ffffffff000000001b6cf51810e0e000`	`string`
`sellerDepartmentId`可选	开单人部门ID，sellerId有值时，sellerDepartmentId必填示例：`38e4085cb61ef7ac520cbd6e7508ead2`	`string`
`doctorId`可选	医生ID，有值时医生科室ID、诊断不能为空示例：`ffffffff0000000022174678012e2000`	`string`
`doctorDepartmentId`可选	医生科室ID 示例：`38e4085cb61ef7ac520cbd6e7508ead2`	`string`
`diagnosis`可选	诊断示例：`急性上呼吸道感染`	`string`
`prescriptionUrls`可选	处方图片URL列表。通过接口【5.14.1】上传	`array<string>`
`operatorId`必填	操作人ID 示例：`00000000000000000000000000000000`	`string`
`disablePromotion`可选	不使用营销活动标识 0:使用 1:不使用，不传默认0使用示例：`1` 范围：0 ~ 1	`integer`

请求示例

json

{
  "chargeForms": [
    {
      "doseCount": 1,
      "pharmacyNo": 0,
      "chargeFormItems": [
        {
          "productId": "483ac61f811640f5849a3d3aabceea58",
          "productShortId": 1907765200,
          "unitCount": 2,
          "expectedUnitPrice": 5,
          "expectedTotalPrice": 5,
          "useDismounting": 1,
          "specialRequirement": "煎法(先煎、后下、包煎、另煎、先炒、烊化、冲服、捣碎、吞服、煎汤代水、兑入、打粉、另包)",
          "extraInfo": "string"
        }
      ],
      "usageInfo": {
        "usage": "煎服",
        "freq": "1日3次",
        "doseCount": 3,
        "dailyDosage": "1日3剂",
        "requirement": "饭前服用",
        "usageLevel": "每次150ml"
      }
    }
  ],
  "patientId": "ffffffff0000000034de380221984001",
  "sellerId": "ffffffff000000001b6cf51810e0e000",
  "sellerDepartmentId": "38e4085cb61ef7ac520cbd6e7508ead2",
  "doctorId": "ffffffff0000000022174678012e2000",
  "doctorDepartmentId": "38e4085cb61ef7ac520cbd6e7508ead2",
  "diagnosis": "急性上呼吸道感染",
  "prescriptionUrls": [
    "string"
  ],
  "operatorId": "00000000000000000000000000000000",
  "disablePromotion": 1
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`必填	收费单ID 示例：`ffffffff0000000035094935b30b8000`	`string`
`patientOrderId`必填	就诊单ID 示例：`ffffffff0000000035094935ade28000`	`string`
`status`必填	收费单状态 0:待收 1:部分收 2:已收 3:部分退费 4:已退费示例：`0`	`integer`
`needPay`必填	应收金额示例：`100`	`number`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": "ffffffff0000000035094935b30b8000",
    "patientOrderId": "ffffffff0000000035094935ade28000",
    "status": 0,
    "needPay": 100
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查