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

4.5 KiB
Executable File
Raw Permalink Blame History

[采购申请管理]

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