系统需求规格说明书书

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

2、..2.5.业务背景系统概述流程概览/系统框架系统规划与迭代功能模块系统功能需求3.1状态信息接受推送3.2最新站点查询服务3.3性能需求.3.4安全性需求3.5扩展性需求3.6兼容性需求3.7维护性需求系统非功能需求.9.9.10203434353535实用标准365.附录文案大全1. 关于本文档1.1.内容说明说明：此处描述的是文档说明，产品需求文档更新需要走修订模式，下次更新前先接受修订，并且每次更新必须更新版本 号和版本记录。例子:本文档用于描述苏宁开放平台物流状态服务系统的需求定义。包括各个需求的功能描述，处理逻辑规则，界面定义，与其它功能的

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

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

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

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

7、面单向电子面单转变。只要合作伙伴对接了苏宁电子面单服务，那么就可以享受苏宁物流体系的电子面单服务。本系统当期功能主要包含:A、用户操作权限管理;B、配置数据信息管理;C、订单对应的作业单物流节点状态信息接收与分发功能;D、订单对应的作业单物流节点状态信息查询功能;LSQLWMLIVM社会渠道> 耶>T:砍！5削销售渠道商家ERP天猫商户_SUC/CIS_1 苏宁易购ECS_ 苏宁客服系统11皿。爲'家订单IIL系统OMS ii ASS售后个人销售（北 苏宁订单系统II研）四方服务平台三方作业平台4ASM售后商户销售服务订购丄kLAPI售后！接入1ASOP11 1ASOPOS

8、售后运营管理VSOD以旧换新查1 1ASOM 1四方服务详情系询服务ASA P11 1四方接单系统1统售后服务时效11 11 h订单服务能丄资源能力ASVP長务商管理IL1平台服务商23 流程概览/系统框架LAPIASOSASES自营订单服务系统售后作业系统苏宁帮客1=LAPIrLk加盟服务商说明：此处需要描述和图形化系统内部功能结构模块图, 经营分析 1 i丄I nII结算平台I-tTBT天眼可从架构和技术获取资源。清晰的系统架构对于系统的扩展性和-tt去爭存寻吉1111桂送Q斥系蜿维护性都非常有帮助，也便于开发和测试从整体上理解该系统的结构。11 fl11II nHp24系统规划与迭代说明

9、：此处说明对该系统的总体规划步骤，一期接入什么功能，二期接入什么功能达到什么业务效果。2.5.功能模块321.1章节说明：此处的列表和下面的功能需求是对应的，系统需求编号是唯一识别需求的标识。需求编号的规则见例子:主功能系统需求编号子功能优先级备注状态信息接收推LSQ_DDZF_MDZF_OOO1非采购类状态信息接收一级一期需求LSQ_DDZF_MDZF_OOO2状态信息发送一级一期需求送LSQ_DDZF_MDZF_OOO3状态转换一级一期需求OK n->r>1ccc r a二>接收计划物流节接收计划物流卩点信息点信自八、1 11 丿 4、最新站点查询服务SNPD_LSQ_S

10、SS_05最新站点查询服务二级一期需求详情调用服务SNPD_LSQ_SSS_06虚拟包裹信息接收与更新一级一期需求SNPD_LSQ_SSS_07BTC物流物流详情调用一级一期需求SNPD_LSQ_SSS_08CIC物流物流详情调用一级一期需求后台配置SNPD_LSQ_SSS_09后台配置一级一期需求快递100接入服务SNPD_LSQ_SSS_10快递100查询与推送运单信息一级二期需求物流详情查询SNP D_LSQ_SSS_11作业系统查询状态明细一级LES拆分需求3. 系统功能需求3.1状态信息接受推送3.1.1非采购类状态信息接收需求编号 LSQ DDZF MDZF 0001

11、说明:/功能的业务介绍和业务背景此处的需求编号，在一个系统中必现唯一存在并且最后 4位递增，规则：系统名_模块名_子功能名_序列号，如LSQ_DDZF_MDZF_0001 :系统名最长保留4位，模块名/子功能名最长4位，序列号最长4位不够4位补0比如 0001，如果是优化需求，需求编号不变，新增需求需求编号增加;处理流程和约束条件说明：此处是放上面功能的业务流程图和功能的业务逻辑约束条件流程图:输入用户名和密码未通过一击提交校验用户名和密码 十一通过登录失败登录成功通过结束说明：如果流程图比较大或比较多，请以单独的附件提供0约束步骤逻辑1功能入参确认1. 入参确认1）用户名;2）

12、 密码校验处理订单处理组织结果反馈页面原型说明:1.校验：用户名在数据库中唯一且存在;1）成立，继续后续校验2）不成立，返回报错：请输入正确的用户名密码2.校验：安全性:1）安全性不通过，则提示该登录可能存在安全隐患，请重新访问;2）安全性通过，则继续下面,1. 全部校验通过:1）提示：登录成功，数据库更新最后登录时间;2）可进入系统进行后续操作N/A，系统后台功能无页面有页面请截低保真的图，图片要能覆盖所描述的功能，以及页面访问路径。Suningjcom苏宁if加帝，'百换半曰达"100亍城市半曰达£0亍i咸市次曰达一 B三送 半B达 同愼件己4山时

13、次日达用户容箱/手机号J工号忘记密酣I免费注册立即豊录数据说明说明:N/A，系统后台功能无页面如果有页面校验请在此处用列表的形式说明各个页面各个控件的校验规则XX功能字段名数据类型页面长度小数位说明用户名字符10非空，必须包括大小写字母、字符，不可输入中文密码字符10非空，必须包括大小写字母、字符、特殊字符功能需求描述说明:1 ）功能描述，需要做到语言准确，结构清晰，须包括从用户角度和业务角度描述功能和业务场景；要尽可能少地从系统逻辑角度去撰写需求，多写业务逻辑以免干扰开发的最优设计。在需求中明确业务接口。2 ）版本优化，如果是优化功能采用修订模式在涉及到的所有原文

14、档（包括需求说明书、流程图、接口文档）上进行修改并标注，需求说明书需对应需求编号章节进行修改，这样便于研发和测试了解原功能，以便快速了解优化的业务判断回归场景。产品还需说明优化此功能的业务场景以及建议优化功能涉及相关使用场景。（0522版本）特别说明：修改的功能会影响系统对外提供的接口，需要这些接口的使用方对接口进行验证，并确认接口的变更登录1）针对登录功能，需要做安全性校验，实行https的方式，并且登录密码以 *显示，在日志打印中也以 *展示;2）登录功能，登录调用API接口 INTERFACE_LSQ_LOGIN_0001实现登录，需要保证数据传递的安全性。状态接受LSQ系统接收状态信息

15、，作如下处理:数据类型长度小数位说明ID字符32主键，系统自动生成的流水号外部流水号字符32外部传的流水号外部系统字符10当前外部订单对应的“外部系统”任务单号字符20当前外部订单对应的“外部订单编码”物流订单号字符30通过卖家ID查询客户信息匹配表，结果为查询到的 卖家ID对应的“客户编码”订单属性字符10当前外部订单对应的“苏宁业务类型”订单客户字符10若业务类型为“ C019 ”，则默认为“ ZVIN ”入仓前置任务单系统字符10在接收4PS销退入库单时，若orderFlag订单标记带 有9,则在下传装运条件时，传输“ 01 ”自营，其他 则按照原有逻辑传“ 06 ”第三方服务大类字符2

16、0固定赋值“ L01仓储”收入项字符20固定赋值“ L0101存量”服务产品字符4固定赋值“ L010101仓库保管”服务细节字符4根据物流中心匹配zlmt026，取属性，若属性=MD，则服务细节=L01010101 门店库存，否则为L01010102 中心仓库存商品属性字符60用物料号匹配商品主数据，取商品属性（当用计费明细的物料号 matnr时，首先做取前置0，然后再去关联MDM商品主数据）件数字符10回算表的lfimg网点描述字符60固定赋值“ L01仓储”实际交货数量数值13固定赋值“ L0101存量”数量单位字符3固定赋值“ L010101仓库保管”排程日期时间字符14若订单对应的基

17、本信息的“预期送达开始时间”为空，且当前日期时间比当前日期时间18:00:00早，则为当前日期，否则为当前日期 +1天；若订单对应的基本信息“预期送达开始时间”不为 空，则取该时间中的日期，格式为 YYYY-MM-DD接收日期时间字符19系统当前日期接口说明说明：如果字段少可直接把接口列表贴这里，接口模板见下表必须包括深度和返回消息，如果有不同返回码也需要并定义。每个接口在需求文档中撰写一个编号，在系统中唯一，以便附件中能快速找到对应的接口，便于定期维护，接口编号：规则一个系统唯一：INTERFACE_系统名_一级模块名_编号递增产品定义的接口只需提供到中文字段名、长度、是否必须

18、，校验说明即可。API 接口 INTERFACE_LSQ_LOGIN_0001深度名称描述类型长度是否必输说明1INPUT请求输入2ITEM3username用户名CHAR(10)必输不可为空3P assword密码CHAR(10)必输不可为空3token盾牌CHAR(30)必输不可为空1OUTPUT请求输出2username用户名CHAR(30)必输2returnCode结果状态CHAR(10)必输0-成功，1-失败2Message文本描述CHAR(255)接收成功/接收失败returnCode 返回码说明:快递公司验证returnCodeMessage快递100需要做的操作LSQ订阅成功2

19、00成功LSQ数据验证失败400数据不完整补充数据，重新订阅LSQ格式验证失败500请求格式错误程序有问题，需要调整本地服务器错误501服务器错误30分钟后尝试LSQ订阅日志已存在502重复订阅理解为订阅成功LAPI校验KEY错误503验证签名失败使用正确的KEYLSQ未查到对应物流单号504单号错误更正单号LSQ未查到对应物流单号507查询异常状态接收接口 INTERFACE_LSQ_STATUS_0001由于字段较多见附件，每个接口在需求文档中撰写一个编号，规则一个系统唯一：INTERFACE系统名_一级模块名编号递增该功能处理过程中会调用以下接口（见附件）接口编号接口名称原系统目标系统场

20、景INTERFACE_LSQ_LOGIN_0001API登录接口LSQAPI处理成功，登录成功INTERFACE_LSQ_STATUS_0001状态信息同步LSQLOS/TMS/LWMSLSQMQ信息处理成功记录到 LSQ系统其它说明说明：可以把性能需求或者安全性，稳定性需求，页面浏览器兼容性需求等等放此处3.1.2状态信息发送需求编号 LSQ DDZF MDZF 000处理流程和约束条件彳t步骤逻辑10订单判断1.使用订单行号查询本地是否存在对应的订单行1）存在，继续后续判断；2）不存在，进入后续校验；2.3.4.判断订单行状态:1）如果订单行状态

21、10-已提交，12-订单异常，进入后续校验;2）如果订单行状态大于等于20-处理成功，直接返回成功;判断订单是否存在后续退货订单;1）存在，返回报错：该订单状态准确，不可进行支付2）不存在，进入后续校验;判断订单支付金额是否正确，判断等式：行项目销售额支付金额之和+使用积分金额+经理卡金额，是否成立;1）成立，继续后续处理2）不成立：支付金额不正确，请检查后重新输入;20订单支付信息处.5.订单行支付状态设置：将所有订单行状态都置为:保存新增的支付信息;覆盖本地已有的优惠单信息;冻结标志设置：如果订单支付信息中含有:单行冻结标识置为：D2-支票冻结;+运费+服务费=30-已支付;

22、4001 （支票支付），则将订支付确认标记设置：门店订单【支付确认开关】为打开状态时，对于满足以下条件的订单行项目，将订单行支付确认标识置为:0-未确认支付;1)分销渠道为10-零售、20-代购,2)且来源系统为POS。3)SAP订单类型为ZOR-标准订单、IDOC、Z01、ZGF。4)装运条件为01、14。5)先销后采标识不为 5。20订单支付信息处1.调用【公共规则-资源处理】功能;1)成功，将订单行状态置为：20-已处理，订单头状态：20-已处理;2)失败，将订单行状态置为：12-处理失败，订单头状态置为：12-处理失败;30组织结果反馈1.根据处理结果，组织结果反馈;40实时同步1.

23、OMSD全量：调用功能【公共功能-订单全量信息分发 OMSD】2. OMSQ全量：调用功能【公共功能-订单全量信息分发 OMSQ】50异步同步1.BI-大数据系统：调用【公共规则-】2.PMS-价格中心系统：调用【公共规则-】3.SPCS-云商卡系统：调用【公共规则-】4.BUDS-财务系统：调用【公共规则】60日志打印打日志：OMS订单号，OMS行订单号，订单支付完成时间，预计出库时间，期望送达时间，支付订单创建时间，SAP订单类型，先销后采标识,订单来源，下单时间，渠道，行项目类别，分次发货标识，支付类型(04门店支付)，支付确认标识，日志阶段：02( 01提交，02支付，03支付确认，0

24、4还欠款)id ( 10000055 )页面原型N/A，系统后台功能无页面3.124数据说明N/A，系统后台功能无页面3.125功能需求描述针对以下业务场景，前端系统通过该功能完成门店订单收款处理;5t场景接口()电器门店零售订单收银台全款支付处理P0 S-OMS-008 操作码：D(/)电器门店对公云商卡订单收银台全款支付处!理P0 S-0MS-008 操作码：D3.126接口说明3.127其它说明3.2最新站点查询服务3.2.1 最新站点查询 需求编号 LSQ DDTJ DDTJ 000处理流程和约束条件接收到前端系统提交的订单后，进行订单提交相

25、关处理，具体逻辑如下:具体步骤逻辑如下:步骤逻辑I)提交订单前端系统通过以下接口提交订单，且订单类型为该功能:SP OS-OMS-001B2C-OMS-001ALL-OMS-001A时，进入ALL-OMS-016进行订单合法性根据接口传入订单信息进行合法性校验:校验1.订单重复性校验2.若接口输入的接单模式为1或者3，则进行订单金额校验1)判断行优惠单金额是否正确。校验公式：行优惠单金额行优惠单明细金额汇总a）若不正确，则返回报错:订单行“前端系统行项目号2)3)“的优惠单总金额与优惠单明细不一致。b）否则进行一下步判断若订单提交接口为 ALL-OMS-001 ，则需判断行销售额是否正确，校验

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

27、金额之和：a）若不正确，则返回报错：订单行“前端系统行项目号“的总支付金额与应付金额不一致。b）否则进行一下步判断3.根据校验结果:1）若以上所有校验通过，则进入下一步“30-生成或更新订单信息”步骤2）若以上任意校验失败，则进入“50-返回处理结果”步骤生成或更新订单根据接口传入的订单信息创建订单信息或全量更新以下信息:信息1.若是创建订单，则根据单号规则生成订单号和订单行号2.进行订单状态设置1)进行订单行总状态设置，具体逻辑见“表-订单行总状态（IS）设置逻辑”2)进行订单行支付状态设置，具体逻辑见“表-订单行支付状态（IP）设置逻辑”3.3)4)进行订单行发票状态设置，默认设置为IV=

28、10进行订单头总状态设置进行订单特殊标记设置1）进行订单行冻结标识设置a）若分销渠道=30，且订单来源为 CRM，则设置分次实用标准实用标准文案大全8）若订单行类别=22，则需要保存独立服务扩展信息9）若订单行类别=24，则需要保存运费险扩展信息6.若接口传入的支付方式含9002-货到付款、9003-融合支付,则需要保存还欠款信息7.订单信息保存后，根据接单模式:1)2)3)4 进行订单处理调5 返回处理结果6 记录日志信息.3.若订单保存成功，且接口传入的接单模式为1，则进入下步“ 40-订单调度处理”；若订单保存成功，且若接口传入的接单模式为2、3，则进入下一步“ 50-返回

29、处理结果”若订单保存失败，则直接进入下一步“ 50-返回处理结果”调用功能【OMS_ZYCL_ZYCL_001-资源处理（老流程）】进行处理根据30、40步骤的处理结果，返回对应信息1）若处理失败，则返回前端处理失败2）若处理成功，则返回前端处理成功进入下一步“记录日志信息”步骤若为。则:根据30、40步骤的处理结果1）若处理失败，则结束本次提交流程2）若处理成功，则继续进行后续“ 70-保存或更新订单信息”、“ 80-异步分发订单”和“90-保存待分发信息”步保存或更新订单1.保存BUDS信息信息1）满足以下所有条件，保存该订单行支付明细到BUDS 支付明细信息中a）订单行项目类别不为16

30、b）订单行支付中存在 9001-香港欠款、9002-货到付款、或者9005-对公欠款2.设置订单实时处理标记。1)满足以下所有条件设置实时处理标记为丫a)行项目类别为10-实体、12-赠品b)“装运条件为空-自提、17-物流门店库自提、20-物流门店库自提”或者“装运条件为02-门店自提且SAP订单类型=IDOC ”c)分次发货标识为 A-只允许一次发货、或者D2-支票冻结d)订单行状态=20e)订单类型不为C-退货订单f)先销后采标识为空、或者 02)若SAP订单类型为ZSIA且为10渠道（门店互联开卡订单），则设置实时处理标记为 丫3.3)其他情况，不设置实时处理标记保存订单展示价信息:1

31、) 若调用接口为 B2C-OMS-001 ，则需要保存订单展示价:a)若接口传入的展示价(displayPrice )有值，则保存该字段的值为订单展示价b)若接口传入的展示价(displayPrice )无值，则保存订单展示价为接口传入的销售价( price)-发票虚增价2)其他调用接口不进行处理8异步分发订单1.订单行实时分发 OMSD1)满足以下所有条件的订单实时分发OMSD，通过接口(OMS-OMSD-001a)订单行总状态为20-已处理、40-已发货、或者 60-已完成b)订单行项目类别<>13-礼品卡c)分次发货标识为A-只允许一次发货、或者D2-支票冻结d)订单行支付确

32、认标识为空、1-已支付确认2.订单行实时分发 OMSQ1) 满足以下所有条件的订单实时分发OMSQ，通过接口(OMS-OMSQ-001 )9保存待分发信息1.满足以下条件保存待分发已支付订单信息到BI,通过接口(OMS-BI-002 )1) 订单类型为A- 一般销售订单、B-虚拟订单实用标准实用标准文案大全6)7)8)9)a)b)C）订单行先销后采标识为：7、或者9订单行总状态（IS） >=20订单方向=1-正向订单满足以下条件保存待分发 IDOC订单（3C类）信息，通过接口 (OMS-SAP-038 )a)b)C)订单行SAP订单类型=IDOC订单行总状态（IS） >=20订单方

33、向=1-正向订单满足以下条件保存待分发账期支付订单信息，通过接口(OMS-SAP-053)a)b)C)订单渠道为：10、20、30、40、或者50订单行支付状态（IP）=30订单行支付明细中包含9102支付方式满足以下条件保存待分发合约机手机行结算信息,a)b)C)d)通过接(OMS-SAP-032)订单行项目类别为：10-实体订单行存在合约关联关系订单行关联的合约行的 SAP订单类型为:IDOC 或者 ZSIM订单行总状态（IS）>=20满足以下条件保存待分发合约机合约行结算信息,口( OMS-SAP-033)通过接实用标准实用标准321.3页面原型N/A，系统后台功能无页面321.4数据说明N/A，系统后台功能无页面321.5功能需求描述针对以下业务场景，前端系统提交订单至 OMS ,OMS进行订单提交的合法校验，订单提交的资源处理以及订单保存,并根据对应的场景，判断是否调用后续处理。*接单模式：1-一步式需处理资源；2-两步式需处理资源；3- 一步式无需处理资源接口说明该功能处理过程中会调用以下接口:接口编号接口名称目标系统场