报文模式数据交换接口标准.docx
《报文模式数据交换接口标准.docx》由会员分享，可在线阅读，更多相关《报文模式数据交换接口标准.docx（54页珍藏版）》请在冰豆网上搜索。
报文模式数据交换接口标准
九州通数据交换接口标准
二O一O年十月
1简介4
1.1目的4
1.2范围4
2整体说明4
2.1名词解释4
2.2文件说明4
2.2.1监管平台到企业的交换报文4
2.2.2企业到监管平台的交换报文5
3数据下行接口5
3.1上游企业出库数据下载接口5
3.1.1XMLSchema规范5
3.1.2XMLSchema规范中基础数据属性表5
3.1.3XML报文示例5
3.2监管码关联关系数据下载接口7
3.2.1XMLSchema规范7
3.2.2XMLSchema规范中基础数据属性表10
3.2.3XML报文示例10
3.3往来单位列表下载接口10
3.3.1XMLSchema规范11
3.3.2XMLSchema规范中基础数据属性表11
3.3.3XML报文示例11
3.4终端操作员下载接口12
3.4.1XMLSchema规范13
3.4.2XMLSchema规范中基础数据属性表13
3.4.3XML报文示例14
4数据上行接口14
4.1入出库全自动上传数据接口规范14
4.1.1XMLSchema规范15
4.1.2XMLSchema规范中基础数据属性表15
4.1.3XML报文示例15
4.2入出库业务数据接口规范17
4.2.1XMLSchema规范18
4.2.2XMLSchema规范中基础数据属性表21
4.2.3XML报文示例21
1简介
1.1目的
本文档的目的是制定大型物流企业进行企业出入库（核准、核销）数据、监管码数据与中国药监网平台交互的文件接口的规范，满足企业入库核注、出库核销操作的条码数据采集和数据上传的要求。
1.2范围
·扫描终端范围
支持任何可扫描药监码的设备
·适用企业范围
本文档适用企业包括经营企业。
2整体说明
2
2.1名词解释
中国药品电子监管码：
最小销售单元（包装）的药监码。
2.2文件说明
此规范只涉及以下几类文件：
2.2.1监管平台到企业的交换报文
报文
报文编号
文件命名规则
上游企业出库数据信息接口
DRUG02
[发货企业编号]_[单据类型]_[出库单号]_[出库时间].xml
监管码关联关系数据信息接口
DRUG04
[发货企业编号]_[单据类型]_[出库单号]_[出库时间]_Relation.xml
往来单位列表信息接口
DRUG06
Customers.xml
操终端作员信息接口
DRUG08
Accounts.xml
药品目录信息接口
DRUG10
Products.xml
药品监管码基本信息接口
DRUG12
CodeProfile.xml
入网企业基本信息
DRUG14
EntBaseInfo.xml
企业上传报文回执
DRUG00
[报文编号]_[企业上传文件名]_Response.xml
前置机接收到企业文件信息报文回执
DRUG99
[报文编号]_[企业上传文件名]_Response.xml
2.2.2企业到监管平台的交换报文
报文
报文编号
文件命名规则
入出库全自动上传数据接口
DRUG01
[单据类型]_[入出库单号]_[入出库时间].xml
入出库单业务数据接口
DRUG03
[单据类型]_[入出库单号]_[入出库时间]_Code.xml
往来单位信息接口
DRUG05
Customers_[上传时间]（yyyymmdd）]_[两位序号].xml
企业订单信息接口
DRUG07
[单据类型]_[入出库单号]_[入出库时间]_Bill.xml
上游出库单确认入库接口
DRUG09
[单据类型]_[入库单号]_[入库时间]_BillConfirm.xml
3数据下行接口
3
3.1上游企业出库数据下载接口
该接口用于从企业客户端下载上游企业的出库数据,供下游企业入库进行比对。
3.1.1XMLSchema规范
详见《与批发企业数据交换接口标准.xsd》定义。
3.1.2XMLSchema规范中基础数据属性表
类型
最大长度
举例
备注
单据表头信息
上传文件名称（uploadFileName）
String
256
上游企业上传单据的文件名称
入出库单号（entStoreInOutId）
String
20
AB0001
入出库时间（storeInOutDate）
String
8
20101010
格式：
YYYYMMDD
入网企业序号（entSeqNo）
String
32
00000000000000000132
上游企业在电子监管网入网唯一序号
入出库方式（dataType）
String
32
SalesWareHouseOut
ProduceWareHouseIn=生产入库
PurchaseWareHouseIn=采购入库
ReturnWareHouseIn=退货入库
AllocateWareHouseIn=调拨入库
SalesWareHouseOut=销售出库
ReturnWareHouseOut=退货出库
AllocateWareHouseOut=调拨出库
RewordWareHouseOut=返工出库
DestoryWareHouseOut=销毁出库
CheckWareHouseOut=抽检出库
DirectAllocateWareHouseOut=直调出库
销毁原因（destroyReason）
String
512
特药单据销毁出库单的附属信息
销毁监督人证件号（destroyCheckerCert）
String
64
特药单据销毁出库单的附属信息
销毁监督人（destroyChecker）
String
64
特药单据销毁出库单的附属信息
销毁执行人证件号（destroyActorCert）
String
64
特药单据销毁出库单的附属信息
销毁执行人（destroyActor）
String
64
特药单据销毁出库单的附属信息
承运方（trafficker）
String
80
特药单据销售出库单的运输信息
押运凭证号（escortVoucher）
String
40
特药单据销售出库单的运输信息
押运责任人（escort）
String
20
特药单据销售出库单的运输信息
押运责任人证件号（escortNo）
String
40
特药单据销售出库单的运输信息
运输距离方式（distantType）
String
1
a
特药单据销售出库单的运输信息
a:
跨省b:
省内c:
市内
运输方式（trafficType）
String
1
1
特药单据销售出库单的运输信息
1-公路运输2-铁路运输3-航空运输4-水路运输5-综合运输方式
预计到达时间（arriveDays）
String
22
10
特药销售出库单的运输信息（以天为单位）
是否特批（isSpecially）
String
1
特药单据销售出库单的特批信息
Y:
是，N:
否
特批原因（speciallyNotes）
String
512
特药单据销售出库单的特批信息
上传时间（crtDate）
String
8
单据上传时间
处理时间（dealDate）
String
8
单据处理时间
扩展字段1（extendField1）
String
512
预留字段
扩展字段2（extendField2）
String
512
预留字段
扩展字段3（extendField3）
String
512
预留字段
单据表体信息
药品唯一编号（prodSeqNo）
String
32
0000000000000000002311
通用名（physicName）
String
256
感冒通
剂型（prenUnitDesc）
String
256
制剂
规格（prepnSpec）
String
256
500ml
药品名称（prodName）
String
256
感冒通
包装规格（pkgSpec）
String
512
50支/盒（或盒50支）
制剂单位（prenUnit）
String
512
支
包装单位（pkgUnit）
String
512
盒
生产企业名称（productEntName）
String
100
华兰生物制药有限公司
最小包装单位的药品数量（leastPkgAmount）
String
18
100000
最小包装单位包含制剂数量（leastMeasureAmount）
String
18
50
生产批号（produceBatchNo）
String
20
生产日期（produceDate）
String
8
/200809
生产日期格式目前有2种：
YYYYMMDD/YYYYMM
失效日期（validEndDate）
String
8
/200809
失效日期格式目前有2种：
YYYYMMDD/YYYYMM
扩展字段1（extendField1）
String
512
预留字段
监管码（code）
String
20
监管码最长20，特药存在16位
3.1.3XML报文示例
xmlversion="1.0"encoding="UTF-8"?
>
--SampleXMLfilegeneratedbyXMLSpyv2007sp1-->
xsi=""xmlns:
xsd=""Version="3.0">
入出库单号
入出库时间
入网企业序号（上游企业）
SalesWareHouseOut
销毁原因
销毁监督人证件号
销毁监督人
销毁执行人证件号
销毁执行人
承运方
押运凭证号
押运责任人
押运责任人证件号
运输距离方式：
a:
跨省b:
省内c:
市内
运输方式：
1-公路运输2-铁路运输3-航空运输4-水路运输5-综合运输方式/trafficType>
10
Y
特批原因
12:
00:
03
12:
00:
03
扩展字段1
扩展字段2
扩展字段3
0000000000000000002311
感冒通
制剂
500ml
感冒通
50支/盒（或盒50支）
支
盒
华兰生物制药有限公司
100000
50
扩展字段1
3.2监管码关联关系数据下载接口
该接口用于从企业客户端下载上游企业的出库数据中监管码对应的关联关系数据,供下游企业入库扫描时进行比对。
详见《关联关系XML》定义。
3.2.1XMLSchema规范
各节点注释如下表：
节点名称
节点含义
节点属性
下级节点
举例：
Document
文档根节点
License:
必选
Events
Events
Document子节点，只可出现一次
version：
版本号，默认3.0，可选
Event
Event
Events子节点，可出现多次，用于区分多种事件产生的数据，如：
关联关系建立事件
Name事件名称，必选
Relation
Relation
Event子节点，定义产品信息
produceCode：
企业产品编码，必选
subTypeNo：
企业产品子类编码，必选
packageSpec：
包装规格，必选
cascade：
包装比例，必选
comment：
扩展属性，可选
Batch
Code
Batch
Relation子节点，定义批号、生产日期、失效日期和生产线信息
batchNo：
企业生产批号，必选
madeDate：
生产日期，必选
validateDate：
失效日期，必选
workShop：
工厂车间名称，必选
lineName：
生产线名称，必选
lineManager：
生产线负责人，必选
Code
Code
Relation子节点，定义具体的药监码属性和值
curCode：
当前码值，必选
packLayer：
包装层次，必选
parentCode：
父码值，可选
flag:
特殊标记:
0-正常,1-拼箱,2-零箱,3-即拼箱又零箱，必选
3.2.2XMLSchema规范中基础数据属性表
详见规范中节点描述。
3.2.3XML报文示例
xmlversion="1.0"encoding="utf-8"?
>
xsi=""xmlns:
xsd="">
10"packageSpec="袋4支"comment="">
3.3往来单位列表下载接口
接口描述：
该接口用于监管平台下载往来单位列表信息到企业。
用于企业入出库时，选择上游发货企业或者下游收货企业。
文件名称Customers.xml。
3.3.1XMLSchema规范
详见《与批发企业数据交换接口标准.xsd》定义。
3.3.2XMLSchema规范中基础数据属性表
类型
最大长度
举例
备注
企业电子监管网入网序列号
（entSeqNo）
String
32
本企业电子监管网入网序列号
往来单位对应的入网序号
（refEntSeqNo）
String
32
企业添加的往来单位对应的电子监管网入网序列号，如果是添加的非入网的往来单位，该字段为空:
往来单位名称（partnerName）
String
256
华东医药有限公司
往来单位自定义编号（partnerId）
String
32
ABC0001
企业对自己的往来单位的自定义编号
往来单位类型（partnerType）
String
2
3
往来单位类型：
【1-生产；2-批发；3-零售；4--特殊企业;5-第三方物流;6-使用单位】
备注（notes）
String
512
联系人姓名（contactName）
String
64
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
传真号码（faxNo）
String
128
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
公司地址（address）
String
256
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
电话号码（telNo）
String
64
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
移动电话号码（mobileNo）
String
32
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
邮编（postalCode）
String
8
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
省份代码（provCode）
String
8
430000
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
城市代码（cityCode）
String
8
430600
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
区县代码（areaCode）
String
8
430602
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
省份描述（provDesc）
String
256
湖南省
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
城市描述（cityDesc）
String
256
湖南省岳阳市
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
区县描述（areaDesc）
String
256
湖南省岳阳市岳阳楼区
自己新增的往来单位才会有这部分信息。
如果是添加的已入网企业为自己的往来单位，这部分信息为空
往来单位名称全拼（partnerCapitalName）
String
256
HDYYYXGS
往来单位状态
（status）
String
1
1
1:
新增
3.3.3XML报文示例
xmlversion="1.0"encoding="UTF-8"?
>
--SampleXMLfilegeneratedbyXMLSpyv2007sp1-->
xsi="nstance"xmlns:
xsd=""Version="3.0">
企业电子监管网入网序列号：
企业添加的往来单位对应的电子监管网入网序列号，如果是添加的非入网的往来单位，该字段为空:
华东医药有限公司
HDYY0001
2
备注
联系人姓名
传真号码
公司地址
电话号码
升级会员 