技术设计_SSRC_询报价_报价方_供应商报价V1 0 2

1、询报价_报价方_供应商报价技术详细设计文档作者:沈俊创建日期:2018-12-26更新日期:当前版本：1.0文档控制更改记录日期作者版本修改记录Hand2018-12-25沈俊V1.0新建版本审阅姓名职位目录文档控制2更改记录2审阅2目录3供应商报价4简单功能流程说明4供应商报价入口页面4供应商参与报价页面5供应商报价界面7依赖关系9配置信息9数据库设计9ssrc_rfx_quotation_header9ssrc_rfx_quotation_line10ssrc_rfx_quotation_record10E-R图10应用设计10原型图设计10API清单11应用服务方法11类图11注意事项1

2、2开发参考12规范12未决问题13未决问题13供应商报价简单功能流程说明供应商用户使用该功能：1、 查询所有收到的询价单；2、 在该功能下进行参与、放弃、报价等操作；3、 在报价（非密封）过程中，针对采购方的还价多次报价；供应商报价入口页面1. 查询条件a) RFx单号文本，支持模糊查询，ssrc_rfx_header.rfx_numb) 询价单标题文本，支持模糊查询，ssrc_rfx_header.rfx_titlec) 客户LOV，使用值集视图配置 SPFM.USER_AUTH.CUSTOMERd) 询价方式下拉框，ssrc_rfx_header.source_methode) 竞价方向下

3、拉框，ssrc_rfx_header.auction_direction2. 点击查询按钮，调用供应商报价入口界面查询APIa) 筛选状态为报价中b) 报价截止时间晚于当前系统时间c) 判断询价单头询价方式字段i. 询价方式为邀请时，关联询价单头、物料行、供应商行和物料-供应商分配行，当ssrc_rfx_item_sup_assign = 1且ssrc_rfx_line_supplier.supplier_tenant_id = 当前租户ID时，供应商能查询到该询价单；ii. 询价方式为公开至合作伙伴时，判断当前租户与询价单上的采购方租户是否有建立合作伙伴关系（供应商模块的API调用），如果有

4、合作伙伴关系，那供应商能查到该询价单；iii. 询价方式为全平台公开时，那该询价单能查到；3. 查询结果字段取值逻辑如下：a) 操作超链接或者只读，点击报价链接进入供应商报价界面 操作字段需要结合报价开始时间，且供应商是否已参与报价（ssrc_rfx_line_supplier.feedback_status=PARTICIPATED）来判断:状态是否开始是否参与操作报价中YY报价N未参与N未开始b) 报价开始时间、报价截止时间只读，显示格式YYYY-MM-DD HH24:MI:SSc) 附件标识图标，若询价单的附件列表页签上传了附件则显示图标；若没上传附件则不显示图标；d) RFx单号链接，

5、点击进入询价单查看参与页面；e) 客户只读，显示询价单上采购方的公司名称f) 其他字段对应请参考功能设计和表设计文档。供应商参与报价页面1. 进入页面，调用供应商询价单头查询API、供应商询价单物料行查询API查询该询价单头信息和物料行信息；2. 具体字段信息和采购方查看询价单明细页面一致，也可参考功能设计原型图和表设计Excel文档；3. 参与按钮点击后调用询价单参与API，具体逻辑如下：a) 校验i. 校验前台传入的轮次和版本的信息是否和询价单头上的轮次和版本一致，如果不一致就报错；ii. 校验询价单的状态，报价中和暂停状态的报价单才能参与iii. 校验当前时间是否在询价单报价截止时间之前

6、，如果报价已截止，不允许参与；iv. 校验是否已参与/放弃（ssrc_rfx_line_supplier.feedback_status），如果已参与/放弃，不允许再次参与；b) 逻辑i. 更新询价单供应商行反馈状态为参与（ssrc_rfx_line_supplier.feedback_status=PARTICIPATED）且已读标志（ssrc_rfx_line_supplier.read_flag=1）ii. 如果询价方式为公开至合作伙伴或全平台公开，此时询价单供应商行中没有数据，需要往表中新增一条数据；且针对当前参与的供应商，与询价单中所有物料行，生成对应的分配行信息（ssrc_rfx_

7、item_sup_assign）；iii. 创建对应询价单的报价头数据quotation_header_id序列tenant_id当前供应商的租户IDrfx_header_id对应询价单头IDquotation_num报价单编码规则生成round_number取询价单头轮次字段quotation_status默认NEWsupplier_tenant_id当前供应商的租户IDsupplier_company_id当前供应商的公司IDsupplier_company_name当前供应商的公司名称tax_included_flag来源询价单头对应字段tax_idtax_ratecurrency_co

8、deexchange_rate_idexchange_rate_typeexchange_rate_dateexchange_rate_periodquotation_remark默认空attachment_uuid默认空iv. 创建对应询价单的报价行数据需要判断询价单物料-供应商行的是否邀请标志，已邀请的行才创建对应的报价行；如果询价方式为公开至合作伙伴或全平台公开，默认所有询价单行都生成报价行；quotation_line_id序列quotation_header_id报价头IDtenant_id当前租户IDquotation_line_status默认NEWrfx_line_item_i

9、d对应询价单物料行IDround_number询价单对应轮次tax_included_flag询价单物料行对应字段tax_idtax_ratequoted_date当前时间price_batch_quantity默认空min_purchase_quantitymin_package_quantityfreight_included_flag默认0freight_amount默认空bargain_flag默认0bargain_date默认空promised_datedelivery_cyclequotation_expiry_date_fromquotation_expiry_date_tova

10、lid_quoted_byvalid_quotation_quantityvalid_quotation_pricevalid_quotation_remarkvalid_bargain_byvalid_bargain_quantityvalid_bargain_pricevalid_bargain_remarkcurrent_promised_datecurrent_delivery_cyclecurrent_expiry_date_fromcurrent_expiry_date_tocurrent_quoted_bycurrent_quotation_quantitycurrent_quo

11、tation_pricecurrent_quotation_remarkcurrent_bargain_bycurrent_bargain_quantitycurrent_bargain_pricecurrent_bargain_remarknet_pricetax_pricenet_amounttax_amounttotal_amountsuggested_flag默认0suggested_by默认空suggested_remarkallotted_quantityattachment_uuidv.4. 放弃按钮点击后调用询价单放弃API，具体逻辑如下：a) 校验i. 校验前台传入的轮次和版

12、本的信息是否和询价单头上的轮次和版本一致，如果不一致就报错；ii. 校验询价单的状态，报价中和暂停状态的报价单才能放弃iii. 校验当前时间是否在询价单报价截止时间之前，如果报价已截止，不允许放弃；iv. 校验是否已参与/放弃（ssrc_rfx_line_supplier.feedback_status），如果已参与/放弃，不允许再次放弃；b) 逻辑i. 更新询价单供应商行反馈状态为放弃（ssrc_rfx_line_supplier.feedback_status= ABANDONED）且已读标志（ssrc_rfx_line_supplier.read_flag=1）ii. 如果询价方式为公开

13、至合作伙伴或全平台公开，此时询价单供应商行中没有数据，需要往表中新增一条数据；iii. 针对当前参与的供应商，与询价单中所有物料行，生成对应的分配行信息（ssrc_rfx_item_sup_assign）；5. 参与或放弃后当前页面关闭，回到供应商报价入口页面，且页面刷新。供应商报价界面1. 字段说明a) 报价行数文本，只读分子：当前报价单行状态为已报价的行数（ssrc_rfx_quotation_header.quotation_status= QUOTED）分母：当前报价单头对应所有的报价单行数b) 报价总金额文本，只读，计算逻辑为当前报价单对应有效报价行（ssrc_rfx_quotati

14、on_line.quotation_status= QUOTED）的总金额（SUM(current_quotation_price * current_quotation_quantity)）2. 其他界面字段属性和逻辑参考功能设计原型图和表设计Excel；3. 我要报价Tab页a) 进入页面时，该Tab页的数据自动查询，上下两个表格的数据是一对多的关系：上面的表格查询的是当前供应商针对询价单每一行物料的最新报价信息；下面的表格展示的是对于询价单某一行物料，该供应商的所有历史报价和采购方的还价记录。具体取值逻辑如下：i. 上面表格调用供应商报价-我要报价查询API，关联报价单头、行表和询价单物

15、料行表、询价单物料-供应商分配关系表，查询出当前供应商能报价所有物料行信息以及供应商的报价信息，如果当前轮次供应商还没有报价，则显示上一轮的报价信息；ii. 下面表格点击上面表格中某一行物料，调用供应商报价-所有报价明细查询API，根据查询数据中的quotation_line_id，到所有报价记录表（ssrc_rfx_quotation_record）中查询该供应商本轮针对这一行的所有报价记录和采购方的还价记录。b) 字段说明i. 行号、物品编码、物品描述、需求数量、单位、需求日期、需要样品只读，来源询价单物料行表对应字段ii. 报价状态只读，来源报价单头表ssrc_rfx_quotation

16、_line. quotation_line_statusiii. 单价数字，可编辑，10位精度，ssrc_rfx_quotation_line.current_quotation_priceiv. 有效报价只读，10位精度，ssrc_rfx_quotation_line.valid_quotation_pricev. 含税checkbox，只读，ssrc_rfx_quotation_line.tax_included_flagvi. 税率lov，ssrc_rfx_quotation_line.tax_included_flag.tax_rate。默认只读，若询价单引用的寻源模板中允许供应商修改

17、税率勾选（ssrc_source_template.tax_change_flag=1），则可编辑，vii. 报价数量数字，可编辑，10位精度，ssrc_rfx_quotation_line.current_quotation_quantityviii. 放弃标识checkbox，可编辑，ssrc_rfx_quotation_line.abandoned_flag，勾选后当前行所有编辑的数据都为只读，必填项改为非必填；ix. 报价有效期从、至日期，ssrc_rfx_quotation_line.quotation_expiry_date_from，ssrc_rfx_quotation_line

18、.quotation_expiry_date_to；若询价单引用的寻源模板中报价有效期（ssrc_source_template.valid_date_input_type）为REQUIRED，则可编辑且必填；若为NOT_REQUIRED则可编辑但非必填；若为READONLY，则不可编辑。x. 承诺交货日期日期，可编辑，ssrc_rfx_quotation_mised_datexi. 供货周期文本，可编辑，ssrc_rfx_quotation_line.delivery_cyclexii. 报价说明文本，可编辑，ssrc_rfx_quotation_line.current_q

19、uotation_remarkxiii. 最小采购量数字，可编辑，ssrc_rfx_quotation_line.min_purchase_quantityxiv. 最小包装量数字，可编辑，ssrc_rfx_quotation_line.min_package_quantityxv. 是否含运费checkbox，只读，ssrc_rfx_line_item.freight_included_flagxvi. 运费文本，当是否含运费勾选时可编辑，ssrc_rfx_quotation_line.freight_amountxvii. 供应商附件超链接，点击后能上传供应商报价的附件，对应ssrc_rf

20、x_quotation_line.attachment_uuid4. 其他信息Tab页a) 查询逻辑和我要报价Tab页第一个表格的逻辑一致，调用供应商报价-我要报价查询API；b) 字段说明i. 收回超链接，点击后调用供应商报价-行收回API，收回该物料行最近一次提交的报价；1. 校验询价单是否在有效报价期内；2. 校验询价单是否为密封报价，非密封报价的不可以收回；3. 校验报价单头状态是否为QUOTED/已报价；4. 校验报价单行状态是否为SUBMITTED/已报价；5. 更新报价单行状态为TAKEN_BACK/收回，清空以下字段valid_promised_date = nullvalid

21、_delivery_cycle = nullvalid_expiry_date_from = nullvalid_expiry_date_to = nullvalid_quoted_by = nullvalid_quotation_quantity = nullvalid_quotation_price = nullvalid_quotation_remark = nullii. 有效还价、还价人、有效还价理由只读，ssrc_rfx_quotation_line.current_bargain_price、ssrc_rfx_quotation_line.current_bargain_by（根

22、据user_id关联用户表hiam_user_info查询）、ssrc_rfx_quotation_line.current_bargain_remarkiii. 物品分类、物品说明、报价幅度只读，来源询价单物料行表ssrc_rfx_line_item. item_category_id、ssrc_rfx_line_item.item_remark、ssrc_rfx_line_item. quotation_rangeiv. 询价单附件超链接，点击后可下载对应询价单物料行附件5. 附加列表Tab页可查看询价单头附件，区分商务卷和技术卷6. 保存按钮a) 点击保存按钮，调用供应商报价-保存API

23、，保存我要报价Tab页中用户填写的数据；b) 校验询价单当前时间是否在报价开始和截止时间（可能为空）范围内；c) 报价单行放弃标识如果勾选，则该行不可编辑，保存时报价行状态不改变；d) 校验单据状态i. 实际展示状态为报价中的询价单才能报价，如果不为报价中，就报错提示；ii. 判断报价单行状态（ssrc_rfx_quotation_line.quotation_line_status）和寻源模板中允许供应商连续报价（ssrc_source_template.continuous_quotation_flag）标识1. 如果continuous_quotation_flag=1，行状态为放弃（A

24、BANDONED），不允许报价；2. 如果continuous_quotation_flag=0，行状态为放弃（ABANDONED）和已报价（SUBMITTED），不允许报价；7. 提交按钮a) 点击提交按钮，校验是否勾选行数据，如果没有勾选数据则提示；如果勾选了，则校验勾选数据的必填项，通过就调用供应商报价-提交API，先保存数据再做发布操作；b) 如果报价单行放弃标识为1，则将报价行状态改为放弃，不进行后续操作；c) 如果报价行放弃标识为0，且报价行状态为放弃，则将报价行状态改为已报价；d) 校验报价价格i. 判断竞价方向（ssrc_rfx_header.auction_direction

25、）和报价幅度（ssrc_rfx_line_item.quotation_range）1. 判断询价单是否为密封报价（ssrc_rfx_header.sealed_quotation_flag），如果为密封报价，则跳过后续校验；2. 先获取前一次报价a) 如果竞价方向不跨轮次校验（ssrc_source_template.direct_cross_round_flag=0），则前一次报价直接取ssrc_rfx_quotation_line.valid_quotation_price；b) 如果竞价方向跨轮次校验（ssrc_source_template.direct_cross_round_fl

26、ag=1），且当前为发布多轮后的第一次报价（ssrc_rfx_line_item.round_flag=1且ssrc_rfx_quotation_line.valid_quotation_price为空），则取当前供应商针对该询价单的上一轮有效报价（询价单轮次-1，找到该轮次的报价单，获取对应报价单行的有效报价ssrc_rfx_quotation_line.valid_quotation_price）。3. 当竞价方向为正向（FORWARD），当前报价不能小于前一次报价；且如果报价幅度不为空，当前报价 = 前一次报价 + 报价幅度；4. 当竞价方向为反向（REVERSE），当前报价不能大于前一

27、次报价；且如果报价幅度不为空，当前报价 = 报价幅度。ii. 校验限价（ssrc_rfx_item_sup_assign.max_limit_price和ssrc_rfx_item_sup_assign.min_limit_price）如果限价不为空，则当前报价不能高于最高限价，且不能小于最低限价；e) 更新报价单头的状态更改为QUOTED/已报价；f) 更新有效报价信息，将当前报价的信息更新到有效报价信息字段上valid_promised_date = current_promised_datevalid_delivery_cycle = current_delivery_cyclevali

28、d_expiry_date_from = current_expiry_date_fromvalid_expiry_date_to = current_expiry_date_tovalid_quoted_by = current_quoted_byvalid_quotation_quantity = current_quotation_quantityvalid_quotation_price = current_quotation_pricevalid_quotation_remark = current_quotation_remark报价时间（quoted_date）更新为当前系统时间

29、报价行状态（quotation_line_status）更新为已报价（SUBMITTED）current_quoted_by = nullcurrent_quotation_quantity = nullcurrent_quotation_remark = nullg) 计算报价金额相关字段不含税单价(net_price)：若报价含税，通过税率和有效报价计算；若不含税，则取有效报价含税单价(tax_price)：若报价含税，则取有效报价；若不含税，通过税率和有效报价计算不含税金额(net_amount)：不含税单价 * 有效报价数量税额(tax_amount)：含税单价 * 有效报价数量 *

30、税率含税金额(total_amount)：含税单价 * 有效报价数量h) 记录当前有效报价信息到所有报价记录表中，具体字段对应请参考表结构设计文档8. 上传附件按钮点击按钮可以上传报价单头附件依赖关系1、 说明该功能依赖的特别组件： 2、 说明该功能调用的其他服务的API：配置信息1、 值集配置：值集code说明SSRC.RFX_QUOTATION_STATUS报价单状态(NEW/新建|QUOTED/已报价|FINISHED/结束)SSRC.RFX_QUOTATION_LINE_STATUS报价单行状态(NEW/新建|SUBMITTED/已报价|BARGAINED/已还价|TAKEN_BACK/收回|ABANDONED/放弃)2、 编码规则配置：层级编码规则code说明平台级SSRC.RFX_QUOTATION_NUM报价单号3、 描述配置：配置key配置code语言描述数据库设计表设计EXCEL路径：35 表设计产品平台&SRM_SSRC寻源管理_表设计1.0.xlsssrc_rfx_quotation_header 表功能简介：