我可以透過 API 將 GoFood、GrabFood 和 ShopeeFood 訂單匯入自有 POS，而不需更換 POS 嗎？
簡短回答：可以。您保留自己的 POS、ERP 或廚房系統。外送平台與 klikit 對接，您的系統則透過 klikit Partner API 與 klikit 連接：當訂單建立、狀態變更或品項異動時，Webhook 會即時通知您的系統，而您的系統可透過 REST 讀取完整訂單。您可以在免費沙箱環境中進行開發與測試。正式環境存取權限需經 klikit 審核。您無需額外購買 klikit 方案：Partner API 費用即涵蓋一切，參考定價為每間門市每月 US$49 起（適用 1 至 10 間門市）。
適合對象
- 擁有自有 POS 或 ERP 的餐飲集團，希望外送訂單直接進入現有系統，並使用自己的庫存管理與報表功能。
- POS 與 ERP 供應商，其客戶要求在產品中納入 GoFood、GrabFood 和 ShopeeFood 訂單。
- 為商家建立此整合的系統整合商與代理商。
如果您偏好使用 klikit 自家的 POS 與訂單畫面，則不需要 API：Omni 附加元件可直接連接外送平台。請參閱方案。
運作方式
- 外送平台與 klikit 連接。您的門市已在 klikit 中設定，GoFood、GrabFood、ShopeeFood 及其他您上架的平台皆在此處完成連接。來自各平台的所有訂單，都會以統一格式送達 klikit。
- klikit 會將每筆訂單事件推送至您的系統。您需提供 klikit 一個接收端網址，並訂閱三種事件：
klikit.order.created.v2：新訂單。klikit.order.status.updated：訂單狀態更新，包含取消。klikit.order.cart.updated：訂單中的品項或數量變更。
- 您的系統讀取詳細資料。REST 端點會回傳完整訂單（購物車、顧客、付款與履行明細）、依品牌、分店、狀態與日期篩選的訂單清單，以及各門市套用覆寫設定後的菜單。
- 您的系統可寫回（透過完整 Partner API）：將訂單狀態推進為已接受、備妥、已取餐，或以原因代碼拒絕或取消訂單；並可單筆或批次標記菜單品項的庫存狀態（有貨或缺貨）。
每組憑證僅限單一商家使用，因此金鑰只能存取該商家的品牌與分店。驗證方式為 HTTP Basic，使用 Partner Key 與 Secret。
沙箱與測試
是的，我們提供免費沙箱環境。klikit 的開發環境即為沙箱：其中包含與正式環境結構完全相同的擬真資料，且使用獨立憑證，因此您在沙箱中的所有操作都不會影響實際訂單。請使用您的工作電子郵件登入 Partner Portal，閱讀「入門指南」與「整合手冊」，然後申請沙箱金鑰。整合手冊將引導您從首次 API 呼叫，到建立測試訂單並進行接受、備妥與取餐等完整流程。
取得正式環境存取權限
正式環境金鑰無法自行產生。您需從入口網站提出申請，提供您要整合的商家、您的法律實體與使用案例，klikit 團隊會確認商家與權限範圍後，您才能產生正式環境金鑰。正式金鑰僅顯示一次，且可隨時撤銷。
費用說明
Partner API 費用即為全部成本：您無需同時購買 klikit POS 方案（Core 或 Omni）。以下為美元參考定價，最終定價將於正式環境審核通過時確認，並依據啟用門市數與訂單量決定。
| 方案層級 | 門市數 | 價格 | 內含項目 |
|---|---|---|---|
| 沙箱 | 不限 | 永久免費 | 開發環境 |
| Starter | 1–10 | 每間門市每月 US$49 | 僅限 Webhook、訂單與菜單事件、標準支援 |
| Growth | 11–50 | 每間門市每月 US$39 | 僅限 Webhook、訂單與菜單事件、優先支援 |
| Scale | 51–200 | 每間門市每月 US$29 + 客製建置費 | 完整 Partner API、庫存與撥款功能、專屬整合窗口 |
| Enterprise | 200+ | 客製報價 + 建置費 | Scale 所有功能、大量定價、客製 SLA |
因此，擁有 24 間門市的集團屬於 Growth 方案，參考價格為每間門市每月 US$39。若在此規模下需要將訂單狀態或庫存回寫至 klikit，請於申請時提出：完整 Partner API 功能自 Scale 方案起提供。
常見問題
我可以只訂閱外送平台整合，而不使用 klikit 的 POS 嗎？
可以。您的員工繼續使用自有 POS。您的門市仍須在 klikit 中設定，因為外送平台是與 klikit 連接，而您的 POS 則透過 Partner API 從 klikit 接收訂單。您無需額外支付 klikit POS 方案費用：Partner API 費用已涵蓋一切。
有針對 GoFood、GrabFood 和 ShopeeFood 新訂單的 Webhook 嗎？
有的。klikit.order.created.v2 會針對所有已連接外送平台的新訂單觸發，因此您只需撰寫一個接收端，無需為每個平台各寫一個。狀態變更（包含取消）以及品項或數量變更，則有各自對應的事件。
你們是按訂單計費嗎？
Partner API 的參考定價為每間門市每月計費。最終定價將於正式環境審核時確認，並考量啟用門市數與訂單量。
需要多久時間？
登入並提出申請後，沙箱金鑰的取得流程相當快速。整合手冊以階段性計畫撰寫，從首次 API 呼叫、Webhook 設定到正式環境檢查清單。實際開發時間取決於您的系統；正式環境存取權限則需經 klikit 團隊審核商家與權限範圍後開通。
是否有公開的開發者入口網站或可自助取得的 API 金鑰？
文件與沙箱申請皆在 Partner Portal 上進行。正式環境憑證僅在 klikit 團隊核准申請後核發；您無法從 klikit Cloud 內部自行產生。
我們已經在使用 klikit 的 GrabFood 或 GoFood 整合服務，這是否包含 API 存取權限？
不包含。外送平台整合是將訂單帶入 klikit 供商家使用。若要讓自有系統存取 klikit，需使用 Partner API，此為獨立申請項目。請參閱klikit 是否提供開發者或合作夥伴 API？
下一步
閱讀Partner API 總覽，從Partner Portal下載入門指南，並申請沙箱金鑰。若您是餐飲集團而非開發人員，請與我們聯絡，告知您的門市數量、上架的外送平台，以及您使用的 POS 或 ERP 系統。