orange-office-api（orange office 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
• 每个主播有独立的 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