正航依批號查詢庫存及倉儲管理系統 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 機制，避免查詢卡死。