《{客户管理}某公司数据采集器客户端接口》由会员分享,可在线阅读,更多相关《{客户管理}某公司数据采集器客户端接口(38页珍藏版)》请在金锄头文库上搜索。
1、数据采集器客户端接口V3中信21世纪有限公司目 录1 简介31.1 目的31.2 范围32 整体说明32.1 名词解释32.2 药监码模型32.3 文件说明32.4 角色定义42.4.1 企业客户端42.4.2 往来单位42.4.3 委托客户(第三方物流专用)43 功能需求43.1 业务功能需求43.1.1 主要功能43.1.2 补充功能103.2 系统功能需求133.2.1 数据通讯133.2.2 系统设置153.2.3 数据删除184 数据下载接口184.1 终端操作员数据下载接口184.2 上游企业出库数据下载接口194.3 往来单位列表下载接口(第三方物流PDA专用)204.4 委托客
2、户列表下载接口(第三方物流PDA专用)204.5 药品产品编码信息下载接口(第三方物流PDA专用)215 业务数据上传接口225.1 接口规范225.1.1 XML Schema规范235.1.2 XML Schema规范中基础数据属性表315.2 接口示例326 文件传输规范396.1 文件大小396.2 文件拆分391 简介1.1 目的本文档的目的是分析药监项目中企业出入库(核准、核销)数据与中国药监网平台交互的文件接口的需求,满足企业入库核注、出库核销操作的条码数据采集和数据上传的要求。1.2 范围 扫描终端范围支持任何可扫描药监码的设备 适用企业范围本文档适用企业包括生产企业、经营企业
3、、第三方物流企业。2 整体说明2.1 名词解释中国药品电子监管码:最小销售单元(包装)的药监码包装药监码:外包装(中包装以上)的药监码包装级别:1级为最低级药监码,即产品药监码;2级为1级的上级包装码,依次类推。2.2 药监码模型药监码采用十六或二十位数字构成,采用Code 128C条码标识。2.3 文件说明企业按此规范要求提交文件到中国药监网平台。对于文件的产生机制,企业根据自身情况实现。此规范只涉及以下几类文件:1、平台下载到企业n 上游企业出库数据文件n 往来单位列表文件n 委托客户列表文件n 药品基本信息文件n 操作员信息文件2、企业上传到平台n 业务数据文件2.4 角色定义2.4.1
4、 企业客户端部署在企业,负责运行出入库系统。根据用户输入生成企业入库单和企业出库单,并将手持终端下载到PC的数据文件(.XML)保存到本地,加密后上传到药监网平台。支持企业入库单和企业出货单查询,带有用户系统。2.4.2 往来单位与企业发生往来业务关系的单位2.4.3 委托客户(第三方物流专用)指委托第三方物流进行仓储、药品配送的客户,一般是药品生产企业。3 功能需求3.1 业务功能需求业务功能分为三种:主功能、补充功能主功能:系统核心功能。补充功能,辅助性功能。3.1.1 主要功能3.1.1.1 核注入库功能描述:该功能用于企业入库核注。1、入库操作时,用户需首先需要选择入库种类(生产入库、
5、退货入库、购买入库、调拨入库)。2、如果用户选择退货入库、购买入库和调拨入库、且用户下载了上游企业的出库信息用来做入库数据对比。则用户首先需要扫描一个入库的药监码,终端根据该药监码显示该药品的上游企业名称、药品名称和生产批号。并将该药品的出库单作为当前的上游企业出库单号,然后进行第3步操作。如果对比药监码,没有发现任何匹配的上游企业出库单,则提示用户是否继续入库,如果用户选择“确认”,则直接执行第3,如果用户选择“取消“,则重复第2步 。如果用户未下载上游企业出库数据,则直接进行第3步操作。3、输入企业入库单号,之后根据系统设置该功能是否有附加功能,如果有,则输入附加功能所需关键数据,然后开始
6、扫描药监码,扫描中,关键数据出现变更时,如生产日期变更,则需要重新输入,然后继续扫描。为了防止用户输入错误的单号,系统要增加一次校验,当第一次输入确认后提示“请再次输入入库单号”,如果两次输入相同则进行后续操作,如果不同,则提示“两次输入的单号不一致,请重新输入”,用户按确认后回到该步骤起始处继续输入单号;如果两次输入相同,则判断输入的入库单号在终端的入库单数据库中是否已存在,如果存在则提示用户“该入库单号已经在xxxx.xx.xx xx:xx执行了入库扫描”,同时给出两个选项“重新输入”(默认)和“追加扫描”,如果选择重新输入则回到该步骤起始处,如果选择追加扫描则进行后续操作。注:追加扫描操
7、作的意思是指一个单子的货物分多次扫描。 xxxx.xx.xx xx:xx为时间格式,该时间为该单号起初扫描第一个码的时间4、设置药品类型。 药品类型包括:普药类型、特药类型、混合类型,系统自动读取设置中的药品类型; 系统设置为普药类型,则当前药品类型为普药类型,系统设置为特药类型,则当前药品类型为特药类型,系统设置为混合类型时,用户需再次选择药品类型(普药类型、特药类型)。 为满足一单据中仅包含一种药品类型的需求,扫描过程中需校验药监码是否匹配药品类型,如不匹配,则提示用户:“该码不符合当前药品类型,请重新扫描”,如匹配则继续扫描。(见4.1校验规则) 4.1校验规则:校验药监码类型时,可以根
8、据码长度以及编码规则判断。 4.1.1 码长度普药码长度均为20位;特药包含16、20位两种长度 4.1.2 标志位普药:药监码前两位为标志位-80或81或82或83或84或85或88;特药:16位特药药监码第一位为标志位1;20位特药药监码前两位为标志位-895、扫描时,如果用户执行了第二步,则需要根据扫描的药监码查找对比数据,并显示该码所代表的药品名称、生产批号、生产日期。对比中,发现错误提示如下:a) 扫描的码属于上游企业出库的药监码,但是该码不在当前的出库单内。则提示用户扫描“该码属于其他出库单”,并提示用户跳过该码。b) 扫描的码不属于上游企业出库的药监码,则提示用户“该码不属于任何
9、出库单”,并提示用户强制输入或者重新扫描。同时,强制入库的药监码需要在上传数据时做出标记,具体见4.2.1接口规范。6、用户如选择结束本次入库扫描。则返回输入企业入库单号界面。扫描完成后,软件需要显示此次扫描多少产品,表示本次入库完成。每次扫描的药监码软件需判断该药监码是否已经扫描过。如扫描过则报重码错误,用户确认后返回扫描界面继续扫描。重码判断在相同功能内判断,如生产入库,则在所有入库扫描的码中判断,入库扫描后,如果做出库扫描,则不算重码。每次扫描药监码时,系统需要检查剩余药监码容量,当容量小于设定阀值时,需要报警。每次扫描药监码时,系统需要判断扫描进入的药监码长度是否等于16位或20位数字
10、,如果不为其中一种情况,则提示用户扫描错误,并重新扫描。高端PDA专用需求:(第三方物流专用)物流企业输入出库单号时,系统需要显示出当前委托客户名称。如企业未设定当前委托客户,需要求企业输入当前委托客户。输入方式包括:1、检索方式,可通过客户名称、名称拼音简写进行模糊检索;2、可手工或者扫描输入委托客户的唯一编码,系统自动检索并进行填写。前置条件:无后置条件:入库数据导出到企业客户端。关键数据:入库种类、企业入库单编号、药监码、操作员编号、扫描时间、系统设置附加功能所需关键数据、上游企业出库数据。业务流程:3.1.1.2 核销出库功能描述:核销出库功能基本相同核注入库。区别在于用户首先需要选择
11、出库种类(销售出库、退货出库、残次品返工出库、调拨出库、销毁出库),然后输入的是企业的出货单号。没有上游企业对比功能。重码判断、系统容量判断、码长度判断同样包括在该功能内(该功能不在流程图中列出)。高端PDA专用需求:(增值服务、第三方物流专用)企业输入出库单号时,系统提供其输入收货方功能。用户可在其往来单位列表中通过模糊检索输入收货方。检索条件:收货方名称关键字,收货方名称拼音头字母简写。也可输入或者扫描收货方唯一编码,系统自动检索并进行输入。企业输入收货方后,系统须将该收货方编号记录,并写入上传业务数据中,具体位置和格式参加业务数据上传接口。如企业未导入往来单位列表,该字段可为空,等同于通
12、用核销出库流程。高端PDA专用需求:(第三方物流专用)物流企业输入出库单号时,系统需要显示出当前委托客户名称。如企业未设定当前委托客户,需要求企业输入当前委托客户。输入方式包括:1、检索方式,可通过客户名称、名称拼音简写进行模糊检索;2、可手工或者扫描输入委托客户的唯一编码,系统自动检索并进行填写。前置条件:无;关键数据:企业出货单编号、药监码、操作员编号、扫描时间、系统设置附加功能所需关键数据。后置条件:出库数据上传到PC客户端。业务流程图:输入企业出库单号步骤:为了防止用户输入错误的单号,在输入单号后系统要增加一次校验,当第一次输入确认后提示“请再次输入出库单号”,如果两次输入相同则进行后
13、续操作,如果不同,则提示“两次输入的单号不一致,请重新输入”,用户按确认后回到该步骤起始处继续输入单号;如果两次输入相同,则判断输入的出库单号在终端的出库单数据库中是否已存在,如果存在则提示用户“该出库单号已经在xxxx.xx.xx xx:xx执行了出库扫描”,同时给出两个选项“重新输入”(默认)和“追加扫描”,如果选择重新输入则回到该步骤起始处,如果选择追加扫描则进行后续操作。追加扫描操作的意思是指一个单号的货物分多次扫描。注:追加扫描操作的意思是指一个单子的货物分多次扫描。 xxxx.xx.xx xx:xx为时间格式,该时间为该单号起初扫描第一个码的时间设置药品类型。 药品类型包括:普药类
14、型、特药类型、混合类型,系统自动读取设置中的药品类型; 系统设置为普药类型,则当前药品类型为普药类型,系统设置为特药类型,则当前药品类型为特药类型,系统设置为混合类型时,用户需再次选择药品类型(普药类型、特药类型)。 为满足一单据中仅包含一种药品类型的需求,扫描过程中需校验药监码是否匹配药品类型,如不匹配,则提示用户:“该码不符合当前药品类型,请重新扫描”,如匹配则继续扫描。(见校验规则)校验规则:校验药监码类型时,可以根据码长度以及编码规则判断。 码长度普药码长度均为20位;特药包含16、20位两种长度 标志位-普药:药监码前两位为标志位-80或81或82或83或84或85或88;特药:16
15、位特药药监码第一位为标志位1;20位特药药监码前两位为标志位-893.1.2 补充功能3.1.2.1 用户登陆功能描述:该功能用于操作员在终端登陆。用户信息从用户档案文件中读取,获得该操作员的编号。关键数据:用户名、密码业务流程图:3.1.2.2 库存盘点功能描述:该功能用于企业盘点库存数据。操作员盘点前,需要首先输入盘点任务的编号(该编号可从企业客户端处通过建立盘点任务获得),然后通过扫描药监码进行盘点操作。盘点结束后,需要显示本次盘点扫描的药监码数量。重码判断、系统容量判断、码长度判断同样包括在该功能内(该功能不在流程图中列出)。关键数据:盘点任务编号、药监码、盘点数量业务流程图:3.1.2.3 药监码替换功能描述:该功能用于发生药监码损坏的情况下,将损坏码用中性码