1、 第 1 页九州通数据交换接口标准二 O一 O年十月第 2 页目 录1 简介 41.1 目的 .41.2 范围 .42 整体说明 42.1 名词解释 .42.2 文件说明 .42.2.1 监管平台到企业的交换报文 .42.2.2 企业到监管平台的交换报文 .53 数据下行接口 53.1 上游企业出库数据下载接口 .53.1.1 XML Schema 规范 53.1.2 XML Schema 规范中基础数据属性表 53.1.3 XML 报文示例 53.2 监管码关联关系数据下载接口 .73.2.1 XML Schema 规范 73.2.2 XML Schema 规范中基础数据属性表 103.2.
2、3 XML 报文示例 103.3 往来单位列表下载接口 .103.3.1 XML Schema 规范 113.3.2 XML Schema 规范中基础数据属性表 113.3.3 XML 报文示例 113.4 终端操作员下载接口 .123.4.1 XML Schema 规范 133.4.2 XML Schema 规范中基础数据属性表 133.4.3 XML 报文示例 144 数据上行接口 144.1 入出库全自动上传数据接口规范 .144.1.1 XML Schema 规范 154.1.2 XML Schema 规范中基础数据属性表 154.1.3 XML 报文示例 154.2 入出库业务数据接
3、口规范 .174.2.1 XML Schema 规范 184.2.2 XML Schema 规范中基础数据属性表 21第 3 页4.2.3 XML 报文示例 21第 4 页1 简介1.1 目的本文档的目的是制定大型物流企业进行企业出入库（核准、核销）数据、 监管码数据与中国药监网平台交互的文件接口的规范， 满足企业入库核注、出库核销操作的条码数据采集和数据上传的要求。1.2 范围 扫描终端范围支持任何可扫描药监码的设备 适用企业范围本文档适用企业包括经营企业。2 整体说明名词解释中国药品电子监管码：最小销售单元（包装）的药监码。2.2 文件说明此规范只涉及以下几类文件：2.2.1 监管平台到企
4、业的交换报文报文 报文编号 文件命名规则上游企业出库数据信息接口 DRUG02发货企 业编号 _单据类型 _出库单号_出库时间.xml监管码关联关系数据信息接口 DRUG04发货企 业编号 _单据类型 _出库单号_出库时间_Relation.xml第 5 页往来单位列表信息接口 DRUG06 Customers.xml操终端作员信息接口 DRUG08 Accounts.xml药品目录信息接口 DRUG10 Products.xml药品监管码基本信息接口 DRUG12 CodeProfile.xml入网企业基本信息 DRUG14 EntBaseInfo.xml企业上传报文回执 DRUG00 报文
5、编 号_ 企业上传文件名 _Response.xml前置机接收到企业文件信息报文回执 DRUG99 报文编 号_ 企业上传文件名 _Response.xml2.2.2 企业到监管平台的交换报文报文 报文编号 文件命名规则入出库全自动上传数据接口 DRUG01 单据类 型_ 入出库单号_入出库时间.xml入出库单业务数据接口 DRUG03 单据类 型_ 入出库单号_入出库时间_Code.xml往来单位信息接口 DRUG05 Customers_上传时间(yyyymmdd)_两位序号.xml企业订单信息接口 DRUG07 单据类 型_ 入出库单号_入出库时间_Bill.xml上游出库单确认入库接口
6、 DRUG09单据类 型_ 入库单号_入库时间_BillConfirm.xml3 数据下行接口上游企业出库数据下载接口该接口用于从企业客户端下载上游企业的出库数据,供下游企业入库进行比对。第 6 页3.1.1 XML Schema规范详见与批发企业数据交换接口标准.xsd定义。3.1.2 XML Schema规范中基础数据属性表类型 最大长度 举例 备注单据表头信息上传文件名称(uploadFileName)String 256 SalesWareHouseOut_10071256.xml上游企业上传单据的文件名称入出库单号(entStoreInOutId)String 20 AB0001入出
7、库时间(storeInOutDate)String 8 20101010 格式：YYYYMMDD入网企业序号(entSeqNo) String 32 00000000000000000132上游企业在电子监管网入网唯一序号入出库方式(dataType) String 32 SalesWareHouseOut ProduceWareHouseIn=生产入库PurchaseWareHouseIn=采购入库ReturnWareHouseIn=退货入库AllocateWareHouseIn=调拨入库SalesWareHouseOut=销售出库ReturnWareHouseOut=退货出库Allocat
8、eWareHouseOut=调拨出库RewordWareHouseOut=返工出库第 7 页DestoryWareHouseOut=销毁出库CheckWareHouseOut=抽检出库DirectAllocateWareHouseOut=直调出库销毁原因(destroyReason)String 512 特药单据销毁出库单的附属信息销毁监督人证件号(destroyCheckerCert)String 64 特药单据销毁出库单的附属信息销毁监督人(destroyChecker)String 64 特药单据销毁出库单的附属信息销毁执行人证件号(destroyActorCert)String 64
9、特药单据销毁出库单的附属信息销毁执行人(destroyActor)String 64 特药单据销毁出库单的附属信息承运方(trafficker) String 80 特药单据销售出库单的运输信息押运凭证号(escortVoucher)String 40 特药单据销售出库单的运输信息押运责任人(escort) String 20 特药单据销售出库单的运输信息押运责任人证件号(escortNo)String 40 特药单据销售出库单的运输信息运输距离方式(distantType)String 1 a 特药单据销售出库单的运输信息a:跨省 b:省内 c:市内运输方式(trafficType ) St
10、ring 1 1 特药单据销售出库单的运输信息1 -公路运输 2 -铁路运输 3-航空运输 4 -水路运输 5-综合运输方式预计到达时间(arriveDays)String 22 10 特药销售出库单的运输信息(以天为单位)是否特批(isSpecially ) String 1 特药单据销售出库单的特批信息Y:是，N: 否特批原因(speciallyNotes)String 512 特药单据销售出库单的特批信息上传时间(crtDate) String 8 20100101 单据上传时间第 8 页处理时间(dealDate) String 8 20100101 单据处理时间扩展字段1(exten
11、dField1)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 支/盒（
12、或盒 50 支）制剂单位(prenUnit) String 512 支包装单位(pkgUnit) String 512 盒生产企业名称(productEntName)String 100 华兰生物制药有限公司最小包装单位的药品数量(leastPkgAmount)String 18 100000最小包装单位包含制剂数量(leastMeasureAmount)String 18 50生产批号(produceBatchNo) String 20 20080101-001生产日期(produceDate ) String 8 20080101/200809 生产日期格式目前有 2种：YYYYMMDD/
13、YYYYMM失效日期(validEndDate) String 8 20100801/200809 失效日期格式目前有 2种：YYYYMMDD/YYYYMM扩展字段1( extendField1) String 512 预留字段监管码(code) String 20 监管码最长 20，特药存在 16位第 9 页3.1.3 XML报文示例SalesWareHouseOut_10071256.xml入出库单号入出库时间入网企业序号(上游企业)SalesWareHouseOut销毁原因销毁监督人证件号销毁监督人销毁执行人证件号销毁执行人承运方押运凭证号押运责任人押运责任人证件号运输距离方式：a:跨省
14、b: 省内c: 市内运输方式：1 -公路运输 2 -铁路运输 3-航空运输 4 -水路运输 5-综合运输方式/trafficType 10Y特批原因20100101 12:00:0320100101 12:00:03扩展字段1扩展字段2扩展字段30000000000000000002311感冒通制剂500ml感冒通第 10 页50支/盒（或盒50支）支盒华兰生物制药有限公司1000005020080101-0012008010120100801扩展字段18100005000000636141081000050000006388416810000500000064072033.2 监管码关联关系
15、数据下载接口该接口用于从企业客户端下载上游企业的出库数据中监管码对应的关联关系数据,供下游企业入库扫描时进行比对。详见 关联关系 XML Schema-3.0.xsd定义。3.2.1 XML Schema规范第 11 页各节点注释如下表：节点名称 节点含义 节点属性 下级节点 举例：Document 文档根节点 License:必选 EventsEvents Document子节 点，只可出现一次 version：版本号，默认 3.0，可选 EventEvent Events子节点，可出现多次，用于区分多种事件产生的数据，如：关联关系建立事件 Name 事件名称，必选 RelationRela
16、tion Event子节点，定义产品信息 produceCode：企业产品编码， 必选subTypeNo：企业产品子类编码，必选packageSpec：包装规格，必选cascade：包装比例，必选comment：扩展属性，可选BatchCodeBatch Relation子节 点，定义批号、生产日期、失效日期和生产线信息batchNo：企业 生产批号，必选madeDate：生 产日期，必选validateDate：失效日期，必 选workShop：工厂 车间名称，必选Code第 12 页lineName：生 产线名称，必选lineManager：生产线负责人，必选Code Relation子节
17、 点，定义具体的药监码属性和值 curCode：当前 码值，必选packLayer：包装层次，必选parentCode：父 码值，可选flag: 特殊标记: 0-正常,1-拼箱,2-零箱,3-即拼箱又零箱，必选第 13 页3.2.2 XML Schema规范中基础数据属性表详见规范中节点描述。3.2.3 XML报文示例第 14 页3.3 往来单位列表下载接口接口描述：该接口用于监管平台下载往来单位列表信息到企业。用于企业入出库时， 选择上游发货企业或者下游收货企业。文件名称 Customers.xml。3.3.1 XML Schema规范详见与批发企业数据交换接口标准.xsd定义。3.3.2
18、XML Schema规范中基础数据属性表类型 最大长度 举例 备注企业电子监管网入网序列号(entSeqNo)String 32 本企业电子监管网入网序列号往来单位对应的入网序号(refEntSeqNo)String 32 企业添加的往来单位对应的电子监管网入网序列号，如果是添加的非入网的往来单位，该字段为空:123444444444往来单位名称(partnerName)String 256 华东医药有限公司往来单位自定义编号(partnerId)String 32 ABC0001 企业对自己的往来单位的自定义编号往来单位类型(partnerType)String 2 3 往来单位类型：【1-
19、生产；2- 批 发；3-零售；4- 特殊企业; 5-第三方物流;6-使用单位】备注(notes ) String 512第 15 页联系人姓名(contactName)String 64 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空传真号码(faxNo) String 128 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空公司地址(address) String 256 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空电话号码(telNo) String 6
20、4 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空移动电话号码(mobileNo) String 32 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空邮编( postalCode) String 8 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空省份代码(provCode) String 8 430000 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空城市代码(cityCode) String 8 430600
21、自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空区县代码(areaCode) String 8 430602 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空省份描述(provDesc) String 256 湖南省 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空城市描述(cityDesc) String 256 湖南省岳阳市 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空区县描述(areaDesc) String
22、256 湖南省岳阳市岳阳楼区 自己新增的往来单位才会有这部分信息。如果是添加的已入网企业为 自己的往来单位，这部分信息为空第 16 页往来单位名称全拼(partnerCapitalName)String 256 HDYYYXGS往来单位状态(status)String 1 1 1:新增3.3.3 XML报文示例企业电子监管网入网序列号：123444444444企业添加的往来单位对应的电子监管网入网序列号，如果是添加的非入网的往来单位，该字段为空:123444444444 华东医药有限公司HDYY00012备注联系人姓名传真号码公司地址电话号码移动电话号码邮编430000430600430602
23、湖南省湖南省岳阳市湖南省岳阳市岳阳楼区HDYYYXGS1扩展字段1扩展字段2扩展字段3第 17 页3.4 终端操作员下载接口接口描述：该接口用于从药监平台下载手持终端操作员数据到手持终端。用于手持终端操作员登陆使用。文件名称 Accounts.xml。3.4.1 XML Schema规范详见与批发企业数据交换接口标准.xsd定义。第 18 页3.4.2 XML Schema规范中基础数据属性表类型 最大长度举例 备注操作员编号(operatorId)String 4 1234；操作员名称(name) String 10 10192;BJ001操作员密码(password) String 103
24、.4.3 XML报文示例0123xxx1231:男 0:女备注扩展字段1扩展字段2扩展字段33.5 药品监管码基本信息下载接口接口描述：该功能用于物流企业下载药监网入围企业的药品基本信息以及该药品产品编码信息。下载后，企业进行入出库操作 时，可以通过检索的方式查询产品编码对应的药品信息。第 19 页3.5.1 XML Schema规范详见与批发企业数据交换接口标准.xsd定义。3.5.2 XML Schema规范中基础数据属性表 类型 长度 备注药 品唯一 ID(prodSeqNo)字符 32药品类型(physicType)字符 30生产企业(produceEntName) 字符 256药品通
25、用名(physicName) 字符 256剂型(prepnDesc) 字符 64制剂规格(prepnSpec) 字符 256包装 规格( pkgSpec) 字符 64批准文号(licenseNo) 字符 64商品名( prodName) 字符 256药品本位码（sdcCode） 字符 30包装比例( pkgRatio) 字符 20包装级别(packageLevel) 字符 10第 20 页3.5.3 XML报文示例00000000000000321111注射用盐酸瑞芬太尼注射用盐酸瑞芬太尼特殊药品制剂冻干粉针2mg11111112222225支/盒宜昌人福药业有限责任公司国药准字H200301
26、993.6 企业上传报文回执接口描述：该接口用于把企业上传报文的接收情况、 处理情况以回执报 文的形式发往企业，供企 业查看，及时发现上传报文的问题 并做相 应的处理。第 21 页3.6.1 XML Schema规范详见与批发企业数据交换接口标准.xsd定义。3.6.2 XML Schema规范中基础数据属性表类型 最大长度举例 备注上传文件名(UploadFileName)String 256 SalesWareHouseOut_00025384_20100909.xml上传文件类型(UploadFileType)String 8 DRUG01 上传文件时间 (UploadFileTime)
27、String 8 20100910回执代码（Code） String 6 00 接收成功、01 接收失 败 、第 22 页02 处 理成功、03 处 理失败回执详细描述（Text） String 512 对回执内容的详细描述3.6.3 XML报文示例SalesWareHouseOut_00025384_20100909.xml DRUG012010091001该文件中的出库单号在药监系统中已存在，请修改后在上传3.7 前置机接收到企业订单信息报文回执接口描述：该接口用于前置机在接收到企业发送到前置机目录上的报文接收情况，以回执报文的形式发往企业，供企业查看，及时发现 企业 ERP与前置机间的通
28、讯情况，并做相应的处理。第 23 页3.7.1 XML Schema规范详见国药物流数据交换接口.xsd定义。3.7.2 XML Schema规范中基础数据属性表类型 最大长度 举例 备注上传文件名(UploadFileName)String 256 SalesWareHouseOut_00025384_20100909121212_Bill.xml上传文件大小(FileLength)String 32 1225 以 byte计算大小第 24 页上传文件类型(UploadFileType)String 8 DRUG07上传文件时间 (UploadFileTime)String 14 20100
29、910132832 精确到时分秒回执代码（Code） String 6 00 接收成功（前置机接收企业订单信息成功）回执详细描述（Text） String 512 对回执代码的详细描述3.7.3 XML报文示例SalesWareHouseOut_00025384_20100909121212_Bill.xml 125 DRUG072010091012131300已成功接收到文件4 数据上行接口入出库全自动上传数据接口规范该接口规范定义了企业全自动方式上传文件格式，上 传时 需要将数据按照接口规范整合成一个 XML文件，然后上传 到指定定目录下。第 25 页4.1.1 XML Schema规范生
30、成的业务数据 XML文件必须符合下述的 Schema规范，结构如下：详见与批发企业数据交换接口标准.xsd定义。4.1.2 XML Schema规范中基础数据属性表单据表头信息上传文件名称(uploadFileName)String 256 SalesWareHouseOut_10071256.xml上游企业上传单据的文件名称，参 见2.2章节描述规则入出库单号(entStoreInOutId)String 20 AB0001入出库时间(storeInOutDate)String 8 20101010 格式：YYYYMMDD入网企业序号(entSeqNo)String 32 000000000
31、00000000132 上游企业在电子监管网入网唯一序号货主自定义编号(agentId)String A000001 第三方物流企业对货主的自定义编号非第三方物流企业上传单据时，该字段不用填写。往来单位自定义编号(sendRecvPartnerId)String B00002 往来单位自定义编号往来单位所属单位(partnerIdType)String 标识该往来单位是第三方物流企业的往来单位，还是属于货主的往来 单位。非第三方物流企业上传单据时，该字段不用填写。第 26 页药品类型(drugType) String 1 2 药品类型： 1：特药2：普药一个单据特药、普药不能混合上 传入出库方
32、式(dataType) String 32 SalesWareHouseOut ProduceWareHouseIn=生产入库PurchaseWareHouseIn=采购入库ReturnWareHouseIn=退货入库AllocateWareHouseIn=调拨入库SalesWareHouseOut=销售出库ReturnWareHouseOut=退货出库AllocateWareHouseOut=调拨出库RewordWareHouseOut=返工出库DestoryWareHouseOut=销毁出库CheckWareHouseOut=抽检出库DirectAllocateWareHouseOut=直
33、调出库销毁原因(destroyReason)String 512 特药单据销毁出库单的附属信息销毁监督人证件号(destroyCheckerCert)String 64 特药单据销毁出库单的附属信息销毁监督人(destroyChecker)String 64 特药单据销毁出库单的附属信息销毁执行人证件号(destroyActorCert)String 64 特药单据销毁出库单的附属信息销毁执行人(destroyActor)String 64 特药单据销毁出库单的附属信息承运方(trafficker) String 80 特药单据销售出库单的运输信息押运凭证号(escortVoucher)Str
34、ing 40 特药单据销售出库单的运输信息押运责任人(escort) String 20 特药单据销售出库单的运输信息押运责任人证件号(escortNo)String 40 特药单据销售出库单的运输信息第 27 页运输距离方式(distantType)String 1 a 特药单据销售出库单的运输信息a:跨省 b:省内 c:市内运输方式(trafficType ) String 1 1 特药单据销售出库单的运输信息1 -公路运输 2 -铁路运输 3-航空运输 4 -水路运输 5-综合运输方式预计到达时间(arriveDays)String 22 10 特药销售出库单的运输信息(以天为单位)是否
35、特批(isSpecially ) String 1 特药单据销售出库单的特批信息Y:是，N: 否特批原因(speciallyNotes)String 512 特药单据销售出库单的特批信息上传时间(crtDate) String 8 20100101 单据上传时间，不用填写处理时间(dealDate) String 8 20100101 单据处理时间，不用填写扩展字段1(extendField1)String 512 预留字段扩展字段2(extendField2)String 512 预留字段扩展字段3(extendField3)String 512 预留字段单据表体信息Info string
36、监管码（Code）String 20 80000340099237713672 监管码数据操作人(Actor)String 12 Test01 可为空操作时间(ActDate)Date 19 2006-07-08 14:32:40 YYYY-MM-DD HH24:MI:SS第 28 页4.1.3 XML报文示例SalesWareHouseOut_10071256.xml入出库单号入出库时间入网企业序号A000001B0000211SalesWareHouseOut销毁原因销毁监督人证件号销毁监督人销毁执行人证件号销毁执行人承运方押运凭证号押运责任人押运责任人证件号运输距离方式：a:跨省b: 省内c: 市内运输方式：1 -公路运输 2 -铁路运输 3-航空运输 4 -水路运输 5-综合运输方式10Y特批原因20100101 12:00:0320100101 12:00:03扩展字段1扩展字段2扩展字段3第 29 页4.2 入出库业务数据接口规范该接口规范定义了手持终端内的入出库数据上传格式，上传时需要将数据按照接口规范整合成一个 XML文件。详见 终端接口 XML Schema-3.0.xsd定义。第 30 页4.2.1 XML Schema规范手持终端生成的业务数据 XML文件必须符合下述的 Schema规范，结构如下：
