系统需求规格说明书

1、XXX 系统或 XXX 项目产品需求规格说明书文件状态：文件编号：SN_SR_001 草稿当前版本：V1.0 正式发布 正在修改作者：完成日期：2017-04-11方案书版本信息版本时间状态更新人简要描述审核人审核时间V1.0V1.01V1.2V1.3V1.4注：状态可以为N-新建、 A- 增加、 M- 更改、对方的所得税 说明：版本信息必须更新，审核人和审核时间也必须审核后填写，审核人要求部门经理级别以上。否则开发测试可拒绝评审。审核业务功能是否有遗漏、业务流程是否符合规划、关键业务逻辑是否有合理方案书目录1.关于本文档 .41.1.内容说明 .41.2.名词解释 .41.3.参考文档 .4

2、2.系统概述 .52.1.业务背景 .52.2.系统概述 .62.3.流程概览 /系统框架 .72.4.系统规划与迭代 .82.5.功能模块 .83.系统功能需求 .93.1状态信息接受推送 .93.2最新站点查询服务 .194.系统非功能需求 .333.3性能需求 .333.4安全性需求 .343.5扩展性需求 .343.6兼容性需求 .343.7维护性需求 .345.附录.34方案书1. 关于本文档1.1.内容说明说明：此处描述的是文档说明， 产品需求文档更新需要走修订模式，下次更新前先接受修订，并且每次更新必须更新版本号和版本记录。例子：本文档用于描述苏宁开放平台物流状态服务系统的需求定

3、义。包括各个需求的功能描述，处理逻辑规则，界面定义， 与其它功能的关系，与其它系统的接口等各个方面的定义。是苏宁物流状态服务系统唯一的全面需求定义文档。本文档将根据需求管理流程和要求，随系统功能变化进行及时的修订和更新，以确保本文档的全面性，准确性和实效性。因此在阅读使用此文档时，请注意从项目的文档管理系统中获取最新版本。1.2.名词解释词汇名称词汇含义备注LSQ物流状态服务系统LSP物流服务平台LES物流作业系统LWMS分布式仓储管理系统TMS运输管理系统1.3.参考文档系统需求定义规范使用说明方案书2. 系统概述2.1.业务背景说明：此处描述业务背景，不可裁剪，清晰的业务背景描述能更好的帮

4、助研发和测试理解产品需求，明确业务测试场景，此部分是产品需求定位的核心导向。例子一：电子面单的业务描述随着电子商务服务和物流服务信息化飞速发展，包裹运单号成为快递公司串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。我司在两年前就开始了电子面单在自营物流上的应用，经过长期的的磨合和积累，目前将我司的应用经验推广到社会物流上，让社会上愿意与我司物流合作的伙伴，也同样享受到我司电子面单服务。例子二： LSQ 的业务描述物流作业状态服务存在不足1 ）服务无标准不统一需物流作业的各渠道订单，作业状态转化为文案描述处理的逻辑系

5、统多，且处理规不统一， B2C 自营订单，逻辑在B2C ，数据源在OMS菜鸟平台 /4PS 平台订单状态展示，逻辑在LAPI ，数据源在LAPI物流门户订单状态展示，逻辑在LPS，数据源在LOS开放平台订单，逻辑在SOD ，数据源在SOD R3 自营订单，无逻辑，数据源在R32 ）维度单一而不满足新需求不能满足多样化的展示需求，如目前只有订单维度的状态详情展示，不支持任务单、顾客包裹等维度的详情服务。方案书同时，缺乏物流特定作业状态的高实时性精确查询服务（如是否销单完成，是否过账，最新站点是哪个等）。3 ）开放服务的渠道有待拓展目前，物流没有一个公网渠道，使顾客能快速查询在苏宁各渠道订单的作业

6、状态信息。故设计一个物流状态系统统一管理物流状态的收发，状态描述转换，以及提供状态服务查询。2.2.系统概述说明：系统说明包括文字部分和图形部分， 文字部分主要描述系统之间的关联关系，图形主要包括系统和相关联系统之间的交互结构，不可裁剪例子一：系统说明合作伙伴申请苏宁电子面单服务，选择相应的合作模式，由合作伙伴提供预配送包裹的信息，由苏宁电子面单服务生成相应的面单信息，并由合作伙伴系统打印出来并完成包装，最终投递给苏宁网点且面单能被苏宁物流体系识别。系统之间的关联关系：苏宁电子面单服务是基于苏宁自营物流电子面单应用，整合社会上多家快递公司，搭建一套具有苏宁配送特色的电子面单服务体系， 为苏宁物

7、流的合作伙伴提供统一的电子面单服务。实现了， 合作伙伴对接苏宁的物流服务，由使用纸质面单向电子面单转变。只要合作伙伴对接了苏宁电子面单服务，那么就可以享受苏宁物流体系的电子面单服务。本系统当期功能主要包含：A 、用户操作权限管理；B、配置数据信息管理；C、订单对应的作业单物流节点状态信息接收与分发功能；D 、订单对应的作业单物流节点状态信息查询功能；方案书社会渠道销售渠商家ERP天猫商户道商户入驻ASMP售后商户销售服务订购资源能力四方服ASOPASOPOS售后运营管理务平台以旧换新查询服务ASAP售后服务时效能力发布ASVP服务商管理三方作业平台平台服务商SUC/CIS苏宁易购ECSMOMS

8、商家订单苏宁客服系统二手回收系统OMSASSP售后个人销售（北苏宁订单系统研）订单接入LAPI售后订单接入订单服务ASOMSOD四方服务详情系四方接单系统统LAPI苏宁帮客ASOSASES自营订单服务系统售后作业系统LAPI加盟服务商经营分析RCS资源中心结算平台LBI天眼2.3.流程概览 / 系统框架说明：此处需要描述和图形化系统内部功能结构模块图，可从架构和技术获取资源。 清晰的系统架构对于系统的扩展性和方案书维护性都非常有帮助，也便于开发和测试从整体上理解该系统的结构。2.4.系统规划与迭代说明：此处说明对该系统的总体规划步骤，一期接入什么功能，二期接入什么功能达到什么业务效果。2.5.

9、功能模块说明：此处的列表和下面的功能需求是对应的，系统需求编号是唯一识别需求的标识。需求编号的规则见 章节例子：主功能系统需求编号子功能优先备注级LSQ_DDZF_MDZF_0001非采购类状态信息接收一级一期需求状态信息接收推LSQ_DDZF_MDZF_0002状态信息发送一级一期需求送LSQ_DDZF_MDZF_0003状态转换一级一期需求接收计划物流节SNPD_LSQ_SSS_04接收计划物流节点信息二级点信息方案书最新站点查询服SNPD_LSQ_SSS_05最新站点查询服务二级一期需求务SNPD_LSQ_SSS_06虚拟包裹信息接收与更新一级一期需求详情调用服务SNPD_

10、LSQ_SSS_07BTC 物流物流详情调用一级一期需求SNPD_LSQ_SSS_08CIC 物流物流详情调用一级一期需求后台配置SNPD_LSQ_SSS_09后台配置一级一期需求快递 100 接入服快递 100 查询与推送运单SNPD_LSQ_SSS_10一级二期需求务信息LES 拆分需物流详情查询SNPD_LSQ_SSS_11作业系统查询状态明细一级求3. 系统功能需求3.1 状态信息接受推送非采购类状态信息接收需求编号 LSQ_DDZF_MDZF_0001说明：/ 功能的业务介绍和业务背景此处的需求编号，在一个系统中必现唯一存在并且最后4 位递增，规则：系统名 _模块名 _子功能名 _序

11、列号，如LSQ_DDZF_MDZF_0001： 系统名最长保留 4 位，模块名 /子功能名最长 4 位，序列号最长 4 位不够 4 位补 0 比如方案书0001 ，如果是优化需求，需求编号不变，新增需求需求编号增加；处理流程和约束条件说明：此处是放上面功能的业务流程图和功能的业务逻辑约束条件流程图：开始输入用户名和密码未通过点击提交校验用户名和密码通过登录成功登录失败通过结束说明：如果流程图比较大或比较多，请以单独的附件提供约束方案书#步骤逻辑1. 入参确认1 功能入参确认1) 用户名；02) 密码2校验处理1.校验：用户名在数据库中唯一且存在；1) 成立，继续后续校验2) 不成立，返回报错：

12、请输入正确的用户名密码2. 校验：安全性：1) 安全性不通过，则提示该登录可能存在安全隐患，请重新访问；2) 安全性通过，则继续下面，3 订单处理4 组织结果反馈1. 全部校验通过：1) 提示：登录成功，数据库更新最后登录时间；2) 可进入系统进行后续操作页面原型说明：N/A，系统后台功能无页面有页面请截低保真的图，图片要能覆盖所描述的功能，以及页面访问路径。方案书数据说明说明：N/A，系统后台功能无页面如果有页面校验请在此处用列表的形式说明各个页面各个控件的校验规则XX 功能字段名数据类型页面长度小数位说明用户名字符10非空，必须包括大小写字母、字符，不可输入中文密码字符10非空，必须包括大

13、小写字母、字符、特殊字符方案书功能需求描述说明：1）功能描述，需要做到语言准确，结构清晰，须包括从用户角度和业务角度描述功能和业务场景；要尽可能少地从系统逻辑角度去撰写需求，多写业务逻辑以免干扰开发的最优设计。在需求中明确业务接口。2）版本优化，如果是优化功能采用修订模式在涉及到的所有原文档（包括需求说明书、流程图、接口文档）上进行修改并标注，需求说明书需对应需求编号章节进行修改，这样便于研发和测试了解原功能，以便快速了解优化的业务判断回归场景。产品还需说明优化此功能的业务场景以及建议优化功能涉及相关使用场景。（0522 版本）特别说明：修改的功能会影响系统对外提供的接口，需要这些接口的使用方

14、对接口进行验证，并确认接口的变更登录1 ）针对登录功能，需要做安全性校验，实行https 的方式，并且登录密码以* 显示，在日志打印中也以* 展示；2）登录功能，登录调用API接口 INTERFACE_LSQ_LOGIN_0001实现登录 ，需要保证数据传递的安全性。状态接受LSQ 系统接收状态信息，作如下处理：数据类型长度小数位说明ID字符32主键，系统自动生成的流水号外部流水号字符32外部传的流水号外部系统字符10当前外部订单对应的“外部系统”任务单号字符20当前外部订单对应的“外部订单编码”物流订单号字符30通过卖家 ID 查询客户信息匹配表，结果为查询到的卖家 ID 对应的“客户编码”

15、方案书订单属性字符10订单客户字符10字符10前置任务单系统服务大类字符20收入项字符20服务产品字符4服务细节字符4商品属性字符60件数字符10网点描述字符60实际交货数量数值13数量单位字符3字符14排程日期时间接收日期时间字符19当前外部订单对应的“苏宁业务类型”若业务类型为“ C019”，则默认为“ ZVIN”入仓在接收 4PS销退入库单时，若orderFlag 订单标记带有 9，则在下传装运条件时，传输“ 01”自营，其他则按照原有逻辑传“ 06”第三方固定赋值“ L01 仓储”固定赋值“L0101 存量”固定赋值“L010101 仓库保管”根据物流中心匹配zlmt026 ，取属性，

16、若属性=MD，则服务细节=L01010101门店库存，否则为L01010102 中心仓库存用物料号匹配商品主数据，取商品属性（当用计费明细的物料号matnr 时，首先做取前置0 ，然后再去关联 MDM商品主数据）回算表的 lfimg固定赋值“ L01 仓储”固定赋值“L0101 存量”固定赋值“L010101 仓库保管”若订单对应的基本信息的“预期送达开始时间”为空，且当前日期时间比当前日期时间18:00:00 早，则为当前日期，否则为当前日期+1天；若订单对应的基本信息“预期送达开始时间”不为空，则取该时间中的日期，格式为YYYY-MM-DD系统当前日期接口说明说明：如果字段少可直接把接口列

17、表贴这里，接口模板见下表必须包括深度和返回消息，如果有不同返回码也需要一并定义。每个接口在需求文档中撰写一个编号，在系统中唯一，以便附件中能快速找到对应的接口，便于定期维护，接口编号：规则一个系统唯一：INTERFACE_系统名 _一级模块名 _编号递增产品定义的接口只需提供到中文字段名、长度、是否必须，校验说明即可。方案书API接口 INTERFACE_LSQ_LOGIN_0001深度名称描述类型长度是否必输说明1INPUT请求输入2ITEM3username用户名CHAR(10)必输不可为空3Password密码CHAR(10)必输不可为空3token盾牌CHAR(30)必输不可为空1OU

18、TPUT请求输出2username用户名CHAR(30)必输2returnCode结果状态CHAR(10)必输0-成功， 1-失败2Message文本描述CHAR(255)接收成功 / 接收失败returnCode 返回码说明：快递公司验证returnCodeMessage快递 100 需要做的操作LSQ 订阅成功200成功LSQ 数据验证失败400数据不完整补充数据，重新订阅LSQ 格式验证失败500请求格式错误程序有问题，需要调整本地服务器错误501服务器错误30 分钟后尝试LSQ 订阅日志已存在502重复订阅理解为订阅成功LAPI 校验 KEY 错误503验证签名失败使用正确的 KEYL

19、SQ 未查到对应物流单号504单号错误更正单号LSQ 未查到对应物流单号507查询异常状态接收接口INTERFACE_LSQ_STATUS_0001由于字段较多见附件，每个接口在需求文档中撰写一个编号，规则一个系统唯一：INTERFACE_系统名 _一级模块名 _编号递增方案书该功能处理过程中会调用以下接口（见附件）：接口编号接口名称原系统目标系统场景INTERFACE_LSQ_LOGIN_0001API 登录接口LSQAPI处理成功，登录成功INTERFACE_LSQ_STATUS_0001状态信息同步LSQLOS/TMS/LWMSLSQMQ信息处理成功记录到LSQ系统其它说明说明：可以把性

20、能需求或者安全性，稳定性需求，页面浏览器兼容性需求等等放此处状态信息发送需求编号 LSQ_DDZF_MDZF_0002处理流程和约束条件#步骤逻辑10订单判断1.使用订单行号查询本地是否存在对应的订单行1) 存在，继续后续判断；2) 不存在，进入后续校验；2. 判断订单行状态：1) 如果订单行状态 10- 已提交， 12- 订单异常，进入后续校验；2) 如果订单行状态大于等于 20- 处理成功，直接返回成功；3. 判断订单是否存在后续退货订单；1) 存在，返回报错：该订单状态准确，不可进行支付2) 不存在，进入后续校验；4.判断订单支付金额是否正确，判断等式：行项目销售额+ 运费 + 服务费

21、=方案书支付金额之和+ 使用积分金额+ 经理卡金额，是否成立；1)成立，继续后续处理2)不成立：支付金额不正确，请检查后重新输入；20订单支付信息处1.订单行支付状态设置：将所有订单行状态都置为：30- 已支付；理2.保存新增的支付信息；3.覆盖本地已有的优惠单信息；4.冻结标志设置：如果订单支付信息中含有：4001（支票支付），则将订单行冻结标识置为： D2- 支票冻结；5.支付确认标记设置：门店订单【支付确认开关】为打开状态时，对于满足以下条件的订单行项目，将订单行支付确认标识置为：0- 未确认支付；1) 分销渠道为 10- 零售、 20- 代购，2) 且来源系统为 POS。3) SAP

22、订单类型为 ZOR-标准订单、 IDOC 、 Z01 、 ZGF。4) 装运条件为 01、 14。5) 先销后采标识不为 5 。20 订单支付信息处1. 调用【公共规则 - 资源处理】功能；理1)成功，将订单行状态置为：20- 已处理，订单头状态：20- 已处理；2) 失败，将订单行状态置为： 12- 处理失败，订单头状态置为： 12- 处理失败；30组织结果反馈1.根据处理结果，组织结果反馈；40实时同步1.OMSD 全量： 调用功能【公共功能-订单全量信息分发OMSD】2.OMSQ 全量： 调用功能【公共功能-订单全量信息分发OMSQ】方案书50异步同步1.BI- 大数据系统：调用【公共规

23、则- 】2. PMS- 价格中心系统：调用【公共规则- 】3. SPCS- 云商卡系统：调用【公共规则 -】4. BUDS- 财务系统：调用【公共规则】60 日志打印打日志： OMS 订单号， OMS 行订单号，订单支付完成时间，预计出库时间，期望送达时间，支付订单创建时间,SAP 订单类型，先销后采标识，订单来源，下单时间，渠道， 行项目类别， 分次发货标识， 支付类型 （04门店支付），支付确认标识，日志阶段：02（01 提交， 02 支付， 03 支付确认， 04 还欠款） id（ 10000055 ）页面原型N/A ，系统后台功能无页面数据说明N/A ，系统后台功能无页面功能需求描述针

24、对以下业务场景，前端系统通过该功能完成门店订单收款处理；#场景接口0电器门店零售订单收银台全款支付处理POS-OMS-008操作码： D1方案书0电器门店对公云商卡订单收银台全款支付处POS-OMS-008操作码： D2理接口说明其它说明3.2 最新站点查询服务最新站点查询需求编号 LSQ_DDTJ_DDTJ_0003处理流程和约束条件接收到前端系统提交的订单后，进行订单提交相关处理，具体逻辑如下：方案书OMS_DDTJ_DDTJ_001 订单提交（老流程）B2C/POS/SPOS/MPOS/CCT/CRM/SAP/SPCS/OMSDOMSQOMSSHS/POAS/BSS/CIC/CMWS开始

25、10. 提交未支付 / 已20. 进行订单合法支付订单性校验30. 生成或更新订校验通过是单信息否接单模式 =2,3接单模式接单模式 =140. 订单处理100. 接收处理结果50. 返回处理结果调度结束60. 记录日志信息处理成功70.保存或更新订单80. 异步分发订单是信息信息否是结束90. 保存待分发信81.接收订单全量信82.接收订单全量信息息息结束结束结束段阶具体步骤逻辑如下：#步骤逻辑1提交订单前端系统通过以下接口提交订单，且订单类型为A 时，进入该0功能：SPOS-OMS-001B2C-OMS-001ALL-OMS-001ALL-OMS-016方案书2进行订单合法性根据接口传入订

26、单信息进行合法性校验：0校验1.订单重复性校验2. 若接口输入的接单模式为 1 或者 3，则进行订单金额校验1) 判断行优惠单金额是否正确。 校验公式： 行优惠单金额 =行优惠单明细金额汇总 ：a) 若不正确， 则返回报错： 订单行 “前端系统行项目号“的优惠单总金额与优惠单明细不一致。b) 否则进行一下步判断2) 若订单提交接口为 ALL-OMS-001 ，则需判断行销售额是否正确，校验公式：行销售额=销售价*数量 ：a) 若不正确， 则返回报错： 订单行 “前端系统行项目号“的销售额” XX”不等于销售价格” XX”* 数量” XX”。b) 否则进行一下步判断3) 若订单提交接口为 ALL

27、-OMS-001 ，则需判断行应付金额是否与支付明细汇总金额一致， 校验公式： 行项目销售额+ 运费 + 服务费 = 支付金额之和 + 使用积分数金额 + 经理卡金额 ：a) 若不正确， 则返回报错： 订单行 “前端系统行项目号“的总支付金额与应付金额不一致。b) 否则进行一下步判断4) 若订单提交接口为 B2C-OMS-001 ，则需判断行应付金额是否与支付明细汇总金额一致，校验公式： 销售价 * 数量 -方案书经理卡金额 + 运费 + 行税额 + 服务费 = 支付金额之和 ：a) 若不正确， 则返回报错： 订单行 “前端系统行项目号“的总支付金额与应付金额不一致。b) 否则进行一下步判断3

28、. 根据校验结果：1) 若以上所有校验通过，则进入下一步“ 30- 生成或更新订单信息”步骤2) 若以上任意校验失败，则进入“50- 返回处理结果”步骤3生成或更新订单根据接口传入的订单信息创建订单信息或全量更新以下信息：0信息1.若是创建订单，则根据单号规则生成订单号和订单行号2. 进行订单状态设置1) 进行订单行总状态设置，具体逻辑见“表 - 订单行总状态（ IS ）设置逻辑”2) 进行订单行支付状态设置，具体逻辑见“表 - 订单行支付状态（ IP ）设置逻辑”3) 进行订单行发票状态设置，默认设置为IV=104) 进行订单头总状态设置3. 进行订单特殊标记设置1) 进行订单行冻结标识设置

29、a) 若分销渠道 =30 ，且订单来源为 CRM，则设置分次发货标记为 D3- 对公订单未付款冻结b)否则，如订单支付方式中含有4001 ：支票支付，则方案书设置分次发货标记为：D2- 支票交货冻结c) 否则，对于其他场景设置分次发货标记为 A-只允许一次发货2) 进行订单行大客户付款类型设置。 满足以下所有条件， 设置大客户付款类型为 1- 确认欠款：a) 订单来源为 SPCSb) 行项目类别为 16- 云商卡订单c) 接单模式为 1d) 支付方式含 90053) 进行订单行是否需要发票设置4. 根据接口传入订单信息保存订单基本信息5. 根据接口传入订单扩展信息保存订单相关扩展信息1) 若订

30、单行类别 = 10 ，且接口中存在服务商品， 则需要保存服务扩展信息2) 若订单行类别 =11 ，则需要保存延保扩展信息3) 若订单行类别 =12 ，则需要保存赠品扩展信息4) 若订单行类别 =13 ，则需要保存虚拟商品信息5) 若订单行类别 =14 ，则需要保存合约扩展信息6) 若订单行类别 =16 ，则需要保存云商卡扩展信息7) 若订单行类别 =20 ，电子书无扩展信息，无需保存8) 若订单行类别 =22 ，则需要保存独立服务扩展信息9) 若订单行类别 =24 ，则需要保存运费险扩展信息方案书6. 若接口传入的支付方式含 9002- 货到付款、 9003- 融合支付，则需要保存还欠款信息7

31、. 订单信息保存后，根据接单模式：1) 若订单保存成功，且接口传入的接单模式为 1，则进入下一步“ 40- 订单调度处理” ；2) 若订单保存成功，且若接口传入的接单模式为 2、 3，则进入下一步“ 50- 返回处理结果”3) 若订单保存失败， 则直接进入下一步 “50- 返回处理结果”4进行订单处理调调用功能【 OMS_ZYCL_ZYCL_001- 资源处理（老流程） 】进行0度处理51.根据 30、 40 步骤的处理结果，返回对应信息0返回处理结果1)若处理失败，则返回前端处理失败2)若处理成功，则返回前端处理成功2.进入下一步“记录日志信息”步骤61.若为。则：0记录日志信息2.3.根据

32、 30、 40 步骤的处理结果1)若处理失败，则结束本次提交流程2)若处理成功，则继续进行后续“ 70- 保存或更新订单信息”、“ 80- 异步分发订单”和“90- 保存待分发信息”步骤71.保存 BUDS 信息0保存或更新订单信息1)满足以下所有条件， 保存该订单行支付明细到BUDS 支付方案书明细信息中a) 订单行项目类别不为 16b) 订单行支付中存在 9001- 香港欠款、 9002- 货到付款、或者 9005- 对公欠款2. 设置订单实时处理标记。1) 满足以下所有条件设置实时处理标记为Ya) 行项目类别为 10- 实体、 12- 赠品b) “装运条件为空 - 自提、 17- 物流门店库自提、 20- 物流门店库自提” 或者“装运条件为 02- 门店自提且 SAP订单类型 =IDOC”c) 分次发货标识为 A- 只允许一次发货 、或者 D2-支票冻结d) 订单行状态 >=20e) 订单类型不为 C-退货订单f) 先销后采标识为空、或者 02) 若 SAP 订单类型为 ZSIA 且为 10 渠道（门店互联开卡订单），则设置实时处理标记为 Y3) 其他情况，不设置实时处理标记3. 保存订