技术设计询报价询价方大厅v

1、询报价_询价方_询价大厅技术详细设计文档作者: 创建日期: 更新日期:当前版本：2018-12-251.0文档更改审阅2职位2018-12-25HandV1.0新建版本日期作者版本修改目录文档2更改2审阅2目录3询价大厅4简单功能流程说明4询价大厅页面4报价响应页面6询价单明细页面7询价单新建界面7询价单维护界面7开标人维护页面9筛选供应商页面10依赖配置. 12. 12数据库设计13ssrc_rfx_header13ssrc_rfx_line_item13ssrc_rfx_line_r13ssrc_rfx_item_sup_assign14ssrc_rfx_action14ssrc_sour

2、ce_open_password14E-R 图14应用设计14原型图设计14API. 14应用服务. 15类图16注意事项16开发参考16规范16未决问题17未决问题173询价大厅简单功能流程说明采购方用户使用该功能：1、部分状态下的询价单；2、 在该功能下进行新建、维护询价单；3、 在供应商报价（非密封）过程中，进行还比价；4、 等报价截至后，进行开标、核价操作。询价大厅页面1. 点击“手工创建询价”按钮，进入询价单新建页面；2. 条件a) RFx 单号文本，支持模糊b) 询价单标题文本，支持模糊，ssrc_rfx_header.rfx_num，ssrc_rfx_header.rfx_tit

3、lec) 询价方式下拉框，参考字段 ssrc_rfx_header.source_methodd) 状态下拉框，参考字段 ssrc_rfx_header.rfx_statuse) 采购组织lov，参考值集视图配置 SPFM.USER_AUTH.PURORGf) 竞价方向下拉框，参考字段 ssrc_rfx_header.auction_directiong) 币种下拉框，参考字段 ssrc_rfx_header.currency_codeh) 密封报价下拉框，参考字段 ssrc_rfx_header.sealed_quotation_flag3. 点击“”按钮，调用询价大厅进行中的询价单API，

4、“状态 ssrc_rfx_header.rfx_status”为NEW/ 新建、RELEASE_APPROVING/ 发布审批中、RELEASE_REJECTED/ 发布审批拒绝、NOT_START/ 未开始、IN_PREQUAL/资格预审中、PREQUAL_CUTOFF/资格预审截止、IN_QUOTATION/报价中、OPEN_BID_PENDING/待开标、PRETRIAL_PENDING/ 待初审、SCORING/ 评分中、CHECK_PENDING/ 待核价、CHECK_APPROVING/ 核价审批中、CHECK_REJECTED/核价审批拒绝、ROUNDED/再次询价、IN_POS

5、TQUAL/资格后审中、POSTQUAL_CUTOFF/资格后审截止的询价单；结果字段取值逻辑见下方：a) 状态“状态”字段中部分状态需要结合多个字段来，具体如下，未具体说明的按原状态展示；45b) 操作链接，点击 “维护”超链接，进入询价单维护页面，显示出对应询价单的数据；点击“还比价”超链接，进入还比价页面，显示询价单的和截至到当前所有供应商的报价数据，可进行还比价操作；点击“核价”超链接，进入核价页面，显示询价单的和所有供应商的报价数据，可进行核价操作。“操作”字段和“状态”字段的对应请参考功能设计页面说明；状态为“报价中”时，如果询价单是密封报价（sealed_quotation_fl

6、ag=1），“操作”字段为“”； 如果不是密封报价（sealed_quotation_flag=0）,“操作”字段为“还比价”的超链接；当操作为“待开标”时，如果当前用户不是开标人，点击“开标”超链接弹出提示框“请等待开标人开标”；如果当前用户是开标人，点击“开标”超链接，进入“开标页面”的窗口。c) 附件标识图标，若单据的附件列表页签上传了附件则显示图标；若没上传附件则不显示图标；d) RFx 单号链接，点击进入询价单明细查看页面；e) 报价响应链接，点击进入报价相应明细页面。计算逻辑：对应询价单的供应商行表 ssrc_rfx_line_r 中_flag=1、feedback_status

7、IN (PARTICIPATED, ABANDON)的数量与供应商总数量的比例；f) 其他字段对应请参考功能设计和表设计文档。报价响应页面1、 进入页面，调用询价单报价响应API，2、 字段说明如下，所有字段都为只读a) 供应商编码该询价单下的所有供应商行的反馈状态只读，用 ssrc_rfx_line_ hpfm_pany_numb) 供应商名称只读，字段 ssrc_rfx_line_c) 是否已读只读，字段 ssrc_rfx_line_d) 是否参与只读，字段 ssrc_rfx_line_e) 报价行数r.r_company_id 关联 hpfm_pany_id 获取r.r_company_

8、namer._flagr.feedback_status分母：该供应商所有可报价的行数量，从询价单物料-供应商分配中获取；分子：该供应商已经报价的行数量，关联询价单物料-供应商分配表（ssrc_rfx_item_sup_assign）表（ssrc_rfx_item_sup_assign）和报价单行表（ssrc_rfx_quotation_line），quotation_line_status IN (SUBMITTED, BARGAINED)f) 是否提交预审申请暂无g) 是否提交后审申请暂无h) 是否上传头附件用件通用 APIr_company_id 关联询价单该轮次下对应供应商的报价单头，

9、然后取该报价单头 UUID，调用附是否上传附件。6SELECT fh.attachment_uuidFROM ssrc_rfx_headerh, ssrc_rfx_line_rl, ssrc_rfx_quotation_header fhWHE.rfx_header_id = l.rfx_header_id AND l.rfx_header_id = fh.rfx_header_idAND l.r_company_id = fh.r_company_id AND h.round_number = fh.round_number询价单明细页面1. 进入页面时调用采购方询价单头API、采购方询价单

10、物料行API、采购方询价单供应商行API、采购方询价单附件API对应询价单的2. 具体字段请参考功能设计原型图和表设计 Excel 文档。开标页面1. 点击询价大厅页面开标超链接a) 如果当前用户在开标人列表中且此开标人启用了开标（），则进入此页面，开标人可在当前页面上输入开标，点击提交后，调用开标 API，进行开标操作；i.校验当前用户是否在开标人列表中，若不在，则不开标；ii.如果开标人启用开标（password_flag=1），则校验输入的开标是否和表中的一致，若不一致，则不开标；iii.如果开标人已经开标（opened_flag = 1），则提示不开标；iv.更新对应开标人的 open

11、ed_flag = 1；v.校验当前是否为最后一个开标人，如果是最后一个开标人，则继续如下取寻源模板中的配置询价初审，如果启用初审，则修改询价单状态为待初审；如果不启用初审，则修改询价单状态为待核价；b) 如果当前用户在开标人列表中但是此开标人没有启用开标用开标 API；，则弹窗提示是否确认开标，确认后直接调c) 如果当前用户不在开标人列表中，则弹窗提示请等待开标人开标！。询价单新建界面1. 字段说明a) 寻源模板lov，调用寻源模板获取最新发布模板的 API/v1/organizationId/source-template/latest；b) 采购组织名称lov，参考值集视图配置 SPFM

12、.USER_AUTH.PURORGc) 其他字段请参考功能设计原型图和表设计文档。2. 点击“创建”按钮，前台校验通过以后，调用询价单保存 API，向 ssrc_rfx_header 表中新增数据，同时写入操作表(新建)；保存跳转“询价单维护界面”。询价单维护界面1. 字段说明a) 寻源模板lov，调用寻源模板获取最新发布模板的 API/v1/organizationId/source-template/latest；b) 采购组织名称lov，参考值集视图配置 SPFM.USER_AUTH.PURORGc) 公司lov，参考值集视图配置 SPFM.USER_AUTHORITY_COMPANYd

13、) 报价运行时间可编辑，前台展示 x 天 x 小时 x 分钟，后端存只用一个字段，默认要转换成分钟2. 其他界面字段属性和逻辑参考功能设计原型图和表设计 Excel；3. 物品明细 Tab 页a) 点击“保存”按钮，调用“询价单物品行保存 API”i. 保存所有物品行的数据；为分钟，前端调用 API 的时候需7ii. 校验物品行不能重复iii. 为新增的物品行和所有供应商行进行全排列，生成对应的“询价单物料-供应商分配行（ssrc_rfx_item_sup_assign）”数据b)物品行数据，点击“删除”按钮，调用“询价单物品行删除 API”i. 删除“询价单物料-供应商分配行（ssrc_rf

14、x_item_sup_assign）”中对应物品行的数据；ii. 删除物品行表中的的数据；c)物品行数据，点击“批量筛选供应商”按钮，打开“筛选供应商页面”，根据的多个rfx_line_item_id出所有对应的“物料-供应商分配行”（ssrc_rfx_item_sup_assign）d) 支持分页，如果没保存就切换分页，提示用户先保存；e) 字段说明i.筛选超链接，打开“筛选供应商页面”，出该行物料对应的“物料-供应商分配行”；ii.业务实体lov，参考值集视图配置 SPFM.USER_AUTH.OUiii.库存组织lov，参考值集视图配置 HPFM.INV_ORGiv.物品编码lov，参考

15、值集视图配置 SMDM.CUSTOMER_ITEMv.物品lov，参考值集视图配置 HIAM.USER_AUTH_ITEM_CATvi.lov，参考值集视图配置 SMDM.UOMvii.税率lov，参考值集视图配置 SMDM.TAXviii.附件上传超链接，点击可给对应的物料行上传附件；4. 供应商列表 Tab 页a) 如果“询价方式”是“合作伙伴公开”或“全平台公开”，此 Tab 页禁用；b) 点击“保存”按钮，调用“询价单供应商行保存 API”；i.保存所有供应商行的数据； ii.校验供应商不能重复iii.为新增的供应商行和所有物料行进行全排列，生成对应的“询价单物料-供应商分配行（ssr

16、c_rfx_item_sup_assign）”数据c)物品行数据，点击“删除”按钮，调用“询价单供应商行删除 API”；i.删除“询价单物料-供应商分配行（ssrc_rfx_item_sup_assign）”中对应物品行的数据； ii.删除物品行表中的的数据；d) 字段说明i. 供应商编码lov，可编辑ii.人lov，可编辑，默认值是供应商第一个人8iii.通过认证暂时还没有，界面保留字段，后端不处理iv.生命周期阶段暂时还没有，界面保留字段，后端不处理5. 附加上传 Tab 页上传询价单头附件，区分商务卷(ssrc_rfx_header.business_attachment_uuid)和技

17、术卷(ssrc_rfx_header. tech_attachment_uuid)6. “保存”按钮a) 点击保存按钮，校验界面字段必填项，校验通过后调用“询价单保存 API”，保存界面上所有头、物料行、供应商行的数据；b) 为新增的物料行和供应商行做全排列，生成对应的“询价单物料-供应商分配行（ssrc_rfx_item_sup_assign）”数据；c) 校验供应商行和物料行不能重复；d) 如果“询价方式”是“合作伙伴公开”或“全平台公开”，清除询价单的供应商行数据和询价单物料-供应商分配行（ssrc_rfx_item_sup_assign）数据；7. “发布”按钮a) 点击“发布”按钮，

18、调用“询价单发布 API”，先做保存逻辑，再提交；b) 状态校验，新建、再次询价和发布审批拒绝状态才能发布；c) 报价时间校验，报价开始时间不能晚于报价截止时间，报价开始和截止时间不能早于当前时间；d) 物料行至少要维护一行数据；e) 如果“询价方式”是“邀请”，取寻源模板中的供应商数量配置（ssrc_source_template.max_vendor_qu 验供应商的数量；ty、ssrc_source_template.max_vendor_quty），校f) 如果寻源模板中启用了开标人（ssrc_source_template.opener_flag=1），且定义的开标人启用了开标密码（

19、ssrc_source_open_password. password_flag），则将开标发送到开标人的邮箱（根据ssrc_source_open_password. open_user_id 获取对应用户表中的邮箱）；g)模板中的“发布审批 ssrc_source_template. release_approve_type”字段i.如果是“自审批”（默认方式），将询价单状态改为“报价中”，写入操作表（发布）；ii.如果是“工作流审批”和“外部系统审批”，暂不处理；开标人维护页面1. 字段说明a) 子账户lov ，可编辑，参考值集视图配置 HIAM.USER_AUTHORITY_USERb

20、)描述、邮箱、号只读，仅展示，选择子账户以后自动带出c) 启用开标可编辑2. 点击“加入当前用户”，表格中新增一条数据，用当前用户 ID3. 点击“保存”按钮，调用询价单定义开标人保存API，a) 校验子账户的唯一性；出对应的描述、邮箱和号；b)如果启用开标，生成开标94. 点击“删除”按钮，调用询价单定义开标人删除API；筛选供应商页面1. 字段来源于询价单物料-供应商分配行（ssrc_rfx_item_sup_assign）表，具体展示逻辑见功能设计原型图；2. 点击保存按钮，调用筛选供应商保存 API，将用户修改的“限价”和“是否邀请”字段保存还比价页面1. 头字段来源采购方询价单头AP

21、I，具体展示逻辑见功能设计原型图；2. 还比价API(校验密封)询价单当前轮次下（ssrc_rfx_line_item.current_round_number = ssrc_rfx_quotation_header.round_number = ssrc_rfx_quotation_line.round_number），所有供应商结束（ssrc_rfx_line_item.finished_flag=0）、且不是多轮（round_flag=0）的物料的报价明细3. 多个 Tab 页切换时，校验当前 T ab 的数据是否有保存，如果没保存，需要提示先保存；4. 物品明细 Tab 页a) 调用采

22、购方询价单物料行API， 计原型图；结束且不是多轮的物料行。具体字段取值见表设计和功能设b) 在每个物料行右侧点击下拉展开，调用还比价API，显示购方可以对每个供应商进行还价操作；当前物料行，所有供应商的报价；采5. 供应商 Tab 页a) 调用采购方询价单物料行API，当前询价单所有已邀请（邀请）和已参与（合作伙伴公开、全平台公开）的供应商。具体字段取值见表设计和功能设计原型图；b) 在每个供应商行右侧点击下拉展开，调用还比价API，显示采购方可以对每个物料进行还价操作；当前供应商，所有物料行的报价；6. 全部报价明细 Tab 页a)操作调用还比价API，显示出所有的供应商的所有物料行报价，

23、采购方可以进行还价操作；7. 保存按钮a) 点击按钮，保存当前 Tab 页上所有数据，同时刷新其他两个 Tab 页的数据；b) 校验询价单当前时间是否在报价开始和截止时间范围内；c) 校验报价行状态是否为已报价（SUBMITTED），如果不是，则不能还比价；d) 前台传过来的报价单头状态和当前报价单头实际状态是否一致， 若不一致，则报错提示；e) 校验询价单是否开启密封报价，如开启密封（ssrc_rfx_header.sealed_quotation_flag），则不可还价f) 更价行当前还价人（ssrc_rfx_quotation_line.current_bargain_by） 当前还价数

24、量（ssrc_rfx_quotation_line.current_bargain_quty）当前还价单价（ssrc_rfx_quotation_line.current_bargain_price） 当前还价理由（ssrc_rfx_quotation_line.current_bargain_remark）8. 提交按钮a) 点击后先做保存逻辑，再提交b) 更价行有效还价人 valid_bargain_by=current_bargain_by有效还价数量 valid_bargain_quty=current_bargain_quty有效还价单价 valid_bargain_price=cu

25、rrent_bargain_price有效还价理由 valid_bargain_remark=current_bargain_remark清空 current_bargain_by、current_bargain_quty、current_bargain_price、current_bargain_10remark已还价标识 bargain_flag=1还价时间 bargain_date=sysdate报价行状态quotation_line_status=BARGAINEDc)报价获取对应报价行 ID 的最新一次报价，更新 bargain_flag、bargain_date、bargain_b

26、y、bargain_quty、bargain_price、bargain_remark9. 一键还价所有按钮点击按钮后，获取当前询价单当前轮次下，所有状态为已提交的报价行，批量进行还价（执行保存和提交逻辑），还价理为价格偏高，需要降价；10. 操作按钮点击后弹出操作的公共页面。核价页面1. 头字段来源采购方询价单头API，具体展示逻辑见功能设计原型图；2. 核价API当前询价单（未结束的物料）的放弃的报价。3. 成本a) 总成本数字，可编辑，当 ssrc_rfx_header.total_cost 有值时，取表里面的值；如果表中字段为空，则取所有物料行上成本单价*需求数量的总和（SUM(ssr

27、c_rfx_line_item.cost_price *ssrc_rfx_line_item.rfx_quty)）。b)核价总金额数字，只读，询价单当前轮次所有报价行选用数量*有效报价的总和（SUM(ssrc_rfx_quotation_line.allotted_quty * ssrc_rfx_quotation_line.valid_quotation_price)）。c) 是否超成本、超成本金额、超成本百分比只读，根据总成本和核价总金额计算得出，如果总成本和核价总金额其中一个字段为空，则不计算这三个字段。4. 物品明细 Tab 页a)调用采购方询价单物料行API，结束的物料行。具体字段取

28、值见表设计和功能设计原型图；b) 在每个物料行右侧点击下拉展开，调用核价API，显示方可以对每个供应商进行核价操作；c) 字段说明i. 选择策略下拉框，当选择推荐供应商以后，下面表格中的明细数据才能编辑5. 供应商 Tab 页当前物料行，所有供应商的报价；采购a)调用采购方询价单供应商行API，当前询价单所有已邀请（邀请）和已参与（合作伙伴公开、全平台公开）的供应商。具体字段取值见表设计和功能设计原型图；b)在每个供应商行右侧点击下拉展开，调用核价API，显示购方可以对每个物料进行核价操作；6. 全部报价明细 Tab 页操作调用核价API，显示出所有的供应商的所有物料行报价7. 保存按钮当前供

29、应商，所有物料行的报价；采，采购方可以进行还价操作；点击按钮，调用核价保存 API，将物料行上选择的选择策略，以及当前物料行下的明细数据，用户选用时填写的分配数量和选用理由保存；需要做一系列校验：11a)如果选择策略是推荐供应商，则选用的供应商数量不能为零，且分配数量不能为零或空； b)每一行物料下的明细数据行的分配数量总和不能大于物料行上的需求数量；8. 提交按钮点击按钮，调用核价提交 API，先执行保存逻辑再进行提交，提交一个物料（未结束）行进行校验a)校验询价单状态，状态是IN_QUOTATION/报价中、CHECK_PENDING/待核价、CHECK_REJECTED/核价审批拒绝才能

30、提交；b) 校验选择策略i. 如果是推荐供应商，校验每一个物料行是否已经选择供应商；ii.如果为空，则报错提示用户，不提交；iii.如果是采购申请和不采购申请，先不做处理，后续会对接采购申请模块；c) 将询价单状态修改为核价审批中/CHECK_APPROVING；d) 写入操作表，操作类型为核价审批中/CHECK_APPROVING。9. 再次询价按钮点击按钮，弹出选择物料和供应商的页面， 面以后点击提交，调用再次询价 API，然后跳转到询价单维护页a)b) 修改询价单头表状态为ROUNDED/再次询价、版本号+1、轮次+1；c) 修改询价单物料行当前轮次（ssrc_rfx_line_item

31、.current_round_number）为询价单头的新版本，修改round_flag=1；d) 修改询价单供应商行数据：feedback_status=NEW、feedback_remark=null、abandon_remark=null；_flag=0、e)操作（ROUNDED/再次询价）。10. 操作按钮点击后弹出操作的公共页面。依赖1、 说明该功能依赖的特别组件：2、 说明该功能调用的其他服务的 API：配置1、 值集配置：12值集 code说明SSRC.QUOTATION_ORDER_TYPE报价次序 (SEQUENCE/序列|STAGGER/交错|PARALLEL/并行)SSR

32、C.RFX_SUGGESTED_OPERATION询价单建议操作(ROUND_AGAIN/再次询价|CANCEL/取消)SSRC.RFX_STATUS询价单状态(NEW/新建|RELEASE_APPROVING/发布审批中|RELEASE_REJECTED/发布审批拒绝|NOT_START/未开始|IN_PREQUAL/资格预审中|PREQUAL_CUTOFF/资格预审截止|IN_QUOTATION/报价中|OPEN_BID_PENDING/待开标|PRETRIAL_PENDING/待初审|SCORING/评分中|CHECK_PENDING/待核价|CHECK_APPROVING/核价审批中|

33、CHECK_REJECTED/核价审批拒绝|FINISHED/完成|PAUSED/暂停|D/2、 编码规则配置：3、 描述配置：数据库设计表设计 EXCEL 路径：35 表设计平台&SRM_SSRC 寻源管理_表设计 1.0.xlsssrc_rfx_header表功能简介：询价单头表ssrc_rfx_line_item表功能简介：询价单物料行ssrc_rfx_line_r表功能简介：询价单供应商行13配置 key配置 code语言描述层级编码规则 code说明平台级SSRC.RFX_NUM询价单号关闭|ROUNDED/再次询价|IN_POSTQUAL/资格后审中|POSTQUAL_CU

34、TOFF/资格后审截止)SSRC.RFX_FEEDBACK_STATUS反馈状态 (PARTICIPATED/参与|ABANDONED/不参与|NEW/未反馈)SSRC.RFX_ SELECTION_STRATEGY选择策略（RECOMMENDATION/推荐供应商| RELEASE/采购申请| CANCEL/不采购申请）SSRC.RFX_OPERATION询价单操作（新建/CREATE | 发布/ISSUE | 审批拒绝/REJECT | 审批通过/APPROVE | 暂停/PAUSE | 启用/PAUSE_START | 再次询价/ROUND | 关闭/| 时间调整/ADJUST_TIME

35、 | 附件变更/ADJUST_ATTACHMENT | 增加供应商/ADD_R | 提交/SUBMIT | 完成/FINISH）SSRC.RFX_PROGRESS_STAGE询价单流程阶段(发布准备/RELEASE_PREPARE | 资格预审/IN_PREQUAL |报价中/IN_QUOTATION | 开标/OPEN_BID_PENDING | 初审/PRETRIAL_PENDING | 资格后审/IN_POSTQUAL |评分/SCORING | 核价/CHECK_PENDING | 完成/FINISHED)ssrc_rfx_item_sup_assign表功能简介：询价单物料-供应商分

36、配表ssrc_rfx_action表功能简介：询价单操作表ssrc_source_open_password表功能简介：寻源开标人和开标E-R 图应用设计原型图设计功能设计路径：30功能设计SSRC 寻源管理询报价模块 PRD 文档 V1.02.rpAPI（除了特殊说明，所有默认分页）14名称Api公共&登录请求类型描述询价大厅进行中的询价单API/v1/organizationId/rfx/listGET采购方询价单头查询API/v1/organizationId/rfx/rfxHeaderId/head erGET明细界面，采购方询价单头采购方询价单物料行API/v1/organi

37、zationId/rfx/rfxHeaderId/item sGET明细界面，采购方调用采购方询价单供应商行API/v1/organizationId/rfx/rfxHeaderId/supp liersGET明细界面，采购方调用询价单物品-供应商分配API/v1/organizationId/rfx/rfxLineItemId/it em-sup-assignGET不分页询价单报价响应查询API/v1/organizationId/rfx/rfxHeaderId/quot ation-feedbackGET不分页询价单头新建 API/v1/organizationId/rfxPOST创建询价单保存