> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.orderupb2b.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.orderupb2b.com/_mcp/server.

# OrderUp B2B Open API 文件

![](/_fern-files/_img/ca1f03dd8cf099a25abd95e9255222067b6b8b549574f9193f29cc67c6607263.webp)![](/_fern-files/_img/4d361358bff3e3e7f70432bcb3de44bc94e8e41279f1171ae725f330c79fd016.webp)

## 這份文件是什麼

這是 OrderUp B2B Open API 的串接文件，提供給 ERP 系統的技術人員，用來把 ERP 端的商品主檔與庫存同步到 OrderUp B2B 平台。透過這組 HTTP API，你可以推送客戶、商品、規格（SKU）與庫存數量，也可以建立與查詢組合品、單獨同步規格與組合品的價格、同步客戶的點數額度與合約額度，並分頁查詢平台上既有的資料，核對 ERP 與 OrderUp B2B 兩邊的狀態是否一致。

所有 `/v1` 端點都需要 HMAC-SHA256 簽章驗證，細節見[「驗證與簽章」](/authentication)。

## 開始之前

拿到 OrderUp 提供的網域、`client_id` 與 `client_secret` 之後，建議依序閱讀：先看「開始使用」了解建議的串接順序，再看「驗證與簽章」把測試請求的簽章算對，最後在「API 規格」查閱每一支端點的完整規格；遇到錯誤時查「錯誤碼」對照原因。

## 四個入口

#### [開始使用](/getting-started)

網域與憑證、測試請求、建議的串接順序

#### [驗證與簽章](/authentication)

四個必要標頭、canonical string 的組成，以及可逐字核對的簽章範例

#### [API 規格](/api-reference)

50 支端點的完整規格——路徑、參數、請求與回應格式

#### [錯誤碼](/errors)

完整的錯誤代碼對照表，以及兩種錯誤回應形狀