系統(tǒng)需求規(guī)格說明書

1、 XXX系統(tǒng)或XXX項(xiàng)目產(chǎn)品需求規(guī)格說明書文件狀態(tài)： 草稿 正式發(fā)布 正在修改文件編號(hào)：SN_SR_001當(dāng)前版本：V1.0作 者：完成日期：2017-04-11版本信息版本時(shí)間狀態(tài)更新人簡要描述審核人審核時(shí)間V1.0V1.01V1.2V1.3V1.4注：狀態(tài)可以為N-新建、A-增加、M-更改、D-刪除。對(duì)方的所得稅 說明：版本信息必須更新，審核人和審核時(shí)間也必須審核后填寫，審核人要求部門經(jīng)理級(jí)別以上。否則開發(fā)測試可拒絕評(píng)審。審核業(yè)務(wù)功能是否有遺漏、業(yè)務(wù)流程是否符合規(guī)劃、關(guān)鍵業(yè)務(wù)邏輯是否有合理目錄1.關(guān)于本文檔41.1.容說明41.2.名詞解釋41.3.參考文檔42.系統(tǒng)概述52.1.業(yè)務(wù)背景

2、52.2.系統(tǒng)概述62.3.流程概覽/系統(tǒng)框架72.4.系統(tǒng)規(guī)劃與迭代82.5.功能模塊83.系統(tǒng)功能需求93.1狀態(tài)信息接受推送93.2最新站點(diǎn)查詢服務(wù)194.系統(tǒng)非功能需求333.3性能需求333.4安全性需求343.5擴(kuò)展性需求343.6兼容性需求343.7維護(hù)性需求345.附錄341. 關(guān)于本文檔1.1. 容說明說明：此處描述的是文檔說明，產(chǎn)品需求文檔更新需要走修訂模式，下次更新前先接受修訂，并且每次更新必須更新版本號(hào)和版本記錄。例子：本文檔用于描述寧開放平臺(tái)物流狀態(tài)服務(wù)系統(tǒng)的需求定義。包括各個(gè)需求的功能描述，處理邏輯規(guī)則，界面定義，與其它功能的關(guān)系，與其它系統(tǒng)的接口等各個(gè)方面的定義。

3、是寧物流狀態(tài)服務(wù)系統(tǒng)唯一的全面需求定義文檔。本文檔將根據(jù)需求管理流程和要求，隨系統(tǒng)功能變化進(jìn)行與時(shí)的修訂和更新，以確保本文檔的全面性，準(zhǔn)確性和實(shí)效性。因此在閱讀使用此文檔時(shí)，請(qǐng)注意從項(xiàng)目的文檔管理系統(tǒng)中獲取最新版本。1.2. 名詞解釋詞匯名稱詞匯含義備注LSQ物流狀態(tài)服務(wù)系統(tǒng)LSP物流服務(wù)平臺(tái)LES 物流作業(yè)系統(tǒng)LWMS分布式倉儲(chǔ)管理系統(tǒng)TMS運(yùn)輸管理系統(tǒng)1.3. 參考文檔系統(tǒng)需求定義規(guī)使用說明v1.0.doc2. 系統(tǒng)概述2.1. 業(yè)務(wù)背景說明：此處描述業(yè)務(wù)背景，不可裁剪，清晰的業(yè)務(wù)背景描述能更好的幫助研發(fā)和測試?yán)斫猱a(chǎn)品需求，明確業(yè)務(wù)測試場景，此部分是產(chǎn)品需求定位的核心導(dǎo)向。例子一：電子面單

4、的業(yè)務(wù)描述隨著電子商務(wù)服務(wù)和物流服務(wù)信息化飛速發(fā)展，包裹運(yùn)單號(hào)成為快遞公司串聯(lián)快遞單、訂單、商家、商品等各種信息的樞紐。相比之下，傳統(tǒng)紙質(zhì)面單價(jià)格高、信息錄入效率低、信息安全隱患等方面的劣勢已愈發(fā)凸顯。我司在兩年前就開始了電子面單在自營物流上的應(yīng)用，經(jīng)過長期的的磨合和積累，目前將我司的應(yīng)用經(jīng)驗(yàn)推廣到社會(huì)物流上，讓社會(huì)上愿意與我司物流合作的伙伴，也同樣享受到我司電子面單服務(wù)。例子二：LSQ的業(yè)務(wù)描述物流作業(yè)狀態(tài)服務(wù)存在不足1）服務(wù)無標(biāo)準(zhǔn)不統(tǒng)一 需物流作業(yè)的各渠道訂單，作業(yè)狀態(tài)轉(zhuǎn)化為文案描述處理的邏輯系統(tǒng)多，且處理規(guī)不統(tǒng)一， B2C自營訂單，邏輯在B2C，數(shù)據(jù)源在OMS 菜鳥平臺(tái)/4PS平臺(tái)訂單狀

5、態(tài)展示，邏輯在LAPI，數(shù)據(jù)源在LAPI 物流門戶訂單狀態(tài)展示，邏輯在LPS，數(shù)據(jù)源在LOS 開放平臺(tái)訂單，邏輯在SOD，數(shù)據(jù)源在SOD R3自營訂單，無邏輯，數(shù)據(jù)源在R32）維度單一而不滿足新需求 不能滿足多樣化的展示需求，如目前只有訂單維度的狀態(tài)詳情展示，不支持任務(wù)單、顧客包裹等維度的詳情服務(wù)。 同時(shí)，缺乏物流特定作業(yè)狀態(tài)的高實(shí)時(shí)性精確查詢服務(wù)（如是否銷單完成，是否過賬，最新站點(diǎn)是哪個(gè)等）。3）開放服務(wù)的渠道有待拓展 目前，物流沒有一個(gè)公網(wǎng)渠道，使顧客能快速查詢?cè)趯幐髑烙唵蔚淖鳂I(yè)狀態(tài)信息。故設(shè)計(jì)一個(gè)物流狀態(tài)系統(tǒng)統(tǒng)一管理物流狀態(tài)的收發(fā)，狀態(tài)描述轉(zhuǎn)換，以與提供狀態(tài)服務(wù)查詢。2.2. 系統(tǒng)概述

6、說明：系統(tǒng)說明包括文字部分和圖形部分，文字部分主要描述系統(tǒng)之間的關(guān)聯(lián)關(guān)系，圖形主要包括系統(tǒng)和相關(guān)聯(lián)系統(tǒng)之間的交互結(jié)構(gòu)，不可裁剪例子一：系統(tǒng)說明合作伙伴申請(qǐng)寧電子面單服務(wù)，選擇相應(yīng)的合作模式，由合作伙伴提供預(yù)配送包裹的信息，由寧電子面單服務(wù)生成相應(yīng)的面單信息，并由合作伙伴系統(tǒng)打印出來并完成包裝，最終投遞給寧網(wǎng)點(diǎn)且面單能被寧物流體系識(shí)別。系統(tǒng)之間的關(guān)聯(lián)關(guān)系：寧電子面單服務(wù)是基于寧自營物流電子面單應(yīng)用，整合社會(huì)上多家快遞公司，搭建一套具有寧配送特色的電子面單服務(wù)體系，為寧物流的合作伙伴提供統(tǒng)一的電子面單服務(wù)。實(shí)現(xiàn)了，合作伙伴對(duì)接寧的物流服務(wù)，由使用紙質(zhì)面單向電子面單轉(zhuǎn)變。只要合作伙伴對(duì)接了寧電子面單

7、服務(wù)，那么就可以享受寧物流體系的電子面單服務(wù)。本系統(tǒng)當(dāng)期功能主要包含：A、用戶操作權(quán)限管理；B、配置數(shù)據(jù)信息管理；C、訂單對(duì)應(yīng)的作業(yè)單物流節(jié)點(diǎn)狀態(tài)信息接收與分發(fā)功能；D、訂單對(duì)應(yīng)的作業(yè)單物流節(jié)點(diǎn)狀態(tài)信息查詢功能；2.3. 流程概覽/系統(tǒng)框架說明：此處需要描述和圖形化系統(tǒng)部功能結(jié)構(gòu)模塊圖，可從架構(gòu)和技術(shù)獲取資源。清晰的系統(tǒng)架構(gòu)對(duì)于系統(tǒng)的擴(kuò)展性和維護(hù)性都非常有幫助，也便于開發(fā)和測試從整體上理解該系統(tǒng)的結(jié)構(gòu)。2.4. 系統(tǒng)規(guī)劃與迭代說明：此處說明對(duì)該系統(tǒng)的總體規(guī)劃步驟，一期接入什么功能，二期接入什么功能達(dá)到什么業(yè)務(wù)效果。2.5. 功能模塊說明：此處的列表和下面的功能需對(duì)應(yīng)的，系統(tǒng)需求編號(hào)是唯一識(shí)別需

8、求的標(biāo)識(shí)。需求編號(hào)的規(guī)則見3.2.1.1章節(jié)例子：主功能系統(tǒng)需求編號(hào)子功能優(yōu)先級(jí) 備注狀態(tài)信息接收推送LSQ_DDZF_MDZF_0001非采購類狀態(tài)信息接收一級(jí)一期需求LSQ_DDZF_MDZF_0002狀態(tài)信息發(fā)送一級(jí)一期需求LSQ_DDZF_MDZF_0003狀態(tài)轉(zhuǎn)換一級(jí)一期需求接收計(jì)劃物流節(jié)點(diǎn)信息SNPD_LSQ_SSS_04接收計(jì)劃物流節(jié)點(diǎn)信息二級(jí)最新站點(diǎn)查詢服務(wù)SNPD_LSQ_SSS_05最新站點(diǎn)查詢服務(wù)二級(jí)一期需求詳情調(diào)用服務(wù)SNPD_LSQ_SSS_06虛擬包裹信息接收與更新一級(jí)一期需求SNPD_LSQ_SSS_07BTC物流物流詳情調(diào)用一級(jí)一期需求SNPD_LSQ_SSS_

9、08CIC物流物流詳情調(diào)用一級(jí)一期需求后臺(tái)配置SNPD_LSQ_SSS_09后臺(tái)配置一級(jí)一期需求快遞100接入服務(wù)SNPD_LSQ_SSS_10快遞100查詢與推送運(yùn)單信息一級(jí)二期需求物流詳情查詢SNPD_LSQ_SSS_11作業(yè)系統(tǒng)查詢狀態(tài)明細(xì)一級(jí)LES拆分需求3. 系統(tǒng)功能需求3.1 狀態(tài)信息接受推送3.1.1 非采購類狀態(tài)信息接收3.1.1.1 需求編號(hào)LSQ_DDZF_MDZF_0001說明：/功能的業(yè)務(wù)介紹和業(yè)務(wù)背景此處的需求編號(hào)，在一個(gè)系統(tǒng)中必現(xiàn)唯一存在并且最后4位遞增，規(guī)則：系統(tǒng)名_模塊名_子功能名_序列號(hào)，如LSQ_DDZF_MDZF_0001： 系統(tǒng)名最長保留4位，模塊名/子

10、功能名最長4位，序列號(hào)最長4位不夠4位補(bǔ)0比如0001，如果是優(yōu)化需求，需求編號(hào)不變，新增需求需求編號(hào)增加；3.1.1.2 處理流程和約束條件說明：此處是放上面功能的業(yè)務(wù)流程圖和功能的業(yè)務(wù)邏輯約束條件流程圖：說明：如果流程圖比較大或比較多，請(qǐng)以單獨(dú)的附件提供約束#步驟邏輯10功能入?yún)⒋_認(rèn)1. 入?yún)⒋_認(rèn)1) 用戶名；2) 密碼2校驗(yàn)處理1. 校驗(yàn)：用戶名在數(shù)據(jù)庫中唯一且存在；1) 成立，繼續(xù)后續(xù)校驗(yàn)2) 不成立，返回報(bào)錯(cuò)：請(qǐng)輸入正確的用戶名密碼2. 校驗(yàn)：安全性：1) 安全性不通過，則提示該登錄可能存在安全隱患，請(qǐng)重新訪問；2) 安全性通過，則繼續(xù)下面，3訂單處理4組織結(jié)果反饋1. 全部校驗(yàn)通過

11、：1) 提示：登錄成功，數(shù)據(jù)庫更新最后登錄時(shí)間；2) 可進(jìn)入系統(tǒng)進(jìn)行后續(xù)操作3.1.1.3 頁面原型說明：N/A，系統(tǒng)后臺(tái)功能無頁面有頁面請(qǐng)截低保真的圖，圖片要能覆蓋所描述的功能，以與頁面訪問路徑。3.1.1.4 數(shù)據(jù)說明說明：N/A，系統(tǒng)后臺(tái)功能無頁面如果有頁面校驗(yàn)請(qǐng)?jiān)诖颂幱昧斜淼男问秸f明各個(gè)頁面各個(gè)控件的校驗(yàn)規(guī)則XX功能字段名數(shù)據(jù)類型頁面長度小數(shù)位說明用戶名字符10非空，必須包括大小寫字母、字符，不可輸入中文密碼字符10非空，必須包括大小寫字母、字符、特殊字符3.1.1.5 功能需求描述說明：1）功能描述，需要做到語言準(zhǔn)確，結(jié)構(gòu)清晰，須包括從用戶角度和業(yè)務(wù)角度描述功能和業(yè)務(wù)場景；要盡可能少

12、地從系統(tǒng)邏輯角度去撰寫需求，多寫業(yè)務(wù)邏輯以免干擾開發(fā)的最優(yōu)設(shè)計(jì)。在需求中明確業(yè)務(wù)接口。2）版本優(yōu)化，如果是優(yōu)化功能采用修訂模式在涉與到的所有原文檔（包括需求說明書、流程圖、接口文檔）上進(jìn)行修改并標(biāo)注，需求說明書需對(duì)應(yīng)需求編號(hào)章節(jié)進(jìn)行修改，這樣便于研發(fā)和測試了解原功能，以便快速了解優(yōu)化的業(yè)務(wù)判斷回歸場景。產(chǎn)品還需說明優(yōu)化此功能的業(yè)務(wù)場景以與建議優(yōu)化功能涉與相關(guān)使用場景。（0522版本）特別說明：修改的功能會(huì)影響系統(tǒng)對(duì)外提供的接口，需要這些接口的使用方對(duì)接口進(jìn)行驗(yàn)證，并確認(rèn)接口的變更登錄1） 針對(duì)登錄功能，需要做安全性校驗(yàn)，實(shí)行 s的方式，并且登錄密碼以*顯示，在日志打印中也以*展示；2） 登錄功

13、能，登錄調(diào)用API 接口INTERFACE_LSQ_LOGIN_0001實(shí)現(xiàn)登錄，需要保證數(shù)據(jù)傳遞的安全性。狀態(tài)接受LSQ系統(tǒng)接收狀態(tài)信息，作如下處理：數(shù)據(jù)類型長度小數(shù)位說明ID字符32主鍵，系統(tǒng)自動(dòng)生成的流水號(hào)外部流水號(hào)字符32外部傳的流水號(hào)外部系統(tǒng)字符10當(dāng)前外部訂單對(duì)應(yīng)的“外部系統(tǒng)”任務(wù)單號(hào)字符20當(dāng)前外部訂單對(duì)應(yīng)的“外部訂單編碼”物流訂單號(hào)字符30通過賣家ID查詢客戶信息匹配表，結(jié)果為查詢到的賣家ID對(duì)應(yīng)的“客戶編碼”訂單屬性字符10當(dāng)前外部訂單對(duì)應(yīng)的“寧業(yè)務(wù)類型”訂單客戶字符10若業(yè)務(wù)類型為“C019”，則默認(rèn)為“ZVIN”入倉前置任務(wù)單系統(tǒng)字符10在接收4PS銷退入庫單時(shí)，若ord

14、erFlag訂單標(biāo)記帶有9，則在下傳裝運(yùn)條件時(shí)，傳輸“01”自營，其他則按照原有邏輯傳“06”第三方服務(wù)大類字符20固定賦值“L01倉儲(chǔ)”收入項(xiàng)字符20固定賦值“L0101存量”服務(wù)產(chǎn)品字符4固定賦值“L010101倉庫保管”服務(wù)細(xì)節(jié)字符4根據(jù)物流中心匹配zlmt026，取屬性，若屬性=MD，則服務(wù)細(xì)節(jié)= L01010101門店庫存，否則為L01010102中心倉庫存商品屬性字符60用物料號(hào)匹配商品主數(shù)據(jù)，取商品屬性（當(dāng)用計(jì)費(fèi)明細(xì)的物料號(hào)matnr時(shí)，首先做取前置0 ，然后再去關(guān)聯(lián)MDM商品主數(shù)據(jù)）件數(shù)字符10回算表的lfimg網(wǎng)點(diǎn)描述字符60固定賦值“L01倉儲(chǔ)”實(shí)際交貨數(shù)量數(shù)值13固定賦值

15、“L0101存量”數(shù)量單位字符3固定賦值“L010101倉庫保管”排程日期時(shí)間字符14若訂單對(duì)應(yīng)的基本信息的“預(yù)期送達(dá)開始時(shí)間”為空，且當(dāng)前日期時(shí)間比當(dāng)前日期時(shí)間18:00:00早，則為當(dāng)前日期，否則為當(dāng)前日期+1天；若訂單對(duì)應(yīng)的基本信息“預(yù)期送達(dá)開始時(shí)間”不為空，則取該時(shí)間中的日期，格式為YYYY-MM-DD接收日期時(shí)間字符19系統(tǒng)當(dāng)前日期3.1.1.6 接口說明說明：如果字段少可直接把接口列表貼這里，接口模板見下表必須包括深度和返回消息，如果有不同返回碼也需要一并定義。每個(gè)接口在需求文檔中撰寫一個(gè)編號(hào)，在系統(tǒng)中唯一，以便附件中能快速找到對(duì)應(yīng)的接口，便于定期維護(hù)，接口編號(hào)：規(guī)則一個(gè)系統(tǒng)唯一：

16、INTERFACE_系統(tǒng)名_一級(jí)模塊名_編號(hào)遞增產(chǎn)品定義的接口只需提供到中文字段名、長度、是否必須，校驗(yàn)說明即可。API 接口INTERFACE_LSQ_LOGIN_0001深度名稱描述類型長度是否必輸說明1INPUT請(qǐng)求輸入2ITEM3username用戶名CHAR(10)必輸不可為空3Password密碼CHAR(10)必輸不可為空3token盾牌CHAR(30)必輸不可為空1OUTPUT請(qǐng)求輸出2username用戶名CHAR(30)必輸2returnCode結(jié)果狀態(tài)CHAR(10)必輸0-成功，1-失敗2Message文本描述CHAR(255)接收成功/接收失敗returnCode返回

17、碼說明：快遞公司驗(yàn)證returnCodeMessage快遞100需要做的操作LSQ訂閱成功200成功LSQ數(shù)據(jù)驗(yàn)證失敗400數(shù)據(jù)不完整補(bǔ)充數(shù)據(jù)，重新訂閱LSQ格式驗(yàn)證失敗500請(qǐng)求格式錯(cuò)誤程序有問題，需要調(diào)整本地服務(wù)器錯(cuò)誤501服務(wù)器錯(cuò)誤30分鐘后嘗試LSQ訂閱日志已存在502重復(fù)訂閱理解為訂閱成功LAPI校驗(yàn)KEY錯(cuò)誤503驗(yàn)證簽名失敗使用正確的KEYLSQ未查到對(duì)應(yīng)物流單號(hào)504單號(hào)錯(cuò)誤更正單號(hào)LSQ未查到對(duì)應(yīng)物流單號(hào)507查詢異常狀態(tài)接收接口INTERFACE_LSQ_STATUS_0001由于字段較多見附件，每個(gè)接口在需求文檔中撰寫一個(gè)編號(hào)，規(guī)則一個(gè)系統(tǒng)唯一：INTERFACE_系統(tǒng)名

18、_一級(jí)模塊名_編號(hào)遞增該功能處理過程中會(huì)調(diào)用以下接口（見附件）：接口編號(hào)接口名稱原系統(tǒng)目標(biāo)系統(tǒng)場景INTERFACE_LSQ_LOGIN_0001API登錄接口LSQAPI處理成功，登錄成功INTERFACE_LSQ_STATUS_0001狀態(tài)信息同步LSQLOS/TMS/LWMSLSQMQ信息處理成功記錄到LSQ系統(tǒng)3.1.1.7 其它說明說明：可以把性能需求或者安全性，穩(wěn)定性需求，頁面瀏覽器兼容性需求等等放此處3.1.2 狀態(tài)信息發(fā)送3.1.2.1 需求編號(hào)LSQ_DDZF_MDZF_00023.1.2.2 處理流程和約束條件#步驟邏輯10訂單判斷1. 使用訂單行號(hào)查詢本地是否存在對(duì)應(yīng)的訂

19、單行1) 存在，繼續(xù)后續(xù)判斷；2) 不存在，進(jìn)入后續(xù)校驗(yàn)；2. 判斷訂單行狀態(tài)：1) 如果訂單行狀態(tài)10-已提交，12-訂單異常，進(jìn)入后續(xù)校驗(yàn)；2) 如果訂單行狀態(tài)大于等于20-處理成功，直接返回成功；3. 判斷訂單是否存在后續(xù)退貨訂單；1) 存在，返回報(bào)錯(cuò)：該訂單狀態(tài)準(zhǔn)確，不可進(jìn)行支付2) 不存在，進(jìn)入后續(xù)校驗(yàn)；4. 判斷訂單支付金額是否正確，判斷等式：行項(xiàng)目銷售額+運(yùn)費(fèi)+服務(wù)費(fèi)=支付金額之和+使用積分金額+經(jīng)理卡金額，是否成立；1) 成立，繼續(xù)后續(xù)處理2) 不成立：支付金額不正確，請(qǐng)檢查后重新輸入；20訂單支付信息處理1. 訂單行支付狀態(tài)設(shè)置：將所有訂單行狀態(tài)都置為：30-已支付；2. 保

20、存新增的支付信息；3. 覆蓋本地已有的優(yōu)惠單信息；4. 凍結(jié)標(biāo)志設(shè)置：如果訂單支付信息中含有：4001（支票支付），則將訂單行凍結(jié)標(biāo)識(shí)置為：D2-支票凍結(jié)；5. 支付確認(rèn)標(biāo)記設(shè)置：門店訂單支付確認(rèn)開關(guān)為打開狀態(tài)時(shí)，對(duì)于滿足以下條件的訂單行項(xiàng)目，將訂單行支付確認(rèn)標(biāo)識(shí)置為：0-未確認(rèn)支付；1) 分銷渠道為10-零售、20-代購，2) 且來源系統(tǒng)為POS。3) SAP訂單類型為ZOR-標(biāo)準(zhǔn)訂單、IDOC、Z01、ZGF。4) 裝運(yùn)條件為01、14。5) 先銷后采標(biāo)識(shí)不為5。20訂單支付信息處理1. 調(diào)用公共規(guī)則-資源處理功能；1) 成功，將訂單行狀態(tài)置為：20-已處理，訂單頭狀態(tài)：20-已處理；2)

21、 失敗，將訂單行狀態(tài)置為：12-處理失敗，訂單頭狀態(tài)置為：12-處理失??；30組織結(jié)果反饋1. 根據(jù)處理結(jié)果，組織結(jié)果反饋；40實(shí)時(shí)同步1. OMSD全量：調(diào)用功能公共功能-訂單全量信息分發(fā)OMSD2. OMSQ全量：調(diào)用功能公共功能-訂單全量信息分發(fā)OMSQ50異步同步1. BI-大數(shù)據(jù)系統(tǒng)：調(diào)用公共規(guī)則-2. PMS-價(jià)格中心系統(tǒng)：調(diào)用公共規(guī)則-3. SPCS-云商卡系統(tǒng)：調(diào)用公共規(guī)則-4. BUDS-財(cái)務(wù)系統(tǒng)：調(diào)用公共規(guī)則60日志打印打日志：OMS訂單號(hào)，OMS行訂單號(hào)，訂單支付完成時(shí)間，預(yù)計(jì)出庫時(shí)間，期望送達(dá)時(shí)間 ，支付訂單創(chuàng)建時(shí)間,SAP訂單類型，先銷后采標(biāo)識(shí)，訂單來源，下單時(shí)間，渠

22、道，行項(xiàng)目類別，分次發(fā)貨標(biāo)識(shí)，支付類型（04門店支付），支付確認(rèn)標(biāo)識(shí)，日志階段：02（01提交，02支付，03支付確認(rèn)，04還欠款）id（10000055）3.1.2.3 頁面原型N/A，系統(tǒng)后臺(tái)功能無頁面3.1.2.4 數(shù)據(jù)說明N/A，系統(tǒng)后臺(tái)功能無頁面3.1.2.5 功能需求描述針對(duì)以下業(yè)務(wù)場景，前端系統(tǒng)通過該功能完成門店訂單收款處理；#場景接口01電器門店零售訂單收銀臺(tái)全款支付處理POS-OMS-008 操作碼：D02電器門店對(duì)公云商卡訂單收銀臺(tái)全款支付處理POS-OMS-008 操作碼：D3.1.2.6 接口說明3.1.2.7 其它說明3.2 最新站點(diǎn)查詢服務(wù)3.2.1 最新站點(diǎn)查詢3

23、.2.1.1 需求編號(hào)LSQ_DDTJ_DDTJ_00033.2.1.2 處理流程和約束條件接收到前端系統(tǒng)提交的訂單后，進(jìn)行訂單提交相關(guān)處理，具體邏輯如下：具體步驟邏輯如下：#步驟邏輯10提交訂單前端系統(tǒng)通過以下接口提交訂單，且訂單類型為A時(shí)，進(jìn)入該功能：Ø SPOS-OMS-001Ø B2C-OMS-001Ø ALL-OMS-001Ø ALL-OMS-01620進(jìn)行訂單合法性校驗(yàn)根據(jù)接口傳入訂單信息進(jìn)行合法性校驗(yàn)：1. 訂單重復(fù)性校驗(yàn)2. 若接口輸入的接單模式為1或者3，則進(jìn)行訂單金額校驗(yàn)1) 判斷行優(yōu)惠單金額是否正確。校驗(yàn)公式：行優(yōu)惠單金額 = 行優(yōu)

24、惠單明細(xì)金額匯總：a) 若不正確，則返回報(bào)錯(cuò)：訂單行“前端系統(tǒng)行項(xiàng)目號(hào)“的優(yōu)惠單總金額與優(yōu)惠單明細(xì)不一致。b) 否則進(jìn)行一下步判斷2) 若訂單提交接口為ALL-OMS-001，則需判斷行銷售額是否正確，校驗(yàn)公式：行銷售額 = 銷售價(jià) * 數(shù)量：a) 若不正確，則返回報(bào)錯(cuò)：訂單行“前端系統(tǒng)行項(xiàng)目號(hào)“的銷售額”XX”不等于銷售價(jià)格”XX”*數(shù)量”XX”。b) 否則進(jìn)行一下步判斷3) 若訂單提交接口為ALL-OMS-001，則需判斷行應(yīng)付金額是否與支付明細(xì)匯總金額一致，校驗(yàn)公式：行項(xiàng)目銷售額+運(yùn)費(fèi)+服務(wù)費(fèi)=支付金額之和+使用積分?jǐn)?shù)金額+經(jīng)理卡金額：a) 若不正確，則返回報(bào)錯(cuò)：訂單行“前端系統(tǒng)行項(xiàng)目號(hào)

25、“的總支付金額與應(yīng)付金額不一致。b) 否則進(jìn)行一下步判斷4) 若訂單提交接口為B2C-OMS-001，則需判斷行應(yīng)付金額是否與支付明細(xì)匯總金額一致，校驗(yàn)公式：銷售價(jià)*數(shù)量-經(jīng)理卡金額+運(yùn)費(fèi)+行稅額+服務(wù)費(fèi)=支付金額之和：a) 若不正確，則返回報(bào)錯(cuò)：訂單行“前端系統(tǒng)行項(xiàng)目號(hào)“的總支付金額與應(yīng)付金額不一致。b) 否則進(jìn)行一下步判斷3. 根據(jù)校驗(yàn)結(jié)果：1) 若以上所有校驗(yàn)通過，則進(jìn)入下一步“30-生成或更新訂單信息”步驟2) 若以上任意校驗(yàn)失敗，則進(jìn)入“50-返回處理結(jié)果”步驟30生成或更新訂單信息根據(jù)接口傳入的訂單信息創(chuàng)建訂單信息或全量更新以下信息：1. 若是創(chuàng)建訂單，則根據(jù)單號(hào)規(guī)則生成訂單號(hào)和訂

26、單行號(hào)2. 進(jìn)行訂單狀態(tài)設(shè)置1) 進(jìn)行訂單行總狀態(tài)設(shè)置，具體邏輯見“表-訂單行總狀態(tài)（IS）設(shè)置邏輯”2) 進(jìn)行訂單行支付狀態(tài)設(shè)置，具體邏輯見“表-訂單行支付狀態(tài)（IP）設(shè)置邏輯”3) 進(jìn)行訂單行發(fā)票狀態(tài)設(shè)置，默認(rèn)設(shè)置為IV=104) 進(jìn)行訂單頭總狀態(tài)設(shè)置3. 進(jìn)行訂單特殊標(biāo)記設(shè)置1) 進(jìn)行訂單行凍結(jié)標(biāo)識(shí)設(shè)置a) 若分銷渠道=30，且訂單來源為CRM，則設(shè)置分次發(fā)貨標(biāo)記為D3-對(duì)公訂單未付款凍結(jié)b) 否則，如訂單支付方式中含有4001：支票支付，則設(shè)置分次發(fā)貨標(biāo)記為：D2-支票交貨凍結(jié)c) 否則，對(duì)于其他場景設(shè)置分次發(fā)貨標(biāo)記為A-只允許一次發(fā)貨2) 進(jìn)行訂單行大客戶付款類型設(shè)置。滿足以下所有條

27、件，設(shè)置大客戶付款類型為1-確認(rèn)欠款：a) 訂單來源為SPCSb) 行項(xiàng)目類別為16-云商卡訂單c) 接單模式為1d) 支付方式含90053) 進(jìn)行訂單行是否需要發(fā)票設(shè)置4. 根據(jù)接口傳入訂單信息保存訂單基本信息5. 根據(jù)接口傳入訂單擴(kuò)展信息保存訂單相關(guān)擴(kuò)展信息1) 若訂單行類別= 10，且接口中存在服務(wù)商品，則需要保存服務(wù)擴(kuò)展信息2) 若訂單行類別=11，則需要保存延保擴(kuò)展信息3) 若訂單行類別=12，則需要保存贈(zèng)品擴(kuò)展信息4) 若訂單行類別=13，則需要保存虛擬商品信息5) 若訂單行類別=14，則需要保存合約擴(kuò)展信息6) 若訂單行類別=16，則需要保存云商卡擴(kuò)展信息7) 若訂單行類別=20

28、，電子書無擴(kuò)展信息，無需保存8) 若訂單行類別=22，則需要保存獨(dú)立服務(wù)擴(kuò)展信息9) 若訂單行類別=24，則需要保存運(yùn)費(fèi)險(xiǎn)擴(kuò)展信息6. 若接口傳入的支付方式含9002-貨到付款、9003-融合支付，則需要保存還欠款信息7. 訂單信息保存后，根據(jù)接單模式：1) 若訂單保存成功，且接口傳入的接單模式為1，則進(jìn)入下一步“40-訂單調(diào)度處理”；2) 若訂單保存成功，且若接口傳入的接單模式為2、3，則進(jìn)入下一步“50-返回處理結(jié)果”3) 若訂單保存失敗，則直接進(jìn)入下一步“50-返回處理結(jié)果”40進(jìn)行訂單處理調(diào)度調(diào)用功能OMS_ZYCL_ZYCL_001-資源處理（老流程）進(jìn)行處理50返回處理結(jié)果1. 根

29、據(jù)30、40步驟的處理結(jié)果，返回對(duì)應(yīng)信息1) 若處理失敗，則返回前端處理失敗2) 若處理成功，則返回前端處理成功2. 進(jìn)入下一步“記錄日志信息”步驟60記錄日志信息1. 若為。則：2.3. 根據(jù)30、40步驟的處理結(jié)果1) 若處理失敗，則結(jié)束本次提交流程2) 若處理成功，則繼續(xù)進(jìn)行后續(xù) “70-保存或更新訂單信息”、“80-異步分發(fā)訂單”和“90-保存待分發(fā)信息”步驟70保存或更新訂單信息1. 保存BUDS信息1) 滿足以下所有條件，保存該訂單行支付明細(xì)到BUDS支付明細(xì)信息中a) 訂單行項(xiàng)目類別不為16b) 訂單行支付中存在9001-欠款、9002-貨到付款、或者9005-對(duì)公欠款2. 設(shè)置

30、訂單實(shí)時(shí)處理標(biāo)記。1) 滿足以下所有條件設(shè)置實(shí)時(shí)處理標(biāo)記為Y a) 行項(xiàng)目類別為10-實(shí)體、12-贈(zèng)品b) “裝運(yùn)條件為空-自提、17-物流門店庫自提、20-物流門店庫自提”或者“裝運(yùn)條件為02-門店自提且SAP訂單類型=IDOC”c) 分次發(fā)貨標(biāo)識(shí)為A-只允許一次發(fā)貨、或者D2-支票凍結(jié)d) 訂單行狀態(tài)>=20e) 訂單類型不為C-退貨訂單f) 先銷后采標(biāo)識(shí)為空、或者02) 若SAP訂單類型為ZSIA且為10渠道（門店互聯(lián)開卡訂單），則設(shè)置實(shí)時(shí)處理標(biāo)記為Y3) 其他情況，不設(shè)置實(shí)時(shí)處理標(biāo)記3. 保存訂單展示價(jià)信息：1) 若調(diào)用接口為B2C-OMS-001，則需要保存訂單展示價(jià)：a) 若

31、接口傳入的展示價(jià)（displayPrice）有值，則保存該字段的值為訂單展示價(jià)b) 若接口傳入的展示價(jià)（displayPrice）無值，則保存訂單展示價(jià)為接口傳入的銷售價(jià)（price）- 發(fā)票虛增價(jià)2) 其他調(diào)用接口不進(jìn)行處理80異步分發(fā)訂單1. 訂單行實(shí)時(shí)分發(fā)OMSD1) 滿足以下所有條件的訂單實(shí)時(shí)分發(fā)OMSD，通過接口（OMS-OMSD-001）a) 訂單行總狀態(tài)為20-已處理、40-已發(fā)貨、或者60-已完成b) 訂單行項(xiàng)目類別<>13-禮品卡c) 分次發(fā)貨標(biāo)識(shí)為A-只允許一次發(fā)貨、或者D2-支票凍結(jié)d) 訂單行支付確認(rèn)標(biāo)識(shí)為空、1-已支付確認(rèn)2. 訂單行實(shí)時(shí)分發(fā)OMSQ1)

32、滿足以下所有條件的訂單實(shí)時(shí)分發(fā)OMSQ，通過接口（OMS-OMSQ-001）90保存待分發(fā)信息1. 滿足以下條件保存待分發(fā)已支付訂單信息到BI，通過接口（OMS-BI-002）1) 訂單類型為A-一般銷售訂單、B-虛擬訂單2) 行項(xiàng)目類別為：3) 訂單渠道為：4) 訂單行總狀態(tài)>=20-已處理5) 分次發(fā)貨標(biāo)識(shí)不為D3-對(duì)公支付2. 滿足以下條件保存待分發(fā)未支付訂單信息到BI，通過接口（OMS-BI-003）1)3. 滿足以下條件保存待分發(fā)已支付訂單信息到PMS，通過接口（OMS-PMS-002）1) 訂單類型為A-一般銷售訂單2) 訂單行項(xiàng)目類別為：3) 訂單行先銷后采標(biāo)識(shí)為：0、1、

33、2、3、4、6、或者94) 訂單渠道為：10、20、30（且訂單來源為CRM）、50、或者605) 訂單行總狀態(tài)>=20-已處理6) 訂單行分次發(fā)貨標(biāo)識(shí)不為D3-對(duì)公支付4. 滿足以下條件保存待分發(fā)已支付訂單信息到POS，通過接口（OMS-POS-0?）5. 保存待分發(fā)已支付訂單信息到SAP1) 滿足以下條件保存待分發(fā)IDOC訂單信息，通過接口（OMS-SAP-022）a) 訂單行SAP訂單類型=IDOCb) 訂單行總狀態(tài)（IS）>=20c) 訂單方向=1-正向訂單2) 滿足以下條件保存待分發(fā)合約機(jī)訂單信息，通過接口（OMS-SAP-011）a) 訂單行SAP訂單類型=ZSIMb)

34、 訂單行總狀態(tài)（IS）>=20c) 訂單方向=1-正向訂單d) 訂單行項(xiàng)目類別=14-合約機(jī)3) 滿足以下條件保存待分發(fā)互聯(lián)訂單信息，通過接口（OMS-SAP-036）a) 訂單行SAP訂單類型為：ZSIA、或者ZSIBb) 訂單行總狀態(tài)（IS）>=20c) 訂單方向=1-正向訂單d) 訂單行項(xiàng)目類別=14-合約機(jī)4) 滿足以下條件保存待分發(fā)超市訂單信息，通過接口（OMS-SAP-040）a) 訂單行SAP訂單類型：CSLY、或者YDDSb) 訂單行先銷后采標(biāo)識(shí)為：8c) 訂單行總狀態(tài)（IS）>=20d) 訂單方向=1-正向訂單5) 滿足以下條件保存待分發(fā)SWL、聯(lián)營廠送訂單

35、信息，通過接口（OMS-SAP-041）a) 訂單行先銷后采標(biāo)識(shí)為：7、或者9b) 訂單行總狀態(tài)（IS）>=20c) 訂單方向=1-正向訂單6) 滿足以下條件保存待分發(fā)IDOC訂單（3C類）信息，通過接口（OMS-SAP-038）a) 訂單行SAP訂單類型=IDOCb) 訂單行總狀態(tài)（IS）>=20c) 訂單方向=1-正向訂單7) 滿足以下條件保存待分發(fā)賬期支付訂單信息，通過接口（OMS-SAP-053）a) 訂單渠道為：10、20、30、40、或者50b) 訂單行支付狀態(tài)（IP）=30c) 訂單行支付明細(xì)中包含9102支付方式8) 滿足以下條件保存待分發(fā)合約機(jī)手機(jī)行結(jié)算信息，通過

36、接口（OMS-SAP-032）a) 訂單行項(xiàng)目類別為：10-實(shí)體b) 訂單行存在合約關(guān)聯(lián)關(guān)系c) 訂單行關(guān)聯(lián)的合約行的SAP訂單類型為：IDOC或者ZSIMd) 訂單行總狀態(tài)（IS）>=209) 滿足以下條件保存待分發(fā)合約機(jī)合約行結(jié)算信息，通過接口（OMS-SAP-033）a) 訂單行項(xiàng)目類別為：14-合約機(jī)b) 訂單行SAP訂單類型=IDOC、或者ZSIMc) 訂單行總狀態(tài)（IS）>=2010) 滿足以下條件保存待分發(fā)C店訂單信息，通過接口（OMS-SAP-037）a) 訂單行總狀態(tài)（IS）=20b) 訂單行先銷后采標(biāo)識(shí)為：5c) 訂單渠道為：50d) 訂單行支付明細(xì)中包含支付方

37、式5002、或者690411) 滿足以下條件保存待分發(fā)商轉(zhuǎn)贈(zèng)訂單信息，通過接口（OMS-SAP-042）a) 訂單行項(xiàng)目類別為：10-實(shí)體、或者12-贈(zèng)品b) 訂單行為商轉(zhuǎn)贈(zèng)訂單c) 訂單行總狀態(tài)（IS）=206. 滿足以下條件保存待返積分信息到CMF，通過接口（OMS-CMF-006/OMS-CMF-007）1) IS>=20已完成；2) IP=30已支付；3) 接單模式<>3-一步式不待處理4) 來源系統(tǒng)不為BSS、SAP、TMALL、SDIPA5) 行項(xiàng)目類別為：10、11、12、14；6) 業(yè)務(wù)類型不為：配置數(shù)據(jù)7. 滿足以下條件保存待返券信息到SPES，通過接口（O

38、MS-SPES-0?）8. 滿足以下條件保存待分發(fā)已支付訂單信息到IPS，通過接口（OMS-IPS-001）1) 訂單行先銷后采標(biāo)識(shí)為：空、0、1、2、3、4、6、7、或者92) 訂單行總狀態(tài)>=20-已處理3) 訂單行類別為：10-實(shí)體、11-延保、12-贈(zèng)品、或者14-合約4) 訂單行發(fā)票類型為：01、02（是否需要打印發(fā)票<>“N”）、03、或者045) 訂單渠道為：40（訂單來源為TMALL）、50、或者609. 保存待分發(fā)訂單信息到BUDS1) 滿足以下條件保存待分發(fā)云商卡訂單信息，通過接口（OMS-BUDS-055）a) 訂單行項(xiàng)目類別為：16-云商卡b) 訂單行

39、總狀態(tài)（IS）=202) 滿足以下條件保存待分發(fā)醫(yī)保卡訂單信息，通過接口（OMS-BUDS-055）a) 訂單行為醫(yī)?？ㄓ唵蝏) 訂單行總狀態(tài)（IS）>=203.2.1.3 頁面原型N/A，系統(tǒng)后臺(tái)功能無頁面3.2.1.4 數(shù)據(jù)說明N/A，系統(tǒng)后臺(tái)功能無頁面3.2.1.5 功能需求描述針對(duì)以下業(yè)務(wù)場景，前端系統(tǒng)提交訂單至OMS，OMS進(jìn)行訂單提交的合法校驗(yàn)，訂單提交的資源處理以與訂單保存，并根據(jù)對(duì)應(yīng)的場景，判斷是否調(diào)用后續(xù)處理。* 接單模式：1-一步式需處理資源；2-兩步式需處理資源；3-一步式無需處理資源3.2.1.6 接口說明該功能處理過程中會(huì)調(diào)用以下接口：接口編號(hào)接口名稱目標(biāo)系統(tǒng)場景OMS-OMSD-001訂單信息同步OMSDOMSD訂單處理成功后，同步訂單信息到OMSDOMS-OMSQ-001訂單信息同步OMSQOMSQ訂單提交或者處理成功后，同步訂單信息到OMSQ3.2.1.7 其它說明表-訂單行總狀態(tài)（IS）設(shè)置邏輯接單模式行項(xiàng)目類別狀態(tài)值