4.5 KiB
Executable File
4.5 KiB
Executable File
[采购申请管理]
采购申请单的查询、筛选、批量物料维护、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 | 新增明细级筛选(物料/负责人/供应商)、供应商空值筛选、物料维护前端筛选与块复制、采购订单追溯兜底 |