亿正电工 MES 外围接口文档

通用说明

请求格式

称重类接口兼容 GET 和 POST。推荐 POST 使用统一外层 data。

POST /autoAPI/getProductInfo
Content-Type: application/json

{
  "data": {
    "F_SCBarcode": "ZQB2505230359"
  }
}

GET 方式支持两种参数形式：

GET /autoAPI/getProductInfo?data={"F_SCBarcode":"ZQB2505230359"}
GET /autoAPI/getProductInfo?F_SCBarcode=ZQB2505230359

返回格式

老称重接口成功通常返回 code: "1"，新增报表类接口通常返回 code: "200"。

代码	含义
`1` / `200`	成功
`202`	异步任务运行中
`400`	参数格式错误或必填参数缺失
`401`	微信鉴权失败或无权限
`404`	条码、客户、电表、任务等不存在
`409`	重复扫码、重复抄表或身份证后六位匹配多人
`422`	业务校验不通过
`500`	系统异常或数据库异常

GET/autoAPI/health

服务健康检查。用于判断接口程序是否启动，返回服务状态、时间、版本和支持的参数格式。

GET /autoAPI/health

称重接口文档

这组接口是本程序最早的核心用途，供自动称重入库设备调用。业务流程是：扫描生产条码，查询 MES 产品信息；称重后写入入库表；按称重条码生成轴标签、侧标签或箱标签打印数据。

典型流程： getProductInfo 校验生产条码 → getWeightPrintData 写入称重入库并返回打印数据 → 装箱完成时用 getBoxPrintData 查询箱标签数据。

称重接口总览

接口	方法	读写	用途	核心数据来源
`/autoAPI/getProductInfo`	GET/POST	只读	根据生产条码查询产品信息	存储过程 `jk_get_wy01`
`/autoAPI/getWeightPrintData`	GET/POST	写入	称重入库，生成称重条码和标签数据	`jk_get_wy01`、`sp_get_latest_material_codes_readonly`、`zs_scan_in_stock`
`/autoAPI/getBoxPrintData`	GET/POST	只读	根据称重条码查询箱标签打印数据，支持多轴用 `&` 拼接	存储过程 `jk_get_box_print_data`
`/autoAPI/getPackingPreview`	GET/POST	只读	预览物料下一装箱号、计划号、装箱序号	存储过程 `sp_get_latest_material_codes_readonly`

GET/POST/autoAPI/getProductInfo

功能：根据生产条码查询 MES 产品基础信息，验证生产条码是否存在。

必填参数：F_SCBarcode，生产条码，对应 MES 生产追溯号。

GET /autoAPI/getProductInfo?data={"F_SCBarcode":"ZQB2505230359"}

{
  "message": "查询成功",
  "code": "1",
  "data": {
    "F_SCBarcode": "ZQB2505230359",
    "F_MaterialCode": "物料编码",
    "F_MaterialName": "物料名称",
    "F_Spec": "规格",
    "F_BundleNetWeight": 盘具重量,
    "F_PrintTmplCode": "打印模板代码"
  }
}

getProductInfo 字段对应说明

接口字段	主要来源	说明
`F_SCBarcode`	`tb_report_work.lot_no`	生产条码 / 生产追溯号。
`F_ShellNo`	`tb_report_work.zNo`	外壳号或轴号相关信息，按存储过程返回为准。
`F_ProductionDate`	`tb_report_work.report_time`	生产日期。
`F_Model`	`tb_report_work.material_name`	产品型号或报工物料名称。
`F_MaterialName`	`bs_material.material_pm`	物料品名。
`F_Spec`	`bs_material.material_spec`	物料规格。
`F_MaterialCode`	`tb_report_work.material_code`	物料编码。
`F_material_id`	`bs_material.material_id`	物料 ID，写入称重表时保存。
`F_QCCode`	`zs_qc_material_record.qc_user`	质检员。
`F_QCStatus`	`zs_qc_material_record.result`	质检结果。
`F_Level`	`zs_qc_material_record.internal_grade`	内部等级。
`F_Batch`	`tb_report_work.wo_code`	工单号。
`F_Device`	`bs_eqpt_all.eqpt_code`	生产设备编码。
`F_Bundle`	`plan_wo.wire_disc` / `tb_report_work.wire_disc`	盘具规格。
`F_BundleNetWeight`	盘具物料重量字段	盘具重量，用于计算净重。
`F_CustomerClassCode`	`tb_report_work.customer_code` / 工单客户字段	客户编码。
`F_CustomerOrderNo`	`plan_wo.purchase_order`	客户采购订单号。
`F_Sn`	`plan_wo.customer_material_code`	客户物料编码。
`F_BatchNo`	`plan_wo.customer_batch_no` 优先	客户批次号。当前接口会优先使用 `customer_batch_no` 覆盖。
`F_Standard`	`plan_wo.execute_std` / `bs_material.execute_std`	执行标准。
`F_PackingNum`	`plan_wo.box_quantity`	装箱数量，对应 DMFA 逻辑。
`F_bqfa`	`tb_report_work.print_temp_type_id`	标签方案或打印模板相关编码。
`F_PrintTmplCode`	`F_bqfa` / `print_temp_type_id`	打印模板代码。为空时接口兜底为 `DEFAULT_TEMPLATE`。
`F_ProcessRequirement`	工单或物料工艺要求字段	工艺要求，称重入库时写入 `process_requirement`。

GET/POST/autoAPI/getWeightPrintData

功能：接收称重设备上传的生产条码和毛重，校验后写入 zs_scan_in_stock，返回轴标签、侧标签、称重条码等打印所需数据。

参数	必填	说明
`F_SCBarcode`	是	生产条码。接口会先调用 `jk_get_wy01` 验证。
`F_GrossWeight`	是	毛重。必须是大于 0 的数字。
`F_BZBarcode`	否	称重条码。不传时系统按装箱逻辑自动生成。
`F_zxxh`	否	装箱序号。一般由系统自动计算。

关键校验：生产条码必须存在；生产条码不能重复入库；手工传入的称重条码不能重复；净重必须大于 0。

净重计算：F_NetWeight = F_GrossWeight - F_BundleNetWeight。

POST /autoAPI/getWeightPrintData
Content-Type: application/json

{
  "data": {
    "F_SCBarcode": "ZQB2505230359",
    "F_GrossWeight": "750.5"
  }
}

getWeightPrintData 写入字段对应说明

接口/计算字段	写入 `zs_scan_in_stock` 字段	来源和说明
`F_SCBarcode`	`scan_id`	生产条码。
`F_GrossWeight`	`material_mz`	毛重，来自称重设备。
`F_NetWeight`	`material_jz`	净重，接口计算：毛重 - 盘具重量。
`AA`	`eqpt_code`	称重入库设备编码，当前固定写入 `AA`。
`F_ZXDH`	`zxdh`	MES 装箱单号，来自 `sp_get_latest_material_codes_readonly` 的 `next_zxdh`。
`F_BZBarcode`	`wy_F_BZBarcode`	称重系统条码。可手工传入，也可按 DMFA 自动生成。
`F_Model`	`material_name`	产品型号。
`F_MaterialName`	`material_pm`	物料品名。
`F_Spec`	`material_spec`	物料规格。
`F_MaterialCode`	`material_code`	物料编码。
`F_material_id`	`material_id`	物料 ID。
`F_Level`	`internal_grade`	内部等级。
`F_Standard`	`execute_std`	执行标准。
`F_Bundle`	`material_zj`	盘具规格。
`F_BundleNetWeight`	`zj_weight`	盘具重量。
`F_dmfa`	`dmfa`	装箱容量。无包装为 0，否则取 `F_PackingNum`，默认 1。
`F_bqfa`	`bqfa`	标签方案。
`0`	`sync_flag`	同步标识，当前固定 0。
`千克`	`material_unit`	重量单位。
`TN1353`	`create_by`	创建人，当前固定写入。
`0`	`is_delete`	删除标识。
当前时间	`bzdate`、`create_time`	称重入库时间。
`F_CustomerOrderNo`	`khdh`	客户订单号。
`F_Sn`	`khwlbh`	客户物料编码。
`F_MatShortName`	`material_short_name`	物料简称。
`F_PickNo`	`jhh`	计划号，来自 `next_jhh`。
`F_zxxh`	`zxxh`	装箱序号。
`1599`	`dmcx`	装箱程序标识，当前固定。
`F_Jhhls`	`Jhhls`	计划号流水，来自 `next_jhhls`。
`F_xzs`	`xzs`	箱装数。无包装为 1，否则为 DMFA。
`1`	`inFrom`	入库来源，当前固定 1。
`F_BatchNo`	`lot_no`	客户批次号。
`F_ProcessRequirement`	`process_requirement`	工艺要求。

getWeightPrintData 返回字段说明

返回字段	说明
`F_SCBarcode`	生产条码。
`F_ZXDH`	MES 装箱单号。
`F_BZBarcode`	称重系统条码，打印端后续查询箱标签时使用。
`F_GrossWeight`	毛重。
`F_NetWeight`	净重。
`F_PickNo`	计划号。
`F_zxxh`	装箱序号。
`F_dmfa`	装箱容量。
`F_PackingStatus`	装箱状态对象，包含是否新箱、当前序号、总容量、下一序号等。
`F_BarcodeLogic`	条码生成逻辑对象，说明称重条码是自动生成还是手工传入。
其他 `F_*` 产品字段	来自 `getProductInfo` 的产品、客户、质检、包装字段。

GET/POST/autoAPI/getBoxPrintData

功能：根据称重条码查询箱标签打印数据。支持一箱多轴，多个称重条码用 & 拼接。

必填参数：F_SCBarcode，这里传入的是称重条码，不是生产条码。

多轴规则：每轴不同字段会用 & 拼接，重量字段自动合计，物料/客户/模板等公共字段取第一轴数据。

GET /autoAPI/getBoxPrintData?data={"F_SCBarcode":"AA2412250001-1"}

POST /autoAPI/getBoxPrintData
{
  "data": {
    "F_SCBarcode": "AA2412250001-1&AA2412250001-2"
  }
}

getBoxPrintData 字段对应说明

返回字段	主要来源	说明
`F_SCBarcode`	`zs_scan_in_stock.wy_F_BZBarcode`	称重条码。多轴时用 `&` 拼接。
`F_OriginalScanId`	`zs_scan_in_stock.scan_id`	原生产条码。多轴时拼接。
`F_CreateTime`	`zs_scan_in_stock.create_time`	称重入库创建时间。多轴时拼接。
`F_QueryTime`	接口当前时间	查询时间。多轴时拼接。
`F_zxxh`	`zs_scan_in_stock.zxxh`	装箱序号。多轴时拼接。
`F_QCCode`	质检记录	质检员。多轴时拼接。
`F_QCStatus`	质检记录	质检结果。多轴时拼接。
`F_BZBarcode`	`zs_scan_in_stock.zxdh`	MES 装箱单号，取第一轴。
`F_ZXDH`	`zs_scan_in_stock.zxdh`	MES 装箱单号。
`F_MaterialCode`	`zs_scan_in_stock.material_code`	物料编码。
`F_MaterialName`	`zs_scan_in_stock.material_pm`	物料品名。
`F_Model`	`zs_scan_in_stock.material_name`	产品型号。
`F_Spec`	`zs_scan_in_stock.material_spec`	物料规格。
`F_Standard`	`zs_scan_in_stock.execute_std`	执行标准。
`F_MatShortName`	`zs_scan_in_stock.material_short_name` / 物料表	物料简称。
`F_Level`	`zs_scan_in_stock.internal_grade`	内部等级。
`F_QC_internal_grade`	质检记录	质检内部等级。
`F_material_unit`	`zs_scan_in_stock.material_unit`	重量单位，默认千克。
`F_BundleNetWeight`	`zs_scan_in_stock.zj_weight`	盘具重量。
`F_ProductionDate`	`zs_scan_in_stock.bzdate` / 生产日期	生产或包装日期。
`F_CustomerOrderNo`	`zs_scan_in_stock.khdh` / 工单客户订单	客户订单号。
`F_Sn`	`zs_scan_in_stock.khwlbh` / 工单客户物料编码	客户物料编码。
`F_BatchNo`	`zs_scan_in_stock.lot_no` / 客户批次号	客户批次号。
`F_CustomerClassCode`	客户编码字段	客户编码。
`F_PickNo`	`zs_scan_in_stock.jhh`	计划号。
`F_dmfa`	`zs_scan_in_stock.dmfa`	装箱容量。
`F_bqfa`	`zs_scan_in_stock.bqfa`	标签方案。
`F_Bundle`	盘具字段	盘具规格。
`F_PositionCode`	`zs_scan_in_stock.eqpt_code`	设备位置。
`F_Device`	设备表 / 报工设备	设备编码。
`F_PrintTmplCode`	`F_bqfa` / 打印模板字段	打印模板代码，默认 `DEFAULT_TEMPLATE`。
`F_GrossWeight`	`zs_scan_in_stock.material_mz`	毛重。多轴时合计。
`F_NetWeight`	`zs_scan_in_stock.material_jz`	净重。多轴时合计。

GET/POST/autoAPI/getPackingPreview

功能：按物料编码和内部等级预览下一装箱信息，方便设备或调试人员判断装箱状态。

参数	必填	说明
`F_MaterialCode`	是	物料编码。
`F_Level`	否	内部等级。

GET /autoAPI/getPackingPreview?data={"F_MaterialCode":"10121001","F_Level":"A"}

getPackingPreview 返回字段说明

返回字段	说明
`current_jhh`	当前计划号。
`next_jhh`	下一个计划号。
`current_zxdh`	当前 MES 装箱单号。
`next_zxdh`	下一个 MES 装箱单号。
`current_zxxh`	当前装箱序号。
`next_zxxh`	下一个装箱序号。
`dmfa`	装箱容量。
`material_code`	物料编码。
`eqpt_code`	设备编码，当前传入 `AA`。
`internal_grade`	内部等级。
`preview_info`	接口组装的预览对象，包含是否新箱、装箱进度、装箱模式。

DMFA 装箱逻辑

DMFA	装箱模式	称重条码生成规则	打印行为
0	无包装模式	无包装时序号为 0	按轴标签/侧标签处理。
1	单件装箱	`F_BZBarcode = ZXDH`	单件即完整一箱。
2	2 件装箱	`F_BZBarcode = ZXDH-ZXXH`	序号 1、2 循环，满箱后打箱标签。
4	4 件装箱	`F_BZBarcode = ZXDH-ZXXH`	序号 1 到 4 循环，满箱后打箱标签。

微信小程序接口文档

这组接口主要服务老板报表、追溯查询、生产报表、工资查询、电表抄表、库存和经营分析小程序。除微信菜单权限接口外，大部分接口是直接面向 MES 数据库的报表查询接口。

权限与基础接口

接口	方法	参数	说明
`/autoAPI/wxMenuAccess`	GET	`code`	微信 code 换 openid，返回当前 openid 允许访问的菜单。
`/autoAPI/wxBossReportAuth`	GET	`code`	兼容旧老板报表权限接口，返回是否允许访问老板报表。
`/autoAPI/health`	GET	无	健康检查。

微信权限使用环境变量 WECHAT_MP_APPID、WECHAT_MP_SECRET 和 BOSS_REPORT_ALLOWED_OPENIDS。如果未配置微信参数，当前程序会进入兼容放行模式。

追溯接口

追溯功能已经集成到微信小程序中，不再提供单独 H5 追溯页面。小程序扫描或输入生产追溯号后，直接调用下面的接口查询生产记录。

GET/autoAPI/traceByLotNo

功能：按生产追溯号查询生产报工记录，用于展示工单、物料、机台、机头、左右位、生产员工和报工时间。

参数：lot_no，生产追溯号，必填。

数据来源：tb_report_work 报工记录，关联 plan_wo、bs_material、bs_eqpt_all、uums_user。

返回字段	说明
`lot_no`	生产追溯号。
`wo_code`	工单号。
`material_name`	物料名称。
`material_spc`	物料规格。
`wire_disc`	盘具规格。
`eqpt_no` / `eqpt_name`	机台编码和名称。
`mould_no`	机头号码。
`jt_side`	左/右位。
`user_name`	生产员工。
`report_time` / `report_date`	报工时间和日期。

GET /autoAPI/traceByLotNo?lot_no=ZQB2603230001

{
  "code": "200",
  "message": "success",
  "data": [
    {
      "lot_no": "ZQB2603230001",
      "wo_code": "工单号",
      "material_name": "物料名称",
      "material_spc": "物料规格",
      "wire_disc": "盘具规格",
      "eqpt_no": "机台编码",
      "eqpt_name": "机台名称",
      "mould_no": "机头号码",
      "jt_side": "左/右位",
      "user_name": "生产员工",
      "report_time": "报工时间",
      "report_date": "报工日期"
    }
  ]
}

工资接口

接口	方法	参数	说明
`/autoAPI/mySalaryByIdCard`	GET	`id_card`、`year_month`	按身份证号或后 6 位查询个人工资。员工编码 QB 走漆包工资，LS 走拉丝工资。
`/autoAPI/wireDrawingSalarySummary`	GET	`year`、`month`	拉丝工资汇总，口径参考 PC 拉丝工资报表。

GET /autoAPI/mySalaryByIdCard?id_card=123456&year_month=2026-04
GET /autoAPI/wireDrawingSalarySummary?year=2026&month=4

生产报表接口

接口	方法	主要参数	说明
`/autoAPI/enameledWireProductionEqptList`	GET	无	漆包机台下拉列表。
`/autoAPI/enameledWireProductionReport`	GET	`date_start`、`date_end`、`eqpt_id`	漆包产量明细。
`/autoAPI/wireDrawingMachineList`	GET	无	拉丝机台下拉列表。
`/autoAPI/wireDrawingProductionDetailReport`	GET	`date_start`、`date_end`、`eqpt_id`	拉丝产量明细。
`/autoAPI/enameledWireWasteDetailReport`	GET	`date_start`、`date_end`、`eqpt_id`	废线明细。
`/autoAPI/enameledWireWasteSummaryReport`	GET	`date_start`、`date_end`	废线汇总日报。
`/autoAPI/enameledWireWasteRealtimeStock`	GET	`date_end`	实时废线库存，区分漆包废线和裸铜线废线。
`/autoAPI/enameledWireProductionConsumptionReport`	GET	`query_date`	漆包产量、废线、用电量和吨耗日报。
`/autoAPI/enameledWireProductionMonthlySummary`	GET	`year`、`month`	漆包生产月汇总。
`/autoAPI/mesCopperPriceQuery`	GET	`date_start`、`date_end`	MES 铜价历史查询。

电表抄表接口

接口	方法	参数	说明
`/autoAPI/electricMeterList`	GET	无	电表列表。
`/autoAPI/electricMeterByCode`	GET	`meter_code`	扫码或输入电表编码查询电表信息。
`/autoAPI/electricMeterLastReading`	GET	`meter_id`	查询最近一次抄表记录。
`/autoAPI/electricMeterSaveReading`	POST	`meter_id`、`reading_date`、`reading_value`、`remark`、`user_id`、`user_name`	保存抄表记录。会校验同日电表不能重复，且读数不能小于前一次或大于后一次。
`/autoAPI/electricMeterConsumptionReport`	GET	`date_start`、`date_end`、`meter_id`	用电量明细报表。

销售经营报表接口

接口	方法	参数	说明
`/autoAPI/salespersonList`	GET	无	业务员下拉列表。
`/autoAPI/customerList`	GET	无	客户下拉列表。
`/autoAPI/customerMonthStatement`	GET	`year`、`month`、`customer_code`	客户月对账单。
`/autoAPI/salespersonMonthReportOptimizedV1`	GET	`year`、`month`、`salesperson`、`summary_only`	业务员月报同步查询。
`/autoAPI/salespersonMonthReportOptimizedV1Start`	GET	同上	业务员月报异步任务启动，返回 `job_id`。
`/autoAPI/salespersonMonthReportOptimizedV1Result`	GET	`job_id`	轮询异步任务结果。运行中返回 `202`。

库存与框架订单接口

接口	方法	参数	说明
`/autoAPI/stockQueryFilters`	GET	无	库存查询筛选项，包括物料名称、规格、等级、标签方案。
`/autoAPI/stockQuery`	GET	`material_name`、`material_spec`、`grade`、`label_scheme`	成品库存汇总，返回轴数和净重合计。
`/autoAPI/frameworkOrderCustomers`	GET	无	框架订单客户下拉。
`/autoAPI/frameworkOrderList`	GET	`customer_code`	进行中框架订单、未核销数量、最近三天订单量。

维护说明

本页只描述当前程序中已经存在的接口，不包含旧备份中已不存在的接口。
本页为静态说明页面，不参与业务接口处理，不改变称重、追溯、小程序接口逻辑。
上线到接口服务器后，浏览器访问 http://服务器IP:9888/ 即可查看此文档。