Files
GX.O3.WMS/WebApi/docs/01-采购申请管理.md
T

94 lines
4.5 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# [采购申请管理]
> 采购申请单的查询、筛选、批量物料维护、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 | 新增明细级筛选(物料/负责人/供应商)、供应商空值筛选、物料维护前端筛选与块复制、采购订单追溯兜底 |