name: orange-office-api description: 橙子通（orange-office.cn）庫存管理系統 API 自動化。用於通過 API 創建出庫單、查詢庫存、管理主播倉庫等，無需瀏覽器。

橙子通 API 自動化技能

通過 API 操作橙子通庫存管理系統，包括創建出庫單、查詢庫存、管理主播倉庫等。

基礎資訊

• API 站點：https://orange-office.cn
• 簽名 Salt：68756c61
• Cookie：ASP.NET_SessionId=<當前有效會話>

雙系統識別

API 呼叫

簽名演算法

import hashlib

SALT = '68756c61'

def md5(data: str) -> str:
    return hashlib.md5((SALT + data).encode()).digest().hex()

所有 API 請求 body 經過簽名，sign = md5(json.dumps(body, separators=(',',':')))

請求頭

headers = {
    'Content-Type': 'application/json',
    'X-Requested-With': 'XMLHttpRequest',
    'sign': md5(json.dumps(body, separators=(',',':'))),
    'client': 'pcWeb',
    'Cookie': f'ASP.NET_SessionId={SESSION}'
}

常用 API

查詢庫存

POST /stock/prod/getStockList
{
    "keyword": "", "catId": "", "page": 1, "rows": 500,
    "sort": "barcode", "order": "descending",
    "teamId": 724308,        # 場景B用724308，場景A用952393
    "ifValue": "Y",
    "ifShowSku": "Y",
    "ifShowZero": "N",
    "locId": 63              # 倉庫ID，必須填寫
}

返回：response.obj.list[] — 每項含 prodId、prodName、stockQty、outPrice

創建出庫單

POST /stock/stockout/create
{
    "teamId": 724308,
    "outNo": "",             # 空字串自動生成
    "outDate": "2026-03-26",
    "refId": 695620,         # 抖店售賣
    "refName": "抖店售賣",
    "locId": 63,             # 倉庫ID
    "locName": "梅天嬌",
    "amount": 1234.56,       # 總金額 = 各行 amount 之和
    "remark": "機器人操作",
    "itemList": [
        {
            "prodId": 9973574,
            "qty": 24,
            "price": 15,      # 單價從 getStockList 的 outPrice 欄位獲取
            "amount": 360,    # qty × price，保留2位小數
            "outQty": 24,
            "stockQty": 36
        }
    ]
}

注意： - 單價用 outPrice（不是 price） - 金額：amount = qty × outPrice，保留2位小數 - 總金額 amount = 各行 amount 之和

出庫操作三原則

1. 只認"銷售數量"欄位 — 其他欄位（庫存、今日轉倉、銷售金額等）一律不看
2. 每個主播只建一張出庫單 — 出錯時在原單上修改，不刪除重建
3. 先查庫存再建立 — 必須先調 API 查詢實際庫存，確認足夠後再建立

主播倉庫 locId 對應表

系統：庫存通-幼稚鬼潮玩（teamId=724308）

釘釘主播庫存表

• baseId：dxXB52LJqnrEb4pjcQQQjq598qjMp697

  小蔥技能7w4.net持續更新中。

• 每個主播有獨立的 tableId

注意：每個主播的"銷售數量"欄位ID可能不同，操作前必須先呼叫 get_fields 讀取表頭確認。

商品名稱注意

• kpl竟燃禮盒（是"竟"不是"競"）
• pel物競天擇風雲變系列盲抽鐳射票 和 盲抽亞克力掛件 是兩個不同商品
• 卡夾類（130pt卡夾、75pt卡夾等）忽略，無需出庫

釘釘主播庫存表寫入規範（重要！）

錄入主播庫存快照時，必須包含以下全部欄位：

寫入格式：使用 cells 而非 fields，每個欄位對應其 fieldId：

const records = snapshot.map(item => ({
  cells: {
    [fieldId_日期]: '2026-03-27T00:00:00+08:00',
    [fieldId_商品編號]: item.prodNo || '',
    [fieldId_商品名稱]: item.prodName,
    [fieldId_規格型號]: item.prodSpec || '',
    [fieldId_單位]: item.unit || '包',
    [fieldId_庫存數量]: item.qty,
    // 以下欄位填0或空
    [fieldId_今日入庫]: 0,
    [fieldId_今日剩餘]: 0,
    [fieldId_銷售金額]: '',
    [fieldId_送出]: 0,
    [fieldId_銷售數量]: 0,
    [fieldId_今日轉倉]: 0
  }
}));

日期格式：必須是 ISO 格式（如 2026-03-27T00:00:00+08:00），不能只寫 2026-03-27。

計算3月27日庫存快照： 1. 呼叫 getStockList 獲取當前庫存 2. 呼叫 getList 查詢日期=3月27日的出庫單 3. 對每張出庫單呼叫 getInfo 獲取明細 4. 將出庫數量加回到當前庫存，得到3月27日賬面庫存

3月28日之後做快照：由於3月27日之後可能還有出庫，必須先查3月28日之後有無新的出庫單，如有則同樣回補。如果3月28日至今無出庫單，直接用當前庫存即為3月27日快照。

常見問題

Q：儲存時報"總金額錯誤" A：確保每個商品的 amount = qty × outPrice，且總金額 obj.amount 等於各行 amount 之和

Q：商品找不到 A：用更短的關鍵詞搜尋相近商品名稱

Q：Session 過期 A：重新登入並獲取新的 Cookie