详细设计-追溯服务平台-2018.01.10.doc

光明乳业全程追溯管控及追溯服务平台、产线赋码系统项目追溯服务平台-详细设计说明书 Prepared by 拟制夏习林、郭武、栗树亮Date日期2017-09-28Reviewed by 评审人王学栋Date日期2017-10-20Approved by批准刘鸣Date日期2017-10-31Revision Record 修订记录Date日期Revision Version修订版本Change Description修改描述Author作者2017-09-26V0.1初版郭武2017-09-28V0.2修订版夏习林2017-10-20V1.0修订版栗树亮2018-01-08V2.0终版刘鸣目录一、TTS系统详细设计说明书61 引言61.1 编写目的61.2 范围61.3 参考资料71.4 术语定义及说明72 设计总体架构73 功能模块实现设计83.1. 基础类设计83.1.1. BasePage83.2. 公用模块实现设计93.2.1 系统登录93.2.2 资料管理113.2.3 产品管理173.2.4 追溯码管理213.2.5 入出库管理273.2.6 流向查询363.2.7 预警管理413.2.8 报表统计503.2.9 稽查563.2.10 数据上报593.2.11 系统管理63二、TTS与WMS、PDM接口对接文档691 业务流程702 业务逻辑703 业务描述704 接口714.1 Token管理714.2 码替换接口724.3 单据上传接口724.4 重组关联关系上传接口764.5 重组的关联关系文件列表接口814.6 重组的关联关系文件下载接口824.7 重组关联关系文件状态更新接口824.8 库存校正接口834.9 单码流向查询接口84三、 PDM5.1软件详细设计说明书861 引言861.1 编写目的861.2 范围861.3 参考资料871.4 术语定义及说明872 设计总体架构893 功能模块实现设计903.1 基础类设计903.1.1 BasePage903.2 公用模块实现设计913.2.1 系统登录913.2.2 产品管理953.2.3 往来单位管理1003.2.4企业法人管理1053.2.5 托盘码管理1083.2.6 托盘关联关系管理1123.2.7 建立单据1163.2.8 出入库计划管理1223.2.9 货运统计报表1283.2.10 用户角色组织机构管理流程图1313.2.11 接口服务1323.3 数据表关系设计1333.3.1. 系统登陆相关表关系1333.3.2. 产品管理相关表关系1343.3.3. 关联关系队列相关表关系1353.3.4. 托盘管理相关表关系1363.3.5. 单据相关表关系1363.3.6. 计划单管理相关表关系137四、欢乐扫平台详细设计说明书1371.功能设计1381.1 企业门户1381.1.1 注册1391.1.2 产品1411.1.3 奖品1421.1.4 乐码1441.1.5 活动1451.1.6 礼品1491.1.7 订单1491.2 手机端1511.2.1 扫码中奖1521.2.2 积分商城1541.2.3 手机端-渠道用户1582 架构1602.1 消费者端1602.1.1 反向代理1602.1.2 Redis1612.1.3 数据库故障转移1612.1.4 队列1612.2 企业端1612.2.1 报表1622.2.2 NAS和Redis1622.2.3 负载均衡1623 安全设计1623.1 基础安全1623.1.1 网络层1623.1.2 应用层1643.1.3 主机层1653.1.4 数据层1653.2 应用安全1663.2.1 码加密1663.2.2 防破解1673.2.3 系统监控1673.2.4 微信及接口安全168一、TTS系统详细设计说明书1 引言1.1 编写目的本文档的目的旨在推动软件工程的规范化，使设计人员遵循统一的详细设计书写规范，节省制作文档的时间，降低系统实现的风险，做到系统设计资料的规范性和全面性，以利于系统的实现，测试，维护和版本升级等此阶段将在概要设计的基础上，进行系统的具体详细设计。在详细设计中，描述实现具体模块所涉及到的主要算法，数据结构，类的层次结构及调用关系，需要说明软件系统各个层次中的每个程序（每个模块或子程序）的设计考虑，以便进行编码和测试。因此详细设计说明书要达到如下一些目标：l 设计应该足够的详细，达到可以编写程序的水平l 重点模块的执行流程和数据库系统详细设计的描述l 项目组成员对代码结构，命名规范性的共识l 编码实现的基础1.2 范围本文档用于软件设计阶段的详细设计，他的依据是概要设计说明书，他为下一阶段源程序及测试服务，是其实现的指导依据。本文将在如下几个方面加以论述：各子系统的公用模块的实现设计，专用模块的实现设计，数据库实现设计，外部接口的实现设计以及角色授权的设计等。按照三层结构的布局，详细设计应该从如下三个方面进行：数据访问层设计：数据字典物理设计，基本表物理设计，中间表物理设计（报表设计）业务逻辑设计：接口数据设计，中间件设计，数据通信传输设计，角色授权设计和功能设计；UI设计：基础信息管理，托盘码管理，接口管理，单据管理，报表统计，系统管理。1.3 参考资料l 初步需求说明书；l 详细需求分析说明书；l 概要设计说明书；1.4 术语定义及说明l 出入库计划单：货物还未进行出库，只是描述理论上，计划上将要出库的数量，通常该单据由第三方系统通过接口产生。l 出入库单：实际的出入库业务产生的单据，通常由手持进行扫描出库。l 关联关系:将产品上的追溯码按包装比例关系形成树形关系结构的文件结构；2 设计总体架构3 功能模块实现设计1.1. 基础类设计1.1.1. BasePage1.1.1.1. 类设计类名称BasePage类功能页面基类，用于管理各页面的共同属性和方法的类属性protected IUserService UsersLogic属性功能对用户进行管理的业务类属性protected IOrganizeService OrganizeLogic属性功能对用户所属组织机构进行管理的业务类属性public IWareHouseOrderLogic WareHouseOrderLogic属性功能 对单据进行管理的业务类属性public IBetweenCompanyLogic BetweenCompanyLogic属性功能对往来单位进行管理的业务类属性 public string LastUrl属性功能客户端上次请求的页面属性 protected string LoginUserName属性功能当前的登陆名方法1：名称public static void _ShowMessage(string msg)功能消息框提示输入消息内容输出1.2. 公用模块实现设计3.2.1 系统登录模块编号8模块名称系统登录所属业务系统登录编写人TTS产品部完成时间2017年3.2.1.1 功能流程图3.2.1.2 功能描述功能类型登录验证功能描述提高系统的安全性前提业务无后继业务所有业务功能约束权限约束约束描述3.2.1.3 界面设计1) 基础信息处理动作编号动作名称动作描述8.0.1登录点击登录按钮提交数据到登录处理页面“login.Aspx”，数据验证成功后将转至管理页面。8.0.2重置将当前信息回复原先状态3.2.2 资料管理3.2.2.1 区域信息维护3.2.2.1.1 功能描述：用于设置系统中监管区域信息。可根据企业销售区域定义划分不同的区域类型及管理行政区域，用于控制企业的销售区域及用户的管理区域，TTS系统稽查及防伪窜货分析将根据企业设置的好管辖区域信息做防伪窜货判断分析，并提供相应报表数据。3.2.2.1.2 功能流程图3.2.2.1.3 界面设计3.2.2.2 企业级别维护3.2.2.2.1 功能描述：用于维护企业级别信息，将不同企业按照对应的企业级别信息进行分类划分，便于管理。如生产企业、流通企业、终端门店等；3.2.2.2.2 业务流程：3.2.2.2.3 界面设计3.2.2.3 企业信息维护3.2.2.3.1 概述：用于维护系统中所有的企业的信息。包括生产企业、印刷企业、流通企业、终端门店及与TTS系统做接口交互的企业等。不存在的企业上传数据时将无法上传并完成数据的解析操作；3.2.2.3.2 业务流程：3.2.2.3.3 界面设计3.2.2.4 用户管理3.2.2.4.1 概述：用于维护使用TTS系统的用户信息，用户是系统的登录凭证，TTS系统支持集团的域用户管理，即所有TTS系统用户必须为集团的域用户，确保使用系统的安全控制及账号的统一效注管理。3.2.2.4.2 业务流程：3.2.2.5 批次信息维护3.2.2.5.1 概述：用于查看、维护生产批次信息。3.2.2.5.2 业务流程：3.2.2.5.3 界面设计3.2.3 产品管理3.2.3.1 产品目录管理3.2.3.1.1 概述：用于维护系统产品的大类，即用于将新增的产品划分到指定的大类中，便于检索；例如药品目录可以是特殊药品、普通药品、OTC药品。乳制品可以是液态奶、奶粉、乳制品饮料等等。3.2.3.1.2 业务流程：3.2.3.1.3 界面设计3.2.3.2 产品信息维护3.2.3.2.1 概述：用于维护集团所生产的产品信息，产品信息包括产品编码、名称、库存单位、有效期等，产品信息支持宣传图定期变更，支持不同生产时间不同的产品宣传图，用于系统在防伪稽查时匹配正确的宣传图。3.2.3.2.2 业务流程：3.2.3.2.3 界面设计3.2.3.3 企业产品维护3.2.3.3.1 概述：用于指定生产企业所生产的产品，建立生产企业与产品的关联关系；3.2.3.3.2 业务流程：3.2.3.3.3 界面设计3.2.3.4 包装比例维护3.2.3.4.1 概述：维护产品的内外包装信息。使产品可按照指定比例进行包装与出库；3.2.3.4.2 业务流程：3.2.3.4.3 界面设计3.2.4 追溯码管理3.2.4.1 追溯码申请3.2.4.1.1 概述：用于企业生成指定规则的追溯码，用于包材印刷、下载；3.2.4.1.2 业务流程：3.2.4.1.3 界面设计3.2.4.2 追溯码查询3.2.4.2.1 概述：用于查询追溯码对应的产品、批号、父子码的关系信息，可实现查看查询的码所在的批次信息。用于实现追溯单码流向信息，包括原料到销售的各个环节信息及批次信息流向。用于实现正向与方向追溯产品质量信息；3.2.4.2.2 业务流程：3.2.4.2.3 页面设计3.2.4.3 追溯码导出3.2.4.3.1 概述：用于将生产批次数据按包装级别分别生产相应不同级别的码文件，方便用户查看相应批次的码信息；3.2.4.3.2 业务流程：3.2.4.3.3 页面设计3.2.4.4 码模糊查询3.2.4.4.1 概述用于处理追溯码码被部分损坏或记录不清楚时，可以通过通配符%或？来查询码。3.2.4.4.2 业务流程3.2.4.4.3 界面设计3.2.4.5 码规则管理3.2.4.5.1 概述用于配置符合企业生产要求的追溯码生成规则，供追溯码申请时选择使用，并生成相应规则的码文件。3.2.4.5.2 业务流程3.2.4.5.3 页面设计3.2.4.6 追溯码下载3.2.4.6.1 概述用于将在TTS系统申请的追溯码及对应的防伪码下载到本地，发给印刷企业或赋码系统进行赋码生产；重点是在TTS系统申请的码；3.2.4.6.2 业务流程3.2.4.6.3 页面设计3.2.5 入出库管理3.2.5.1 入出库上传监控3.2.5.1.1 概述用于检索监控系统处理手持上传的单据处理结果（成功、失败、等待），主要用于发现单据失败时失败单据的原因，可按失败原因进行单据检索，如：重复出库、缺少关联关系等，方便用于第一时间解决单据问题。3.2.5.1.2 业务流程3.2.5.1.3 页面设计3.2.5.2 关联关系上传监控3.2.5.2.1 概述用于监控关联关系文件解析状态及文件中追溯码存在的异常，可根据关联关系文件解析状态进行检索查询，如可检索关联关系文件有重复上传的码、无效的码（指的的当前关联关系文件的码在系统中存在，并且父码与系统中的父码不一致），可快速定位生产端的赋码问题信息；3.2.5.2.2 业务说明3.2.5.2.3 页面设计3.2.5.3 入出库任务单3.2.5.3.1 概述用于在TTS系统中创建入出库任务单，用于手持或其它终端设备进行扫描出库；3.2.5.3.2 业务流程3.2.5.3.3 页面设计3.2.5.4 入出库上传3.2.5.4.1 概述实现将TTS系统支持的关联关系文件、单据文件手动上传到平台并进行处理；3.2.5.4.2 业务流程3.2.5.4.3 页面设计3.2.5.5 入出库单维护3.2.5.5.1 概述系统解析手持上传的单据信息后，形成单据信息，支持按企业 、产品、单号等不同条件进行检索。3.2.5.5.2 业务流程3.2.5.5.3 页面设计3.2.5.6 上传文件成功列表3.2.5.6.1 概述提供查看所有上传到TTS的文件，包括单据、关联关系文件；支持文件下载；3.2.5.6.2 业务流程3.2.5.6.3 页面设计3.2.6 流向查询3.2.6.1 单码流向查询3.2.6.1.1 概述用于查看追溯码的单据流向信息；信息包括追溯码的基本信息及追溯码的发货流向的单据信息，实现码的正向追踪；追溯码流向查询信息包括：产品的基础信息、奶源信息（奶仓号，原奶批次号，原奶供应商，承运车辆车牌，到厂时间，原奶检测结果，过磅数量，卸奶时间，收奶线，奶仓定容情况，奶仓检测结果，原奶仓储存时间）、巴杀信息（原奶批次，预巴氏号，巴氏运行参数，巴氏起止时间，调奶数量，巴氏存储时间温度，入库时间）、配料列表（调奶量，配料批次号，配料罐号，白糖，稳定剂，原料批次，原奶批次号，投料温度，混料线号，混料时间，定容添加量，定容数量，定容指标）、基料巴氏（菌种活化时间，运行时间，基料巴杀批次，基料巴杀参数，菌种添加数量，添加时间，发酵罐号/数量）信息；根据追溯码可以找到原料信息，包括：原料批次号，原料名称，数量，供应商信息；3.2.6.1.2 业务流程3.2.6.1.3 页面设计3.2.6.2 产品批号流向3.2.6.2.1 概述用于查看指定企业、产品在指定生产时间范内的生产的产品的流向信息。3.2.6.2.2 业务流程3.2.6.2.3 页面设计3.2.6.3 入出库单查询3.2.6.3.1 概述用户根据输入的条件查询相对应的单据，查看单据的信息，单据类型，往来企业，开单企业，点击明细查看单据的产品信息以及单据所对应的码信息。3.2.6.3.2 业务流程3.2.6.3.3 页面设计3.2.6.4 入出库单明细查询3.2.6.4.1 概述用于查询单据的明细并统计当前页的单据信息，并可导出单据的明细。单据出库人员可根据此功能检查出库是否与实际货物一致；3.2.6.4.2 业务流程3.2.6.4.3 页面设计3.2.7 预警管理3.2.7.1 预警信息订阅3.2.7.1.1 概述用于系统管理人员设置系统用户接收的预警信息，使相应人员第一时间接收到系统异常并及时处理。3.2.7.1.2 业务流程3.2.7.1.3 页面设计3.2.7.2 区域过期产品3.2.7.2.1 概述用于统计指定区域内生产企业所库存产品的过期产品信息，支持预警信息订阅，是企业及时掌握了解库存信息，调整生产；3.2.7.2.2 业务流程3.2.7.2.3 页面设计3.2.7.3 企业过期产品3.2.7.3.1 概述用于统计指定企业（经销商）库存的产品信息，使企业及时调整库存减少积压。3.2.7.3.2 业务流程3.2.7.3.3 页面设计3.2.7.4 防伪查询预警3.2.7.4.1 概述用于统计防伪码被查询超过指定次数的信息，第一时间通知订阅者及时处理异常信息；3.2.7.4.2 业务流程3.2.7.4.3 页面设计3.2.7.5 码重复出库预警3.2.7.5.1 概述用于统计并检索同一码重复扫描出库的信息，用于判断是否是扫描出库错误或是生产时出现异常；3.2.7.5.2 业务流程3.2.7.5.3 页面设计3.2.7.6 码不存在预警3.2.7.6.1 概述用于统计出库的产品没有生产信息即没有上传关联关系，提示相关生产企业及时上传生产批次信息。3.2.7.6.2 业务流程3.2.7.6.3 页面设计3.2.7.7 出库数量预警3.2.7.7.1 概述用于统计任务单中扫描数量与实际出库数量不符的单据信息，即扫描上传的数量小于任务单的计划数量数量时，人工需要手工审核实际出库数量；3.2.7.7.2 业务流程3.2.7.7.3 页面设计3.2.7.8 关联关系重码预警3.2.7.8.1 概述用于统计同一个码在不同生产批次中，提示订阅者赋码生产存在问题并及时处理；3.2.7.8.2 业务流程3.2.7.8.3 页面设计3.2.7.9 多区域查询预警3.2.7.9.1 概述用于统计同一防伪码在不同区域查询，预警提示假货存在，订阅者需及早关注处理；3.2.7.9.2 业务流程3.2.7.9.3 页面设计3.2.8 报表统计3.2.8.1 防伪查询统计3.2.8.1.1 概述用于以图表方式按月统计防伪码被消费者查询的记录信息。3.2.8.1.2 业务流程3.2.8.1.3 页面设计3.2.8.2 异地查询日统计3.2.8.2.1 概述用于已图形统计防伪码在发货地与扫描地不同区域查询信息，达到监控防伪窜货的目的；3.2.8.2.2 业务流程3.2.8.2.3 页面设计3.2.8.3 扫描查询3.2.8.3.1 概述用于查询指定时间范围内（不可跨月）的消费者防伪查询记录信息，显示具体的查询地点，支持信息导出； 3.2.8.3.2 业务流程3.2.8.3.3 页面设计3.2.8.4 非法码查询统计3.2.8.4.1 概述用于统计消费者查询的码不存在于TTS系统中的信息，用图显示；3.2.8.4.2 业务流程3.2.8.4.3 页面设计3.2.8.5 假货码查询统计3.2.8.5.1 概述用于统计消费者查询的在TTS系统这设置为假货的码的查询记录信息；3.2.8.5.2 业务流程3.2.8.5.3 页面设计3.2.8.6 多区域查询统计3.2.8.6.1 概述用于统计消费者查询的防伪码在不同扫描地的查询信息，用于判断同一防伪码可能存在于不同的销售地区；3.2.8.6.2 业务流程3.2.8.6.3 页面设计3.2.9 稽查3.2.9.1 企业微信稽查3.2.9.1.1 概述用于微信公众号，通过手机扫描产品追溯码，判断产品是否有窜货，实现企业对窜货的管控。微信稽查用于企业稽查人员在线判断产品是否窜货，及时掌握市场流通状态。微信稽查是TTS系统通过微信服务号实现微信扫描追溯码，获取追溯码信息的手机扫描稽查功能，方便稽查管理。3.2.9.1.2 业务流程3.2.9.1.3 页面设计3.2.9.2 门店签到3.2.9.2.1 业务员数据结构I. 字段I. 名称I. 类型I. 说明II. idII. 编号II. int(11)II.III. openidIII. 微信openidIII. varchar(32)III.IV. realnameIV. 业务员姓名IV. varchar(16)IV.V. mobileV. 手机号V. varchar(11)V.VI. sexVI. 性别VI. tinyint(1)VI.VII. areaVII. 所属区域VII. int(11)VII.VIII.VIII.VIII.VIII.业务员微信绑定流程业务员打开微信公众号，从菜单进入业务员中心页面，提示绑定业务员账号。业务员输入手机号，姓名和手机验证码后经系统校验通过便可成功绑定微信。3.2.9.2.2 门店数据结构I. 字段I. 名称I. 类型I. 说明II. idII. 编号II. int(11)II.III. shop_nameIII. 门店名称III. varchar(32)III.IV. addressIV. 门店地址IV. varchar(64)IV.V. qrcodeV. 门店二维码V. varchar(6)V. 门店分配的唯一二维码，供业务员扫描签到VI. telVI. 门店联系方式VI. varchar(11)VI.VII. areaVII. 所属区域VII. int(11)VII.VIII. latVIII. 门店位置经度VIII. float(9,6)VIII.IX. lngIX. 门店位置纬度IX. float(9,6)IX.门店二维码分配流程门店注册需要先在系统录入门店信息，录入后可以为门店分配一个二维码，二维码由业务员在店铺现场激活，系统会记录下二维码的激活位置，作为以后业务员签到的位置依据。3.2.9.2.3 签到数据结构I. 字段I. 名称I. 类型I. 说明II. idII. 编号II. int(11)II.III. shop_idIII. 门店编号III. int(11)III.IV. shop_nameIV. 门店名称IV. varchar(64)IV. 冗余字段V. salesman_idV. 业务员编号V. int(11)V.VI. salesman_nameVI. 业务员姓名VI. varchar(16)VI. 冗余字段VII. check_in_timeVII. 签到时间VII. datetimeVII.VIII. latVIII. 签到经度VIII. float(9,6)VIII.IX. lngIX. 签到纬度IX. float(9,6)IX.X.X.X.X.签到流程业务员签到第一步是通过微信扫描二维码，进入签到页面。如果业务员所在位置在扫描的二维码所属门店范围内，则可以进行签到，否则不能签到。3.2.9.2.4 统计分析业务员签到次数统计I. 字段I. 名称I. 类型I. 说明II. idII. 编号II. int(11)II.III. salesman_idIII. 业务员编号III. int(11)III.IV. salesman_nameIV. 业务员姓名IV. varchar(16)IV. 冗余字段V. check_in_countV. 签到次数V. int(11)V.VI.VI.VI.VI.业务员签到门店统计I. 字段I. 名称I. 类型I. 说明II. idII. 编号II. int(11)II.III. salesman_idIII. 业务员编号III. int(11)III.IV. salesman_nameIV. 业务员姓名IV. varchar(16)IV. 冗余字段V. shop_idV. 门店编号V. int(11)V.VI. shop_nameVI. 门店名称VI. varchar(64)VI. 冗余字段VII. check_in_countVII. 签到次数VII. int(11)VII.VIII.VIII.VIII.VIII.3.2.10 数据上报数据上报主要实现TTS系统与第三方系统的接口凭证维护，使系统建交互建立安全可靠的机制，同时，系统提供将TTS的数据上报到JPS系统及CDS系统；3.2.10.1 调用接口凭证维护3.2.10.1.1 概述用于实现TTS系统与第三系统的访问凭证的维护，第三方系统需要使用TTS系统的接口，需要维护接口访问凭证。当TTS系统需要访问第三方系统时，也可维护第三方系统的接口访问凭证信息。3.2.10.1.2 业务说明3.2.10.1.3 页面设计3.2.10.2 关联关系上报3.2.10.2.1 概述用于将TTS系统的关联关系文件发送到JPS系统，实现指定生产批次的产品做营销活动。3.2.10.2.2 业务说明3.2.10.2.3 页面设计3.2.10.3 入出库单上报3.2.10.3.1 概述用于将TTS系统的单据信息文件发送到JPS系统，实现指定出库单的产品做营销活动。3.2.10.3.2 业务说明3.2.10.3.3 页面设计3.2.10.4 申请码上报3.2.10.4.1 概述用于实现将从TTS申请的码数据上报到CDS系统，CDS系统再下发到印刷企业，实现数据无人工接触，确保数据流通安全；3.2.10.4.2 业务说明3.2.10.4.3 页面设计3.2.11 系统管理3.2.11.1 系统参数设置3.2.11.1.1 概述用于对系统运行中所必须的配置项的设置，为系统运行的必要项，不可随意修改。3.2.11.1.2 业务说明3.2.11.1.3 页面设计3.2.11.2 企业参数设置3.2.11.2.1 概述用于通过全局设置或针对特定企业类型或特定企业进行生产数据或单据进行特殊处理的配置。3.2.11.2.2 业务说明3.2.11.2.3 页面设计3.2.11.3 单据类型设置3.2.11.3.1 概述用于设置系统识别的单据类型，可根据企业自定义名称设置，同时，可根据业务需要，定义单据的后置类型，用于系统自动实现入出库，如销售出库的后置类型为采购入库等；3.2.11.3.2 业务说明3.2.11.3.3 页面设计3.2.11.4 角色信息维护3.2.11.4.1 概述用于建立系统角色，用于给不同级别或类型的用户分配不同的角色。根据角色的划分，达到控制不同用户对系统操作的权限控制，保证数据的安全性。3.2.11.4.2 业务说明3.2.11.4.3 页面设计3.2.11.5 操作日志查看3.2.11.5.1 概述TTS系统对数据安全有严格控制，针对每个用户的每个操作，系统将自动记录，用于追踪系统访问用户的路径数据。3.2.11.5.2 业务说明3.2.11.5.3 页面设计二、 TTS与WMS、PDM接口对接文档版本更新时间修订人修订内容版本号2017-9-29夏习林V1.0.02017-10-13夏习林加入校正接口V1.0.12017-10-20夏习林合并文件格式为一个文件，加入字段表格说明V1.0.22017-10-26夏习林加入企业级别说明，管控平台只需要企业级别为一级批发的单据上报到管控平台V1.0.32017-11-10夏习林更新单据及关联关系的报文说明及字段说明V1.042017-11-20夏习林更新单据与关联关系的行政区域信息，在企业信息中新增AreaCode及AreaName，存储国家指定的区域编码V1.051 业务流程2 业务逻辑1、每个流向节点的单据信息都需要上传到TTS系统；2、单据类型包括销售出库、采购入库、调拨入库等，类型在TTS系统手动维护；3、流通企业是否需要扫描入库？如需要，需要上传对应的采购入库单；4、单据信息以每个单据时间发货量为一个单据并作为上传到TTS系统的单据文件，如一个单据包括10托，需将10托作为一个单据文件；3 业务描述根据之前的需求调研及后续的需求文档分析，确认当前光明乳业的出库流程为：1、工厂出库给领先物流（WMS出库），可理解为一级；2、领先物流出库给批发商，可理解为二级；3、批发商出库给商超，可理解为三级；由于在领先物流这个阶段，可能出现包材损坏或产品损坏，需要在仓库实现包材替换及托、箱、提的关系重组，方便出库。需要TTS系统提供相应操作接口；1、码替换:实现对损坏的包材做监管码替换，需要替换生产及流向信息；2、关联关系上传接口：为每个单据对应的关联关系，即，不论是否经过产品包装的重组，每个上传到TTS系统的单据，WMS系统都需要提供对应该单据的完整的关联关系信息（重组后的包装需要提供为重组后的包装关系，文件格式有TTS系统提供），TTS系统接收到该关联关系后，提供接口给PDM，PDM根据当前所属企业，获取发送给给企业的关联关系；重组后的监管码TTS系统不支持流向查询；3、单据上传接口：WMS完成单据的扫描出库后，需要上传该单据给TTS系统；4 接口接口调用，首先获取TTS的Token认证，再调用具体接口；4.1 Token管理access_token是TTS的全局唯一票据，调用TTS各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。其他系统可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在TTS提供的界面中维护。接口调用请求说明http请求方式: POSThttp:/站点地址/WebAPIs/BasicService.svc/GetToken调用示例AppId:,Secret:,Session_Id:参数说明参数是否必须类型说明AppId是字符串第三方用户唯一凭证Secret是字符串第三方用户唯一凭证密钥，即appsecret Session_Id是字符串客户端唯一表示标识返回说明正常情况下，TTS会返回下述JSON数据包：Result:True,Access_Token:ACCESS_TOKEN,ErrCode:0,ErrMsg:,Expires_In:7200,CorpCode:01参数 类型说明 Access_Token 字符串获取到的凭证 Expires_In 数字凭证有效时间，单位：秒 CorpCode字符串企业编码错误时TTS会返回错误码等信息，JSON数据包示例如下Result:False, Access_Token :,ErrCode:1, ErrMsg :错误消息,Expires_In:0,CorpCode:4.2 码替换接口接口说明：用于实现追溯码的替换，替换时，同时替换生产批次码及对应的出库后的码；码替换不是重组的吗；请求方式：Post接口地址：http:/系统地址/TTS/WebAPIs/CodeService.svc/ReplaceCode调用示例Token:,OldCodeId:,NewCodeId:参数说明参数 是否必须 说明 OldCodeId是被替换的码NewCodeId是替换的码返回说明正常情况下，TTS会返回下述JSON数据包：ErrCode:0,ErrMsg:null,Result:true错误时TTS会返回错误码等信息，JSON数据包示例如下Result:false,ErrCode:1,ErrMsg:错误信息 4.3 单据上传接口接口说明：TTS提供接收标准TTS关联关系及单据格式的接口，用于接收第三方上传的单据文件实现生产入库及销售出库；由于涉及到关系重组，所有，在出库扫描时，如果当前扫描单位为重组的包装，需要将当前扫描单位的下级包装码当作扫描码，即如果扫描的是重组的托盘码，单据中需要记录的是托盘下的所有箱码；如果没有重组，那就记录扫描的托盘码即可，相应的箱、提操作与托盘操作相同；注：由于系统需要维护各个经销商的行政区域信息，为管控平台做数据统计，也避免人为去一个个的给经销商企业做区域信息的维护，需要在单据的文件中维护上企业所在的行政区域信息；所有出库单位扫描的码，可以向下查询，不可以向上查询，即如果是单据里包括的提码，不能以箱码做追溯条件。请求方式：Post接口地址：http:/系统地