接口文档 / 医联平台第三方门诊数据接口

修改第三方门诊收费单上传记录

POST/api/v2/open-agency/healthlink/third-party-outpatient/records/{patientOrderId}在线调试

请求参数

名称说明类型
Path 参数
patientOrderId必填

患者就诊单ID(patientOrderId)

string
Query 参数
taskId必填

医联平台任务ID

integer
Body 参数
id必填

收费单业务唯一标识;同一 taskId 下用于幂等识别

示例:third-charge-202609280001

string
patientOrderId必填

患者挂号ID

示例:third-register-202609280001

string
patientName必填

患者名称

示例:张三

string
doctorName必填

开单医生名称

示例:张医生

string
type可选

收费单类型:1挂号收费单、2门诊收费单、3零售开单等

示例:2

integer
status可选

收费单状态:0待收费、1已收费、2已退费、3部分退费

示例:1

integer
deliveryType可选

配送类型:0自取、1配送

示例:0

integer
isDraft可选

是否草稿:0否、1是

示例:0

integer
isOnline可选

是否线上单:0否、1是

示例:0

integer
isDecoction可选

是否代煎:0否、1是

示例:0

integer
isDeleted可选

是否删除:0否、1是

示例:0

integer
isClosed可选

是否关闭:0否、1是

示例:0

integer
totalFee可选

总费用

示例:51.66

number
receivableFee可选

应收费用

示例:51.66

number
receivedFee可选

实收费用

示例:51.66

number
refundFee可选

已退费用

示例:0

number
chargedTime可选

收费时间,支持 ISO-8601 或 yyyy-MM-dd HH:mm:ss(按 Asia/Shanghai 解释)

示例:2026-09-28T10:30:00Z

格式:date-time

string
firstChargedTime可选

首次收费时间,支持 ISO-8601 或 yyyy-MM-dd HH:mm:ss(按 Asia/Shanghai 解释)

示例:2026-09-28T10:30:00Z

格式:date-time

string
diagnosedDate可选

诊断时间,支持 ISO-8601 或 yyyy-MM-dd HH:mm:ss(按 Asia/Shanghai 解释)

示例:2026-09-28T10:00:00Z

格式:date-time

string
created必填

业务创建时间,支持 ISO-8601 或 yyyy-MM-dd HH:mm:ss(按 Asia/Shanghai 解释);医联平台按上报日期查询时使用

示例:2026-09-28T10:00:00Z

格式:date-time

string
diagnosis可选

诊断信息

示例:急性上呼吸道感染

string
chiefComplaint可选

主诉

示例:咳嗽三天

string

请求示例

json
{
  "id": "third-charge-202609280001",
  "patientOrderId": "third-register-202609280001",
  "patientName": "张三",
  "departmentInfo": {
    "departmentId": "third-department-001",
    "departmentName": "中医内科",
    "departmentType": 1,
    "departmentHead": "string",
    "caty": "string",
    "catyName": "string"
  },
  "doctorInfo": {
    "id": "third-doctor-001",
    "name": "张医生",
    "title": "string",
    "department": "string",
    "certno": "string",
    "practiceCertCode": "string",
    "credentials": "string",
    "shebaoDoctorCode": "string",
    "nationalDoctorCode": "string"
  },
  "doctorName": "张医生",
  "cashierInfo": {
    "id": "string",
    "name": "string",
    "certno": "string"
  },
  "type": 2,
  "status": 1,
  "deliveryType": 0,
  "isDraft": 0,
  "isOnline": 0,
  "isDecoction": 0,
  "isDeleted": 0,
  "isClosed": 0,
  "totalFee": 51.66,
  "receivableFee": 51.66,
  "receivedFee": 51.66,
  "refundFee": 0,
  "chargedTime": "2026-09-28T10:30:00Z",
  "firstChargedTime": "2026-09-28T10:30:00Z",
  "diagnosedDate": "2026-09-28T10:00:00Z",
  "created": "2026-09-28T10:00:00Z",
  "diagnosis": "急性上呼吸道感染",
  "chiefComplaint": "咳嗽三天",
  "patient": {
    "id": "third-patient-001",
    "name": "张三",
    "mobile": 13800138000,
    "countryCode": "+86",
    "sex": "男",
    "birthday": "1990-01-01",
    "age": {
      "year": 36,
      "month": 0,
      "day": 0
    },
    "idCardType": "身份证",
    "idCard": 310101199001010000,
    "ethnicity": "汉族",
    "nationality": "中国",
    "profession": "职员",
    "company": "string",
    "contactName": "string",
    "contactRelation": "string",
    "contactMobile": "string",
    "address": {
      "addressProvinceId": 310000,
      "addressProvinceName": "上海市",
      "addressCityId": 310100,
      "addressCityName": "上海市",
      "addressDistrictId": 310101,
      "addressDistrictName": "黄浦区",
      "addressDetail": "string",
      "fullAddress": "string",
      "addressPostcode": "string"
    }
  },
  "deliveryInfo": {
    "id": "string",
    "deliveryName": "string",
    "deliveryMobile": "string",
    "addressDetail": "string",
    "deliveryCompanyId": "string",
    "deliveryOrderNo": "string",
    "deliveryFee": 0
  },
  "shebaoPay": {
    "setlId": "string",
    "mdtrtId": "string",
    "psnNo": "string",
    "medType": "string",
    "insuplcAdmdvs": "string",
    "fundPaySumamt": 0,
    "acctPay": 0,
    "psnCashPay": 0,
    "allSelfpayAmt": 0,
    "preselfpayAmt": 0,
    "diagCode": "string",
    "diagName": "string",
    "doctorCode": "string",
    "doctorName": "string"
  },
  "chargeSheetSummary": {
    "totalFee": 0,
    "receivableFee": 0,
    "receivedFee": 0,
    "refundFee": 0,
    "registrationFee": 0,
    "westernMedicineFee": 0,
    "chineseMedicineFee": 0,
    "examinationTreatmentFee": 0,
    "materialFee": 0,
    "chargedTime": "2026-01-01T00:00:00Z"
  },
  "outpatient": {
    "id": "third-outpatient-001",
    "patientOrderId": "string",
    "patientOrderNo": 10001,
    "status": 0,
    "executeStatus": 0,
    "outpatientFrom": 0,
    "type": 0,
    "emergencyFlag": 0,
    "referralFlag": 0,
    "chargeStatus": 0,
    "registrationFee": 0,
    "totalFee": 0,
    "reserveDate": "2026-01-01T00:00:00Z",
    "diagnosedDate": "2026-01-01T00:00:00Z",
    "orderByDate": "2026-01-01T00:00:00Z",
    "created": "2026-01-01T00:00:00Z",
    "lastModified": "2026-01-01T00:00:00Z",
    "patient": {
      "id": "third-patient-001",
      "name": "张三",
      "mobile": 13800138000,
      "countryCode": "+86",
      "sex": "男",
      "birthday": "1990-01-01",
      "age": {
        "year": 36,
        "month": 0,
        "day": 0
      },
      "idCardType": "身份证",
      "idCard": 310101199001010000,
      "ethnicity": "汉族",
      "nationality": "中国",
      "profession": "职员",
      "company": "string",
      "contactName": "string",
      "contactRelation": "string",
      "contactMobile": "string",
      "address": {
        "addressProvinceId": 310000,
        "addressProvinceName": "上海市",
        "addressCityId": 310100,
        "addressCityName": "上海市",
        "addressDistrictId": 310101,
        "addressDistrictName": "黄浦区",
        "addressDetail": "string",
        "fullAddress": "string",
        "addressPostcode": "string"
      }
    },
    "doctor": {
      "id": "third-doctor-001",
      "name": "张医生",
      "title": "string",
      "department": "string",
      "certno": "string",
      "practiceCertCode": "string",
      "credentials": "string",
      "shebaoDoctorCode": "string",
      "nationalDoctorCode": "string"
    },
    "departmentInfo": {
      "departmentId": "third-department-001",
      "departmentName": "中医内科",
      "departmentType": 1,
      "departmentHead": "string",
      "caty": "string",
      "catyName": "string"
    },
    "medicalRecord": {
      "id": "string",
      "chiefComplaint": "string",
      "currentDiseaseHistory": "string",
      "pastHistory": "string",
      "personalHistory": "string",
      "allergyHistory": "string",
      "physicalExamination": "string",
      "preliminaryDiagnosis": "string",
      "diagnosis": "string",
      "diagnosisInfos": [
        {
          "code": "string",
          "name": "string",
          "hint": "string",
          "type": 0,
          "isMain": 0
        }
      ],
      "syndromes": [
        {
          "code": "string",
          "name": "string",
          "hint": "string",
          "type": 0,
          "isMain": 0
        }
      ],
      "therapy": "string",
      "treatmentOpinion": "string",
      "medicalAdvice": "string"
    },
    "prescriptionChineseForms": [
      {
        "id": "string",
        "name": "string",
        "type": 3,
        "doseCount": 0,
        "usage": "string",
        "freq": "string",
        "dailyDosage": "string",
        "usageDays": "string",
        "isDecoction": false,
        "chargeStatus": 0,
        "prescriptionFormItems": [
          {
            "id": "string",
            "goodsId": "string",
            "goodsName": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "specification": "string",
            "usage": "string",
            "dosage": "string",
            "freq": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "prescriptionWesternForms": [
      {
        "id": "string",
        "name": "string",
        "type": 3,
        "doseCount": 0,
        "usage": "string",
        "freq": "string",
        "dailyDosage": "string",
        "usageDays": "string",
        "isDecoction": false,
        "chargeStatus": 0,
        "prescriptionFormItems": [
          {
            "id": "string",
            "goodsId": "string",
            "goodsName": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "specification": "string",
            "usage": "string",
            "dosage": "string",
            "freq": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "prescriptionInfusionForms": [
      {
        "id": "string",
        "name": "string",
        "type": 3,
        "doseCount": 0,
        "usage": "string",
        "freq": "string",
        "dailyDosage": "string",
        "usageDays": "string",
        "isDecoction": false,
        "chargeStatus": 0,
        "prescriptionFormItems": [
          {
            "id": "string",
            "goodsId": "string",
            "goodsName": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "specification": "string",
            "usage": "string",
            "dosage": "string",
            "freq": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "prescriptionExternalForms": [
      {
        "id": "string",
        "name": "string",
        "type": 3,
        "doseCount": 0,
        "usage": "string",
        "freq": "string",
        "dailyDosage": "string",
        "usageDays": "string",
        "isDecoction": false,
        "chargeStatus": 0,
        "prescriptionFormItems": [
          {
            "id": "string",
            "goodsId": "string",
            "goodsName": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "specification": "string",
            "usage": "string",
            "dosage": "string",
            "freq": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "prescriptionForms": [
      {
        "id": "string",
        "name": "string",
        "type": 3,
        "doseCount": 0,
        "usage": "string",
        "freq": "string",
        "dailyDosage": "string",
        "usageDays": "string",
        "isDecoction": false,
        "chargeStatus": 0,
        "prescriptionFormItems": [
          {
            "id": "string",
            "goodsId": "string",
            "goodsName": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "specification": "string",
            "usage": "string",
            "dosage": "string",
            "freq": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "productForms": [
      {
        "id": "string",
        "chargeStatus": 0,
        "productFormItems": [
          {
            "id": "string",
            "productId": "string",
            "name": "string",
            "unitCount": 0,
            "unit": "string",
            "unitPrice": 0,
            "totalPrice": 0,
            "type": 0,
            "subType": 0,
            "purposeOfExamination": "string"
          }
        ],
        "totalPrice": 0
      }
    ],
    "curePlan": "string",
    "treatMeasure": "string",
    "observeRecord": "string"
  },
  "chargeForms": [
    {
      "id": "third-charge-form-001",
      "sourceFormId": "string",
      "sourceFormType": 1,
      "status": 1,
      "chargeFormItems": [
        {
          "id": "third-charge-item-001",
          "status": 1,
          "payStatus": 2,
          "name": "中药饮片调剂费",
          "medicineCadn": "string",
          "unit": "次",
          "unitCount": 1,
          "doseCount": 1,
          "unitPrice": 51.66,
          "totalPrice": 51.66,
          "receivedPrice": 51.66,
          "receivablePrice": 51.66,
          "productType": 1,
          "productSubType": 0,
          "productId": "string",
          "feeComposeType": 0,
          "feeTypeId": 0,
          "refundUnitCount": 0,
          "refundPrice": 0,
          "shebaoPayAmount": 0,
          "selfpayAmt": 0,
          "remark": "string"
        }
      ],
      "totalPrice": 51.66,
      "usageInfo": "string",
      "pharmacyNo": 0,
      "pharmacyType": 0
    }
  ],
  "diagnosisInfos": [
    {
      "code": "string",
      "name": "string",
      "hint": "string",
      "type": 0,
      "isMain": 0
    }
  ],
  "extendDiagnosisInfos": [
    {
      "diagnosisCode": "string",
      "diagnosisName": "string",
      "diagnosisType": 0,
      "isMain": 0
    }
  ],
  "additionalFees": [
    {
      "type": 0,
      "amount": 0
    }
  ]
}

响应参数

名称说明类型
Body 参数
data可选

数据

object
uploadDataId可选

医联平台上报数据ID

string
businessId可选

收费单业务ID

string
message可选

操作结果说明

string

响应示例

json
{
  "data": {
    "uploadDataId": "string",
    "businessId": "string",
    "message": "string"
  },
  "error": null
}

业务失败包装示意

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

查看 HTTP 状态与业务码排查

ABC 开放平台 · 诊所管家

如有疑问,请扫码加入企业微信群咨询。

企业微信群二维码
没有匹配结果

诊所管家