# [采购申请管理] > 采购申请单的查询、筛选、批量物料维护、Excel 导入导出及金蝶采购订单/收料追溯模块。 ## 基本信息 | 项目 | 内容 | |------|------| | 类型 | 接口 + 前端页面(系统二开) | | 版本 | v1.1.0 | | 负责人 | Damon | | SVN路径 | svn://地址/路径 | | .NET版本 | .NET Framework 4.7.2 | | 对应文件 | Controllers/ProcurementController.cs、procurement.html、procurement_detail.html、multi_detail.html | ## 功能说明 对 OA 采购申请单(formtable_main_23 / formtable_main_23_dt1)进行管理,支持多维筛选、批量物料维护、Excel 模板导入导出,以及金蝶采购订单(PUR_PurchaseOrder)/收料通知(PUR_ReceiveBill)追溯。本轮新增明细级筛选、供应商空值筛选、物料维护表格的供应商前端筛选与物料编码块复制等功能。 ## 配置项 > 敏感信息(密码/Token)不进 SVN,用 Web.config / 环境变量管理。 | 配置项 | 说明 | 示例 | |--------|------|------| | OAConnection | OA MySQL(ecology 库,泛微 OA) | server=39.100.72.102;database=ecology;user=ecology | | GXWMS | GXWMS SQL Server | server=10.10.10.101;database=GXWMS | | 金蝶 K3Cloud | 单据查询 API(Kingdee.BOS.WebApi.Client) | http://金蝶地址/api/K3Cloud/ExecuteBillQuery | ## 用法 # 检出 svn checkout svn://地址/路径 # 编译 msbuild GXWebApi.csproj /p:Configuration=Release # 部署 部署到 IIS,访问 procurement.html ## 输入输出 - 输入:前端筛选条件、选中申请单 ID、Excel 文件(.xls XML 格式) - 输出:申请单列表、明细数据、采购订单/收料追溯结果、导入导出结果 ## 关键接口 | 接口 | 方法 | 说明 | |------|------|------| | /api/Procurement/GetRequestList | GET | 申请单列表(分页+多条件筛选) | | /api/Procurement/GetRequestDetail | GET | 单申请单明细 | | /api/Procurement/GetMultiRequestDetail | GET | 多选申请单明细(批量维护) | | /api/Procurement/GetPurchaseOrders | GET | 金蝶采购订单追溯 | | /api/Procurement/GetReceiveNotices | GET | 金蝶收料通知追溯 | | /api/Procurement/GetTraceSummary | GET | 追溯汇总(含收料状态/延期天数) | | /api/Procurement/ExportXlsx | POST | 导出 Excel(body 传 ids 数组) | | /api/Procurement/ImportXlsx | POST | 导入 Excel | ## 本轮新增/更新(v1.1.0) ### 列表筛选增强 - 新增明细级筛选:**物料编码、策略采购负责人、研发采购负责人、供应商** - 使用 `EXISTS (SELECT ... FROM formtable_main_23_dt1 WHERE mainid=S.id ...)`,只筛主表,不展开明细行 - 策略采购负责人/研发采购负责人/供应商 支持输入 `空` 筛选 IS NULL 或空字符串的数据 - 筛选条件改为 4 列 Grid 排版,标题纵向对齐 - 供应商筛选放在研发采购负责人后;业务状态(原单据状态)下拉移到供应商后 ### 物料维护表格(procurement_detail.html) - 新增**供应商前端筛选**(不调后端):下拉选择 全部/为空/不为空/指定值 - "指定值"输入供应商名称后,点击**查询**按钮生效(模糊匹配) - 只过滤当前已加载的明细数据,不影响保存 - 新增**块复制物料编码**按钮: - 按当前筛选条件从全量明细提取物料编码(不受分页影响) - 不去重,每行一个编码、换行分隔,可直接块粘贴到金蝶云星空物料编码列 - 优先 `navigator.clipboard.writeText`,降级 `execCommand` ### 追溯兜底 - 采购订单页签兼容「无收料通知单时 traceDetails 为空」的场景: - 从 `poList`(GetPurchaseOrders 直查)和 `trace.purchaseOrders`(GetTraceSummary 返回的 PO 号)兜底合并展示 ## 注意事项 - 导出接口为 POST,参数放 Body(ids 数组),避免 URL 超长触发 maxQueryStringLength 限制 - 导入字段含多个 INT 类型(onebj/onezje/twobj/twozje/ywzt/jffxdj/jfjz),空值需置 0 - 日期字段(cnjhjfrq/yfjhjfrq)支持 yyyy-MM-dd 文本或 Excel 序列号(如 46260) - 空值筛选标记为"空",物料编码不支持空值筛选 ## 变更记录 | 版本 | 日期 | 改了什么 | |------|------|----------| | v1.0.0 | 2026-08-04 | 初始版本:列表筛选、批量维护、导入导出、金蝶追溯 | | v1.1.0 | 2026-08-05 | 新增明细级筛选(物料/负责人/供应商)、供应商空值筛选、物料维护前端筛选与块复制、采购订单追溯兜底 |