系统需求规格说明书.docx

1、系统需求规格说明书XXX系统或XXX项目产品需求规格说明书文件状态： 草稿 正式发布 正在修改文件编号：SN_SR_001当前版本：作 者：完成日期：2017-04-11 版本信息版本时间状态更新人简要描述审核人审核时间注：状态可以为N-新建、A-增加、M-更改、对方的所得税 说明：版本信息必须更新，审核人和审核时间也必须审核后填写，审核人要求部门经理级别以上。否则开发测试可拒绝评审。审核业务功能是否有遗漏、业务流程是否符合规划、关键业务逻辑是否有合理1.关于本文档1.1.内容说明说明：此处描述的是文档说明，产品需求文档更新需要走修订模式，下次更新前先接受修订，并且每次更新必须更新版本号和版本

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

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

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

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

6、送特色的电子面单服务体系，为苏宁物流的合作伙伴提供统一的电子面单服务。实现了，合作伙伴对接苏宁的物流服务，由使用纸质面单向电子面单转变。只要合作伙伴对接了苏宁电子面单服务，那么就可以享受苏宁物流体系的电子面单服务。本系统当期功能主要包含：A、用户操作权限管理；B、配置数据信息管理；C、订单对应的作业单物流节点状态信息接收与分发功能；D、订单对应的作业单物流节点状态信息查询功能； 2.3.流程概览/系统框架说明：此处需要描述和图形化系统内部功能结构模块图，可从架构和技术获取资源。清晰的系统架构对于系统的扩展性和维护性都非常有帮助，也便于开发和测试从整体上理解该系统的结构。2.4.系统规划与迭代

7、说明：此处说明对该系统的总体规划步骤，一期接入什么功能，二期接入什么功能达到什么业务效果。2.5.功能模块 说明：此处的列表和下面的功能需求是对应的，系统需求编号是唯一识别需求的标识。需求编号的规则见章节例子：主功能系统需求编号子功能优先级 备注状态信息接收推送LSQ_DDZF_MDZF_0001非采购类状态信息接收一级一期需求LSQ_DDZF_MDZF_0002状态信息发送一级一期需求LSQ_DDZF_MDZF_0003状态转换一级一期需求接收计划物流节点信息SNPD_LSQ_SSS_04接收计划物流节点信息二级最新站点查询服务SNPD_LSQ_SSS_05最新站点查询服务二级一期需求详情调

8、用服务SNPD_LSQ_SSS_06虚拟包裹信息接收与更新一级一期需求SNPD_LSQ_SSS_07BTC物流物流详情调用一级一期需求SNPD_LSQ_SSS_08CIC物流物流详情调用一级一期需求后台配置SNPD_LSQ_SSS_09后台配置一级一期需求快递100接入服务SNPD_LSQ_SSS_10快递100查询与推送运单信息一级二期需求物流详情查询SNPD_LSQ_SSS_11作业系统查询状态明细一级LES拆分需求3.系统功能需求3.1状态信息接受推送3.1.1非采购类状态信息接收3.1.1.1需求编号LSQ_DDZF_MDZF_0001说明：/功能的业务介绍和业务背景此处的需求编号，在

9、一个系统中必现唯一存在并且最后4位递增，规则：系统名_模块名_子功能名_序列号，如LSQ_DDZF_MDZF_0001： 系统名最长保留4位，模块名/子功能名最长4位，序列号最长4位不够4位补0比如0001，如果是优化需求，需求编号不变，新增需求需求编号增加；3.1.1.2处理流程和约束条件说明：此处是放上面功能的业务流程图和功能的业务逻辑约束条件流程图：说明：如果流程图比较大或比较多，请以单独的附件提供约束#步骤逻辑10功能入参确认1.入参确认1)用户名；2)密码2校验处理1.校验：用户名在数据库中唯一且存在；1)成立，继续后续校验2)不成立，返回报错：请输入正确的用户名密码2.校验：安全性

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

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

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

13、”订单客户字符10若业务类型为“C019”，则默认为“ZVIN”入仓前置任务单系统字符10在接收4PS销退入库单时，若orderFlag订单标记带有9，则在下传装运条件时，传输“01”自营，其他则按照原有逻辑传“06”第三方服务大类字符20固定赋值“L01仓储”收入项字符20固定赋值“ L0101存量”服务产品字符4固定赋值“ L010101仓库保管”服务细节字符4根据物流中心匹配zlmt026，取属性，若属性=MD，则服务细节= L01010101门店库存，否则为L01010102中心仓库存商品属性字符60用物料号匹配商品主数据，取商品属性（当用计费明细的物料号matnr时，首先做取前置0

14、，然后再去关联MDM商品主数据）件数字符10回算表的lfimg网点描述字符60固定赋值“L01仓储”实际交货数量数值13固定赋值“ L0101存量”数量单位字符3固定赋值“ L010101仓库保管”排程日期时间字符14若订单对应的基本信息的“预期送达开始时间”为空，且当前日期时间比当前日期时间18:00:00早，则为当前日期，否则为当前日期+1天；若订单对应的基本信息“预期送达开始时间”不为空，则取该时间中的日期，格式为YYYY-MM-DD接收日期时间字符19系统当前日期3.1.1.6接口说明说明：如果字段少可直接把接口列表贴这里，接口模板见下表必须包括深度和返回消息，如果有不同返回码也需要一

15、并定义。每个接口在需求文档中撰写一个编号，在系统中唯一，以便附件中能快速找到对应的接口，便于定期维护，接口编号：规则一个系统唯一：INTERFACE_系统名_一级模块名_编号递增产品定义的接口只需提供到中文字段名、长度、是否必须，校验说明即可。API 接口INTERFACE_LSQ_LOGIN_0001深度名称描述类型长度是否必输说明1INPUT请求输入2ITEM3username用户名CHAR(10)必输不可为空3Password密码CHAR(10)必输不可为空3token盾牌CHAR(30)必输不可为空1OUTPUT请求输出2username用户名CHAR(30)必输2returnCode

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

17、_LSQ_STATUS_0001由于字段较多见附件，每个接口在需求文档中撰写一个编号，规则一个系统唯一：INTERFACE_系统名_一级模块名_编号递增该功能处理过程中会调用以下接口（见附件）：接口编号接口名称原系统目标系统场景INTERFACE_LSQ_LOGIN_0001API登录接口LSQAPI处理成功，登录成功INTERFACE_LSQ_STATUS_0001状态信息同步LSQLOS/TMS/LWMSLSQMQ信息处理成功记录到LSQ系统3.1.1.7其它说明说明：可以把性能需求或者安全性，稳定性需求，页面浏览器兼容性需求等等放此处3.1.2状态信息发送3.1.2.1需求编号LSQ_D

18、DZF_MDZF_00023.1.2.2处理流程和约束条件#步骤逻辑10订单判断1.使用订单行号查询本地是否存在对应的订单行1)存在，继续后续判断；2)不存在，进入后续校验；2.判断订单行状态：1)如果订单行状态10-已提交，12-订单异常，进入后续校验；2)如果订单行状态大于等于20-处理成功，直接返回成功；3.判断订单是否存在后续退货订单；1)存在，返回报错：该订单状态准确，不可进行支付2)不存在，进入后续校验；4.判断订单支付金额是否正确，判断等式：行项目销售额+运费+服务费=支付金额之和+使用积分金额+经理卡金额，是否成立；1)成立，继续后续处理2)不成立：支付金额不正确，请检查后重新

19、输入；20订单支付信息处理1.订单行支付状态设置：将所有订单行状态都置为：30-已支付；2.保存新增的支付信息；3.覆盖本地已有的优惠单信息；4.冻结标志设置：如果订单支付信息中含有：4001（支票支付），则将订单行冻结标识置为：D2-支票冻结；5.支付确认标记设置：门店订单【支付确认开关】为打开状态时，对于满足以下条件的订单行项目，将订单行支付确认标识置为：0-未确认支付；1)分销渠道为10-零售、20-代购，2)且来源系统为POS。3)SAP订单类型为ZOR-标准订单、IDOC、Z01、ZGF。4)装运条件为01、14。5)先销后采标识不为5。20订单支付信息处理1.调用【公共规则-资源处

20、理】功能；1)成功，将订单行状态置为：20-已处理，订单头状态：20-已处理；2)失败，将订单行状态置为：12-处理失败，订单头状态置为：12-处理失败；30组织结果反馈1.根据处理结果，组织结果反馈；40实时同步1.OMSD全量：调用功能【公共功能-订单全量信息分发OMSD】2.OMSQ全量：调用功能【公共功能-订单全量信息分发OMSQ】50异步同步1.BI-大数据系统：调用【公共规则-】2.PMS-价格中心系统：调用【公共规则-】3.SPCS-云商卡系统：调用【公共规则-】4.BUDS-财务系统：调用【公共规则】60日志打印打日志：OMS订单号，OMS行订单号，订单支付完成时间，预计出库时

21、间，期望送达时间 ，支付订单创建时间,SAP订单类型，先销后采标识，订单来源，下单时间，渠道，行项目类别，分次发货标识，支付类型（04门店支付），支付确认标识，日志阶段：02（01提交，02支付，03支付确认，04还欠款）id（）3.1.2.3页面原型N/A，系统后台功能无页面3.1.2.4数据说明N/A，系统后台功能无页面3.1.2.5功能需求描述针对以下业务场景，前端系统通过该功能完成门店订单收款处理；#场景接口01电器门店零售订单收银台全款支付处理POS-OMS-008 操作码：D02电器门店对公云商卡订单收银台全款支付处理POS-OMS-008 操作码：D3.1.2.6接口说明3.1.

22、2.7其它说明3.2最新站点查询服务3.2.1最新站点查询3.2.1.1需求编号LSQ_DDTJ_DDTJ_00033.2.1.2处理流程和约束条件接收到前端系统提交的订单后，进行订单提交相关处理，具体逻辑如下：具体步骤逻辑如下：#步骤逻辑10提交订单前端系统通过以下接口提交订单，且订单类型为A时，进入该功能： SPOS-OMS-001 B2C-OMS-001 ALL-OMS-001 ALL-OMS-01620进行订单合法性校验根据接口传入订单信息进行合法性校验：1.订单重复性校验2.若接口输入的接单模式为1或者3，则进行订单金额校验1)判断行优惠单金额是否正确。校验公式：行优惠单金额 = 行

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

24、额与应付金额不一致。b)否则进行一下步判断4)若订单提交接口为B2C-OMS-001，则需判断行应付金额是否与支付明细汇总金额一致，校验公式：销售价*数量-经理卡金额+运费+行税额+服务费=支付金额之和：a)若不正确，则返回报错：订单行“前端系统行项目号“的总支付金额与应付金额不一致。b)否则进行一下步判断3.根据校验结果：1)若以上所有校验通过，则进入下一步“30-生成或更新订单信息”步骤2)若以上任意校验失败，则进入“50-返回处理结果”步骤30生成或更新订单信息根据接口传入的订单信息创建订单信息或全量更新以下信息：1.若是创建订单，则根据单号规则生成订单号和订单行号2.进行订单状态设置1

25、)进行订单行总状态设置，具体逻辑见“表-订单行总状态（IS）设置逻辑”2)进行订单行支付状态设置，具体逻辑见“表-订单行支付状态（IP）设置逻辑”3)进行订单行发票状态设置，默认设置为IV=104)进行订单头总状态设置3.进行订单特殊标记设置1)进行订单行冻结标识设置a)若分销渠道=30，且订单来源为CRM，则设置分次发货标记为D3-对公订单未付款冻结b)否则，如订单支付方式中含有4001：支票支付，则设置分次发货标记为：D2-支票交货冻结c)否则，对于其他场景设置分次发货标记为A-只允许一次发货2)进行订单行大客户付款类型设置。满足以下所有条件，设置大客户付款类型为1-确认欠款：a)订单来源

26、为SPCSb)行项目类别为16-云商卡订单c)接单模式为1d)支付方式含90053)进行订单行是否需要发票设置4.根据接口传入订单信息保存订单基本信息5.根据接口传入订单扩展信息保存订单相关扩展信息1)若订单行类别= 10，且接口中存在服务商品，则需要保存服务扩展信息2)若订单行类别=11，则需要保存延保扩展信息3)若订单行类别=12，则需要保存赠品扩展信息4)若订单行类别=13，则需要保存虚拟商品信息5)若订单行类别=14，则需要保存合约扩展信息6)若订单行类别=16，则需要保存云商卡扩展信息7)若订单行类别=20，电子书无扩展信息，无需保存8)若订单行类别=22，则需要保存独立服务扩展信息

27、9)若订单行类别=24，则需要保存运费险扩展信息6.若接口传入的支付方式含9002-货到付款、9003-融合支付，则需要保存还欠款信息7.订单信息保存后，根据接单模式：1)若订单保存成功，且接口传入的接单模式为1，则进入下一步“40-订单调度处理”；2)若订单保存成功，且若接口传入的接单模式为2、3，则进入下一步“50-返回处理结果”3)若订单保存失败，则直接进入下一步“50-返回处理结果”40进行订单处理调度调用功能【OMS_ZYCL_ZYCL_001-资源处理（老流程）】进行处理50返回处理结果1.根据30、40步骤的处理结果，返回对应信息1)若处理失败，则返回前端处理失败2)若处理成功，

28、则返回前端处理成功2.进入下一步“记录日志信息”步骤60记录日志信息1.若为。则：2.3.根据30、40步骤的处理结果1)若处理失败，则结束本次提交流程2)若处理成功，则继续进行后续 “70-保存或更新订单信息”、“80-异步分发订单”和“90-保存待分发信息”步骤70保存或更新订单信息1.保存BUDS信息1)满足以下所有条件，保存该订单行支付明细到BUDS支付明细信息中a)订单行项目类别不为16b)订单行支付中存在9001-香港欠款、9002-货到付款、或者9005-对公欠款2.设置订单实时处理标记。1)满足以下所有条件设置实时处理标记为Y a)行项目类别为10-实体、12-赠品b)“装运条件为空-自提、17-物流门店库自提、20-物流门店库自提”或者“装运条件为02-门店自提且SAP订单类型=IDOC”c)分次发货标识为A-只允许一次发货、或者D2-支票冻结d)订单行状态=20e)订单类型不为C-退货订单f)先销后采标识为空、或者02)若SAP订单类型为ZSIA且为