1范围
本规范规定了粤港澳大湾区临床急需进口药械流通管理系统数据采集接口的要求，包括进口信息、发货信息、收货信息、库存盘点信息、使用信息接口的内容与格式要求。
本规范适用于需要与粤港澳大湾区临床急需进口药械流通管理系统数据采集接口开展对接的药品与医疗器械企业内部信息化系统设计、开发、测试与实施。
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T 2659-2000 世界各国与地区名称代码
国家药品监督管理局信息化标准NMPAB/T 1006—2019
下列术语与定义适用于本文件。
指广东省行政区域内广州、深圳、珠海、佛山、惠州、东莞、中山、江门、肇庆九个城市。
指经广东省相关主管部门审核，允许在内地九市指定医疗机构进口使用的临床急需、已在港澳地区上市的药品或港澳公立医院已采购使用、具有临床应用先进性的医疗器械。
依法取得药品/医疗器械经营许可证与进出口经营资质，承担急需港澳药械进口、贮存与配送等活动的企业，可通过数据采集接口上传数据文件，也可以使用实名核验的广东省统一登陆认证平台账号，登录广东智慧食药监企业专属网页对已上报的业务数据查询与处理。
经广东省卫生健康主管部门审核确认，具备相关条件，被授权可进口与使用急需港澳药械的医疗机构，可通过数据采集接口上传数据文件，也可以使用实名核验的广东省统一登陆认证平台账号，登录广东智慧食药监企业专属网页对已上报的业务数据查询与处理。
用于实现药械经营企业、指定医疗机构与粤港澳大湾区临床急需进口港澳药械流通管理系统之间数据自动采集、上传、校验与反馈的数据交互接口。
接入单位包括药械经营企业及指定医疗机构。
指由广东省药品监督管理局面向药品、医疗器械、化妆品相关企业及从业人员设立的专属业务服务入口，该网页提供统一的登录访问渠道，具备办理待办事项、接收消息通知、开展业务办理、开展数据报送与查询、管理企业档案等功能，为企业及从业人员提供高效、便捷、集成化的业务服务。
由接入单位自行建设，实现临床急需进口港澳药械流通数据采集、管理与报送等功能的信息化系统。
指为急需港澳药械赋予的唯一标识代码，以此实现药械采购、进口、贮存、配送、使用等全过程信息追溯与监管。
由省药品监督管理部门核发的，允许指定医疗机构进口与使用特定急需港澳药械的批准文件。
粤港澳大湾区临床急需进口药械流通管理系统数据采集接口以粤港澳大湾区临床急需进口药械流通管理系统与接入单位内部信息化系统之间的药械追溯数据交换为应用场景，粤港澳大湾区临床急需进口药械流通管理系统是数据接口服务的提供方，粤港澳大湾区内药械经营企业、指定医疗机构内部信息化系统是接口服务的调用方。
粤港澳大湾区临床急需进口药械流通管理系统开放了丰富的能力接口，开发者可以借助接口能力，实现临床急需港澳药械追溯数据文件上传、文件处理情况查询等功能。
接口需使用HTTPS协议、JSON数据格式、UTF8编码，接口说明格式如下：
... 请求说明 请求方式：GET/POST（HTTPS） 请求地址：https://qy.gdfda.gov.cn/{drugdwqreport|equipmentdwqreport}/{请求入口} 请求参数说明 ... 请求参数示例 ... 响应参数说明 ... 响应参数示例 ... |
1. 接口说明，描述接口的功能与使用场景。
2. 请求说明，包括请求方式与请求地址。
请求方式：标注清楚接口调用的HTTP方法，区分Get/Post请求。所有的请求都为HTTPS协议。
请求地址：参数中使用大括号标注的为需要替换的变量。在上面的例子中{请求入口}为需要替换的变量，按照实际获取值更新。假如，这里我们调用上传药品进口信息的接口upload.do，那么上述的请求在发送时为：
https://qy.gdfda.gov.cn/drugdwqreport/public/source/upload.do |
3. 请求参数说明/请求参数示例，标注清楚请求参数示例及说明，参数说明包括字段含义、取值范围，调用方在设计数据结构时，应参考该定义范围。
4. 响应参数说明/响应参数示例，标注清楚响应参数示例及说明。特别留意，所有接口响应包里都有resultCode、resultText。调用方需按照resultCode是否为0判断是否调用成功（resultCode意义请见全局响应编码）。而resultText仅作参考，后续可能会有变动，因此不可作为是否调用成功的判据
使用的基本数据类型定义见表1，应对接口传输消息中的文本内容开展限定。
表1基本数据类型定义说明
类型名称 | 类型描述 | 示例 |
文本 | 文本类型，内容为所有有效字符 | "userName":"张山" |
数字 | 数字类型，内容为从0-9的数字字符，以+-表示符号 | "age":"24" |
布尔 | 布尔类型，内容为True与False两个值 | "sfcl":"True" |
日期 | 日期类型，通过YYYY-MM-DD表示 | "birthday":"1983-12-05" |
时间 | 时间类型，通过YYYY-MM-DD HH:mm:ss表示 | "createTime":"1983-12-05 13:05:00" |
二进制 数据 | Base64编码二进制类型，通过64个可打印字符表示二进制数据，用于文件与图片的传输 | "fileContents":"5bm/5bee5biC6aOf55So5Yac5Lqn5ZOB5L+h5oGv6L+95rqv5bmz5Y+w" |
集合 | 集合类型，每一项均为一个子数据项，子数据项编码方式与整个报文编码方式一致。 | "data":[{"key":12},{"key":22}] |
药械经营企业及指定医疗机构需报送的数据见下表：
数据内容 | 药械经营企业 | 指定医疗机构 |
进口信息 | √ | |
发货信息（含退货发货） | √ | √ |
收货信息（含退货发货） | √ | √ |
库存盘点信息 | √ | √ |
使用信息 | √ |
1. 账号的初始化
登录一次企业专属网页，系统自动完成用户数据初始化，在[我的档案]菜单下获取上报的授权码（TOKEN）或发送相关授权申请值系统运营邮箱：liuji@caseeder.com获取授权码（TOKEN）。
2. 阅读技术文档
阅读本接口文档，了解系统开发范围及相关业务、技术细节。
为实现与数据采集接口对接，企业内部系统需要实现的主要功能如下：
l标准HTTPS数据通讯；
l企业内部系统业务单据[进口、发货、收货、使用、库存等]，需按照接口规范要求以HTTPS标准格式整合数据文件；
l基于本接口规范文档调用相应的数据上报接口。
响应参数说明：
参数 | 是否必须 | 说明 | 数据类型 |
code | 是 | 操作状态代码： 0表示请求操作处理成功； 1表示身份验证失败，数字证书无效或未关联企业； 2表示系统繁忙； 3表示数据验证失败，缺少必须的请求参数或请求参数值无效。 | 数字 |
message | 是 | 操作状态描述，对操作结果的补充说明，成功则为空。 | 文本 |
data | 否 | 接口响应结果，按照接口不同有不同的定义，详见各功能响应说明。 | 集合 |
JSON格式响应示例：
{
"data":"",
"code":"0",
"message":"成功"
}
响应参数说明：
参数 | 是否必须 | 说明 | 数据类型 |
data | 否 | 结果数据集合，按照接口不同有不同的定义，详见各功能响应说明。 | 集合 |
dataId | 是 | 数据增量标识，下次请求时必选参数，仅用于标识结果数据增量信息。 | 数字 |
pageCount | 是 | 分页查询最大返回记录数，表示单次调用接口允许返回的结果数据集合[data]最大记录数量。 | 数字 |
total | 是 | 剩余未获取的记录数，系统按照传入的数据增量标识dataId计算仍需用户获取的数据集合[data]记录数，如total>=pageCount表示需继续获取数据。 | 数字 |
JSON格式响应示例[红色字体部分]：
{
"data":{
"data":[{ },{ }],
"dataId":"403",
"pageCount":100,
"total":2
},
"code":0,
"messge":""
}
数据采集接口接收的JSON数据文件分为进口信息、发货信息、收货信息、库存盘点信息、使用信息共5种业务类型。
各业务类型表单或明细条目属性描述中标记为[校验数据字段]的属性，表示应为药品标准数据或企业标准数据唯一标识。
请求地址：https://{域名}/drugdwqreport/public/source/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否 必填 | 备注 |
certificateNo | 字符型 | 批件号 | 50 | 是 | 批件号，基于省许可系统批件数据校验【校验数据字段】 |
ypname | 字符型 | 药品名称 | 200 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
dosageForm | 字符型 | 剂型 | 50 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
strength | 字符型 | 规格 | 50 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
packageSize | 字符型 | 包装规格 | 50 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
manufacturerName | 字符型 | 生产厂商 | 200 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
billId | 字符型 | 进口信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
produceDate | 字符型 | 生产日期 | 是 | 包装上标示的生产日期，不能晚于系统当前日期，格式“YYYY-MM-DD” | |
validDate | 字符型 | 有效期截止日期 | 是 | 有效期的截止日期，格式“YYYY-MM-DD” | |
batch | 字符型 | 生产批号 | 20 | 是 | 包装上标示的生产批号 |
num | 数值型 | 进口数量 | 8 | 是 | 同批号进口的最小销售包装总数量(需与追溯码总数一致)，需相较而言更多0的整数 |
importDate | 字符型 | 进口日期 | 是 | 进入仓库并完成赋码的日期，不能晚于系统当前日期，格式“YYYY-MM-DD” | |
file | 二进制 | 通关单扫描件 | 5M | 是 | 进口通关单扫描件，需小于5M |
suppilerType | 字典值 | 供货单位类型 | 1 | 是 | 进口的供货单位类型， 0：生产企业1：经销商 |
suppilerName | 字符型 | 供货单位名称 | 200 | 是 | 进口的供货单位名称 |
suppilerAddress | 字符型 | 供货单位地址 | 200 | 是 | 进口的供货单位地址 |
suppilerNation | 字符型 | 供货单位所属国家/地区 | 是 | 使用世界各国与地区名称代码，标准号：GB/T 2659-2000 | |
suppilerContact | 字符型 | 供货单位联系人 | 60 | 是 | 进口的供货单位联系人 |
suppilerTel | 字符型 | 供货单位联系电话 | 18 | 是 | 进口的供货单位联系电话 |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参“进口明细条目说明” |
进口追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否 必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码 |
superiorTraceCode | 字符型 | 上一级包装追溯码 | 200 | 否 | 当前追溯码大一级包装上的追溯码 |
traceLevel | 字符型 | 包装层级 | 200 | 是 | 当前追溯码所处包装层级描述 |
containNum | 数值型 | 包括最小销售包装单元数量 | 8 | 是 | 当前追溯码中包括的最小销售包装单元追溯码的数量，需相较而言更多0的整数 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/drugdwqreport/public/outstock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
uscid | 字符型 | 收货单位统一社会信用代码 | 18 | 条件必填 | 收货方的统一社会信用代码【校验数据字段】，发货类型为：03/05/07/09/11/12时，收货单位统一信用代码非必填 |
outBillId | 字符型 | 发货单编号 | 50 | 是 | 发货单上的编号【重复性校验数据字段】 |
orderBillId | 字符型 | 订货单编号 | 50 | 否 | 订货单上的编号 |
sendAddress | 字符型 | 发货地址 | 200 | 是 | 发货单上的发货地址 |
outStockType | 字典值 | 发货类型 | 2 | 是 | 发货类型对应的代码，见B1，发货类型为：99时，接口不允许上报 |
brokerage | 字符型 | 发货人 | 60 | 是 | 发货经办人的姓名 |
outStockDate | 字符型 | 发货时间 | 是 | 离开发货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
receiveAddress | 字符型 | 收货地址 | 200 | 是 | 发货单上的收货地址 |
checkStatus | 字典值 | 单据验证状态 | 1 | 是 | 发货单位在发货前确认 的货物与单据是否一致的状态 0：未验证 1：验证通过 2：验证未通过 |
checkDate | 字符型 | 单据验证日期 | 条件必选 | 单据验证状态验证日期，单据验证后必选；不能晚于系统当前日期，格式 “YYYY-MM-DD” | |
unPassReason | 字符型 | 单据验证未通过原因 | 200 | 条件必选 | 单据验证失败的原因，单据验证状态 为2时必选； |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参发货信息追溯码明细条目说明 |
发货信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/drugdwqreport/public/instock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
uscid | 字符型 | 发货单位统一社会信用代码 | 18 | 是 | 发货方的统一社会信用代码【校验数据字段】 |
inBillId | 字符型 | 收货单编号 | 50 | 是 | 收货单上的编号【重复性校验数据字段】 |
outBillId | 字符型 | 发货单编号 | 50 | 否 | 发货单上的编号 |
orderBillId | 字符型 | 订货单编号 | 50 | 否 | 订货单上的编号 |
outAddress | 字符型 | 发货地址 | 200 | 是 | 收货单上的发货地址 |
inStockType | 字典值 | 收货类型 | 2 | 是 | 收货类型对应的代码，见B2，收货类型为：03/06/08/99时，不允许上报 |
brokerage | 字符型 | 收货人 | 60 | 是 | 收货人姓名 |
inStockDate | 字符型 | 收货时间 | 是 | 到达收货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
receiveAddress | 字符型 | 收货地址 | 200 | 是 | 实际收货位置的地址 |
checkStatus | 字典值 | 单据验证状态 | 1 | 是 | 收货单位在收货时确认的货物与单据是否一致的状态 0：未验证； 1：验证通过； 2：验证未通过； |
checkDate | 字符型 | 单据验证日期 | 条件必选 | 单据验证状态验证日期，单据验证后必选；不能晚于系统当前日期，格式“YYYY-MM-DD” | |
unPassReason | 字符型 | 单据验证未通过原因 | 200 | 条件必选 | 单据验证失败的原因，单据验证状态 为2时必选； |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参“收货信息追溯码明细条目说明” |
收货信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/drugdwqreport/public/stock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
billId | 字符型 | 盘点信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
inventoryChecker | 字符型 | 盘点人 | 200 | 是 | 盘点人姓名 |
inventoryDate | 字符型 | 盘点时间 | 是 | 到达收货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | 详参“盘点信息追溯码明细条目说明” |
盘点信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/drugdwqreport/public/use/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
billId | 字符型 | 使用信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
outStockDate | 字符型 | 发药时间 | 是 | 发药的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
prescribeMan | 字符型 | 开方医师 | 200 | 否 | 开方医师的姓名 |
hairMedicineMan | 字符型 | 药品发药人 | 200 | 否 | 发药人的姓名 |
prescription | 字符型 | 病历号/门诊号 | 200 | 是 | 患者的病历号或者门诊号 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/drugdwqreport/public/archives.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
queryTime | 字符型 | 查询时间条件 | 是 | 查询在此时间之后创建或更新的批件信息, 格式“YYYY-MM-DD HH:mm:ss” |
返回值：
参数名称 | 类型 | 字段说明 | 备注 |
id | 数值型 | 主键 | |
ypname | 字符型 | 药品名称 | |
enName | 字符型 | 英文名称 | |
dosageForm | 字符型 | 剂型 | |
strength | 字符型 | 规格 | |
packageSize | 字符型 | 包装规格 | |
manufacturerName | 字符型 | 生产厂商 | |
status | 字符型 | 批件状态 | 0：正常，1已删除 |
updateTime | 字符型 | 更新时间 | 格式“YYYY-MM-DD HH:mm:ss” |
请求地址：https://{域名}/drugdwqreport/public/approvalarchives.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
queryTime | 字符型 | 查询时间条件 | 是 | 查询在此时间之后创建或更新的批件信息, 格式“YYYY-MM-DD HH:mm:ss” |
返回值：
参数名称 | 类型 | 字段说明 | 备注 |
id | 数值型 | 主键 | |
varietyName | 字符型 | 药品名称 | |
enName | 字符型 | 英文名称 | |
dosageForm | 字符型 | 剂型 | |
strength | 字符型 | 规格 | |
specifications | 字符型 | 包装规格 | |
manufacturerNameCN | 字符型 | 生产厂商 | |
approvalId | 字符型 | 批件号 | |
status | 字符型 | 批件状态 | 0：正常，1已删除 |
objectModificationTime | 字符型 | 更新时间 | 格式“YYYY-MM-DD HH:mm:ss” |
数据采集接口接收的JSON数据文件分为进口信息、发货信息、收货信息、库存盘点信息、使用信息共5种业务类型。
各业务类型表单或明细条目属性描述中标记为[校验数据字段]的属性，表示应为医疗器械标准数据或企业标准数据唯一标识。
请求地址：https://{域名}/equipmentdwqreport/public/source/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
certificateNo | 字符型 | 批件号 | 50 | 是 | 批件号，基于省许可系统批件数据校验【校验数据字段】 |
qxname | 字符型 | 医疗器械名称 | 200 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
model | 字符型 | 型号 | 50 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
strength | 字符型 | 规格 | 50 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
packageSize | 字符型 | 包装规格 | 50 | 否 | （如有该信息则）基于省许可系统批件数据校验【校验数据字段】 |
manufacturerName | 字符型 | 生产厂商 | 200 | 是 | 基于省许可系统批件数据校验【校验数据字段】 |
billId | 字符型 | 进口信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
produceDate | 字符型 | 生产日期 | 是 | 包装上标示的生产日期，不能晚于系统当前日期，格式“YYYY-MM-DD” | |
validDate | 字符型 | 有效期截止日期 | 是 | 有效期的截止日期，格式“YYYY-MM-DD” | |
batch | 字符型 | 生产批号 | 20 | 是 | 包装上标示的生产批号 |
num | 数值型 | 进口数量 | 8 | 是 | 同批号进口的最小销售包装总数量(需与追溯码总数一致)，需相较而言更多0的整数 |
importDate | 字符型 | 进口日期 | 是 | 进入经营企业仓库并完成赋码的日期，不能晚于系统当前日期，格式“YYYY-MM-DD” | |
file | 二进制 | 通关单扫描件 | 5M | 是 | 进口通关单扫描件，需小于5M |
suppilerType | 字典值 | 供货单位类型 | 1 | 是 | 进口的供货单位类型， 0：生产企业1：经销商 |
suppilerName | 字符型 | 供货单位名称 | 200 | 是 | 进口的供货单位名称 |
suppilerAddress | 字符型 | 供货单位地址 | 200 | 是 | 进口的供货单位地址 |
suppilerNation | 字符型 | 供货单位所属国家/地区 | 是 | 使用世界各国与地区名称代码，标准号：GB/T 2659-2000 | |
suppilerContact | 字符型 | 供货单位联系人 | 60 | 是 | 进口的供货单位联系人 |
suppilerTel | 字符型 | 供货单位联系电话 | 18 | 是 | 进口的供货单位联系电话 |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参“进口明细条目说明” |
进口追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码 |
superiorTraceCode | 字符型 | 上一级包装追溯码 | 200 | 否 | 当前追溯码大一级包装上的追溯码 |
traceLevel | 字符型 | 包装层级 | 200 | 是 | 当前追溯码所处包装层级描述 |
containNum | 数值型 | 包括最小销售包装单元数量 | 8 | 是 | 当前追溯码中包括的最小销售包装单元追溯码的数量，需相较而言更多0的整数 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/equipmentdwqreport/public/outstock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
uscid | 字符型 | 收货单位统一社会信用代码 | 18 | 条件必填 | 收货方的统一社会信用代码【校验数据字段】，发货类型为：03/05/07/09/11/12时，收货单位统一信用代码非必填 |
outBillId | 字符型 | 发货单编号 | 50 | 是 | 发货单上的编号【重复性校验数据字段】 |
orderBillId | 字符型 | 订货单编号 | 50 | 否 | 订货单上的编号 |
sendAddress | 字符型 | 发货地址 | 200 | 是 | 发货单上的发货地址 |
outStockType | 字典值 | 发货类型 | 2 | 是 | 发货类型对应的代码，见B1，发货类型为：99时，接口，不允许上报 |
brokerage | 字符型 | 发货人 | 60 | 是 | 发货经办人的姓名 |
outStockDate | 字符型 | 发货时间 | 是 | 离开发货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
receiveAddress | 字符型 | 收货地址 | 200 | 是 | 发货单上的收货地址 |
checkStatus | 字典值 | 单据验证状态 | 1 | 是 | 发货单位在发货前确认 的货物与单据是否一致的状态 0：未验证； 1：验证通过 2：验证未通过 |
checkDate | 字符型 | 单据验证日期 | 条件必选 | 单据验证状态验证日期，单据验证后必选；不能晚于系统当前日期，格式 “YYYY-MM-DD” | |
unPassReason | 字符型 | 单据验证未通过原因 | 200 | 条件必选 | 单据验证失败的原因，单据验证状态 为2时必选； |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参发货信息追溯码明细条目说明 |
发货信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/equipmentdwqreport/public/instock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
uscid | 字符型 | 发货单位统一社会信用代码 | 18 | 是 | 发货方的统一社会信用代码【校验数据字段】 |
inBillId | 字符型 | 收货单编号 | 50 | 是 | 收货单上的编号【重复性校验数据字段】 |
outBillId | 字符型 | 发货单编号 | 50 | 否 | 发货单上的编号 |
orderBillId | 字符型 | 订货单编号 | 50 | 否 | 订货单上的编号 |
outAddress | 字符型 | 发货地址 | 200 | 是 | 收货单上的发货地址 |
inStockType | 字典值 | 收货类型 | 2 | 是 | 收货类型对应的代码，见B2，收货类型为：03/06/08/99时，不允许上报 |
brokerage | 字符型 | 收货人 | 60 | 是 | 收货人姓名 |
inStockDate | 字符型 | 收货时间 | 是 | 到达收货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
receiveAddress | 字符型 | 收货地址 | 200 | 是 | 实际收货位置的地址 |
checkStatus | 字典值 | 单据验证状态 | 1 | 是 | 收货单位在收货时确认的货物与单据是否一致的状态 0：未验证； 1：验证通过； 2：验证未通过； |
checkDate | 字符型 | 单据验证日期 | 条件必选 | 单据验证状态验证日期，单据验证后必选；不能晚于系统当前日期，格式“YYYY-MM-DD” | |
unPassReason | 字符型 | 单据验证未通过原因 | 200 | 条件必选 | 单据验证失败的原因，单据验证状态 为2时必选； |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | JSON字符串，详参“收货信息追溯码明细条目说明” |
收货信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/equipmentdwqreport/public/stock/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
billId | 字符型 | 盘点信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
inventoryChecker | 字符型 | 盘点人 | 200 | 是 | 盘点人姓名 |
inventoryDate | 字符型 | 盘点时间 | 是 | 到达收货单位的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
traceDetails | 字符型 | 追溯码明细数据集 | 是 | 详参“盘点信息追溯码明细条目说明” |
盘点信息追溯码明细条目说明：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/equipmentdwqreport/public/use/upload.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
billId | 字符型 | 使用信息编号 | 50 | 是 | 用于校验是否重复推送【重复性校验数据字段】 |
traceCode | 字符型 | 追溯码 | 200 | 是 | 用于唯一标识各级销售包装单元的代码【校验数据字段】 |
outStockDate | 字符型 | 使用时间 | 是 | 使用的时间，不能晚于系统当前日期，格式“YYYY-MM-DD HH:mm:ss” | |
prescribeMan | 字符型 | 使用医师 | 200 | 否 | 使用医师的姓名 |
prescription | 字符型 | 病历号/门诊号 | 200 | 是 | 患者的病历号或者门诊号 |
返回结果成功示例：
{"code":0,"message":"成功"}
返回结果失败示例：
{"code":-1,"message":"失败"}
请求地址：https://{域名}/equipmentdwqreport/public/archives.do
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
queryTime | 字符型 | 查询时间 条件 | 是 | 查询在此时间之后创建或更新的批件信息,格式“YYYY-MM-DD HH:mm:ss” |
返回值：
参数名称 | 类型 | 字段说明 | 备注 |
id | 数值型 | 主键 | |
qxname | 字符型 | 器械名称 | |
enName | 字符型 | 英文名称 | |
model | 字符型 | 型号 | |
strength | 字符型 | 规格 | |
packageSize | 字符型 | 包装规格 | |
manufacturerName | 字符型 | 生产厂商 | |
status | 字符型 | 批件状态 | 0：正常，1已删除 |
updateTime | 字符型 | 更新时间 | 格式“YYYY-MM-DD HH:mm:ss” |
请求方法：post
请求头信息：token
请求值：
参数名称 | 类型 | 字段说明 | 最大长度 | 是否必填 | 备注 |
queryTime | 字符型 | 查询时间 条件 | 是 | 查询在此时间之后创建或更新的批件信息,格式“YYYY-MM-DD HH:mm:ss” |
返回值：
参数名称 | 类型 | 字段说明 | 备注 |
id | 数值型 | 主键 | |
varietyName | 字符型 | 医疗器械名称 | |
enName | 字符型 | 英文名称 | |
dosageForm | 字符型 | 型号 | |
strength | 字符型 | 规格 | |
specifications | 字符型 | 包装规格 | |
manufacturerNameCN | 字符型 | 生产厂商 | |
approvalId | 字符型 | 批件号 | |
status | 字符型 | 批件状态 | 0正常，1已删除 |
值 | 值含义 |
01 | 销售出库 |
02 | 供应出库 |
03 | 亏盘出库 |
04 | 退货出库 |
05 | 抽检出库 |
06 | 调拨出库 |
07 | 销毁出库 |
08 | 赠品出库 |
09 | 使用出库 |
10 | 召回出库 |
11 | 损坏出库 |
12 | 报废出库 |
99 | 其他 |
值 | 值含义 |
01 | 采购入库 |
02 | 退货入库 |
03 | 生产入库 |
04 | 调拨入库 |
05 | 赠品入库 |
06 | 盘盈入库 |
07 | 召回入库 |
08 | 报废入库 |
99 | 其他 |
环境 | 域名 |
练习环境 | https://lx.gdfda.gov.cn |
正式环境 | https://qy.gdfda.gov.cn |
[2] 《粤港澳大湾区临床急需进口药品流通管理系统数据采集接口开发指南》
_________________________________
1041
