正航依批號查詢庫存及倉儲管理系統 API 介接

功能概述

本系統整合 正航 ERP 與 倉儲管理系統 (WMS)，提供以 產品 SKU 與批號 為基準的庫存查詢與儲位管理。

透過 Web 介面與 API，可快速查詢指定商品的批號、庫存數量及所在倉庫，並同步連接倉儲系統取得實際儲位資訊。

查詢來源

資料庫：正航 ERP (MSSQL)
- 表格：comProduct、comBatchAmount
- 條件：BCQty > 0 且 WareID <> 'B'
外部 API：倉儲管理系統
- URL: https://stock.zfun.com.tw/wp-json/batch/v1/get-pallet
- 參數：
  - sku: 商品代號 (ProdID)
  - batch_number: 批號 (BatchID)

前台查詢顯示欄位

欄位名稱	說明
SKU	商品代號 (ProdID)
品名規格	產品名稱 (ProdName)
批號	批號 (BatchID)
倉庫	倉庫代號 (WareID)
數量	庫存數量 (BCQty)
製造日期	生產日期 (ProduceDate)
有效期限	有效日期 (ValidDate)
儲位	來自倉儲系統 API 的 location 清單

API 介接說明

1. ERP 批號查詢 API

路由：GET /api/sku/<sku>
回傳格式：

{
  "SKU001": [
    {
      "no": "20250801",
      "inbound_date": "2025-08-01",
      "expiry_date": "2026-08-01",
      "quantity": 100
    }
  ]
}

2. 倉儲儲位查詢 API

外部 API URL：

{
  "success": true,
  "data": [
    {
      "product_name": "烏骨雞1.1-1.2K(12隻/箱)",
      "sku": "R07-001-00",
      "batch_number": "20250730",
      "pallet_number": "20250730132412",
      "quantity": 600,
      "unit": "隻",
      "location": "B11-1-1"
    }
  ]
}

整合顯示：

B11-1-1
B11-1-2
B11-1-3

系統流程

使用者輸入 SKU 或產品名稱。
系統從 正航 ERP 查詢符合條件的批號與庫存。
針對每一個批號，系統再呼叫 WMS API，取得儲位資訊。
前端頁面自動列出 庫存與儲位對應清單。

注意事項

倉庫代號 B 不列入查詢。
僅顯示 庫存數量大於 0 的批號。
儲位資訊完全由 外部倉儲管理系統 API 提供。
建議設定 API timeout 機制，避免查詢卡死。