接口文档 / 商品接口

新增商品

POST/api/v2/open-agency/products在线调试

请求参数

名称	说明	类型
Body 参数
`type`必填	商品类型 1:药品 2:物资 7:商品示例：`1`	`integer`
`subType`必填	商品子类型当 type 为 1 时 1:西药 2:中药 3:中成药当 type 为 2 时 1:医疗器械 2:后勤材料 3:固定资产当 type 为 7 时 1:自制成品 2:保健药品 3:保健食品 4:其他商品示例：`1`	`integer`
`medicineCadn`可选	商品通用名示例：`阿莫西林`	`string`
`name`可选	商品名, type为 1 ,subtype为 1 3 时可有值示例：`阿莫西林`	`string`
`shortId`可选	商品编码,系统生成或自定义	`string`
`cMSpec`可选	中药规格, type为 1,subtype为 2 时有值,值为[中药饮片\|中药颗粒] 示例：`中药饮片`	`string`
`dismounting`可选	拆零标识 0:不可拆零 1:可拆零, type 为 1，subType为 2 时值为 1 示例：`0`	`integer`
`extendSpec`可选	规格,type为 1，subType为 2可有值示例：`净制 0.5kg`	`string`
`materialSpec`可选	规格,type为 2 7可有值示例：`弹力型 70mm*18mm`	`string`
`manufacturer`可选	生产厂家示例：`北京同仁堂制药有限公司`	`string`
`medicineNmpn`可选	批准文号示例：`国药准字Z41020748`	`string`
`barCode`可选	条形码示例：`6920705211119`	`string`
`pieceNum`可选	最小包装数量, type为 1，subType为 2 时值为 1	`integer`
`pieceUnit`可选	最小包装单位示例：`片`	`string`
`packageUnit`可选	包装单位示例：`盒`	`string`
`componentContentUnit`可选	容量单位, tpe为 1,subType为 1，3时可有值	`string`
`componentContentNum`可选	容量数量, tpe为 1,subType为 1，3时可有值	`number`
`medicineDosageNum`可选	成分含量数量, tpe为 1,subType为 1，3时可有值	`number`
`medicineDosageUnit`可选	成分含量单位, tpe为 1,subType为 1，3时可有值	`string`
`piecePrice`可选	拆零价格示例：`1`	`number`
`packagePrice`可选	零售价格示例：`10`	`number`
`operatorId`必填	操作人ID 示例：`00000000000000000000000000000000`	`string`

请求示例

json

{
  "type": 1,
  "subType": 1,
  "medicineCadn": "阿莫西林",
  "name": "阿莫西林",
  "shortId": "string",
  "cMSpec": "中药饮片",
  "dismounting": 0,
  "extendSpec": "净制 0.5kg",
  "materialSpec": "弹力型 70mm*18mm",
  "manufacturer": "北京同仁堂制药有限公司",
  "medicineNmpn": "国药准字Z41020748",
  "barCode": 6920705211119,
  "pieceNum": 0,
  "pieceUnit": "片",
  "packageUnit": "盒",
  "componentContentUnit": "string",
  "componentContentNum": 0,
  "medicineDosageNum": 0,
  "medicineDosageUnit": "string",
  "piecePrice": 1,
  "packagePrice": 10,
  "operatorId": "00000000000000000000000000000000"
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`cmspec`可选		`string`
`id`可选	商品ID	`string`
`medicineCadn`可选	商品通用名示例：`阿莫西林`	`string`
`name`可选	商品名示例：`阿莫西林`	`string`
`type`可选	商品类型 1:药品 2:物资 7:商品示例：`1`	`integer`
`subType`可选	商品子类型当 type 为 1 时 1:西药 2:中药 3:中成药当 type 为 2 时 1:医疗器械 2:后勤材料 3:固定资产当 type 为 7 时 1:自制成品 2:保健药品 3:保健食品 4:其他商品示例：`1`	`integer`
`typeId`可选	系统分类ID 示例：`1`	`integer`
`typeName`可选	系统分类名称示例：`药品`	`string`
`customTypeId`可选	自定义分类ID 示例：`213`	`string`
`customTypeName`可选	自定义分类名称示例：`抗生素`	`string`
`manufacturer`可选	生产厂家示例：`拜耳`	`string`
`medicineNmpn`可选	国药准字示例：`H20000001`	`string`
`barCode`可选	条形码	`string`
`extendSpec`可选	规格,type为 1，subType为 2可有值示例：`净制 0.5kg`	`string`
`materialSpec`可选	规格,type为 2 7可有值示例：`弹力型 70mm*18mm`	`string`
`pieceUnit`可选	制剂单位示例：`支`	`string`
`pieceNum`可选	制剂数量（10支/盒中的10）示例：`10`	`number`
`piecePrice`可选	制剂单价示例：`10.5`	`number`
`packageUnit`可选	包装单位示例：`盒`	`string`
`packagePrice`可选	包装单价示例：`105`	`number`
`shortId`可选	药品编码示例：`K1001`	`string`
`displaySpec`可选	规格: 组装好的格式示例：`1ml:0.5mg*10支/盒`	`string`
`displayName`可选	名称：组织名称示例：`醋酸泼尼松片(华意)`	`string`
`status`可选	商品状态 1:正常 99:删除示例：`1`	`integer`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "cmspec": "string",
    "id": "string",
    "medicineCadn": "阿莫西林",
    "name": "阿莫西林",
    "type": 1,
    "subType": 1,
    "typeId": 1,
    "typeName": "药品",
    "customTypeId": 213,
    "customTypeName": "抗生素",
    "manufacturer": "拜耳",
    "medicineNmpn": "H20000001",
    "barCode": "string",
    "extendSpec": "净制 0.5kg",
    "materialSpec": "弹力型 70mm*18mm",
    "pieceUnit": "支",
    "pieceNum": 10,
    "piecePrice": 10.5,
    "packageUnit": "盒",
    "packagePrice": 105,
    "shortId": "K1001",
    "displaySpec": "1ml:0.5mg*10支/盒",
    "displayName": "醋酸泼尼松片(华意)",
    "status": 1
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查