開發者入口網站和 24 個 API 的國際化變更通知 (2025年6月26日)

您好，這裡是酷澎。

我們將分享開發者入口網站的更新，以及因國際化需求而產生的 24 個 APIs 的格式變更，例如貨幣、日期/時間、電話號碼。

舊版 API 仍然有效，回應與之前相同。新版 API 將於 7 月 25 日後與舊版並行運作。 Coupang 在可預見的未來沒有計劃下線舊版 API 。

生效日：2025 年 7 月 25 日 

目標 API：完整 API 清單如下。

API	URL
建立出貨地點	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters
查詢出貨地點	/v2/providers/marketplace_openapi/apis/api/v2/vendor/shipping-place/outbound
更新送貨地點	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}。
建立退貨地點	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters
顯示退貨清單	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters
更新退貨地點	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
查詢退貨地點	/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code
訂單列表檢視 (每日分頁)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
檢視訂單列表（以分鐘為單位）	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
訂單中單一商品查詢(shipmentBoxId)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}
訂單編號（OrderId）	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/{orderId}/ordersheets
查看出貨記錄	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history
處理產品準備過程	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/acknowledgement
取消處理	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/orders/{orderId}/cancel
退貨申請列表	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests
使用退貨收據號碼進行退貨商品檢查	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests/{receiptId}
確認收到退貨	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnRequests/{receiptId}/receiveConfirmation
處理退貨申請授權	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnRequests/{receiptId}/approval
顧客問題(以產品分類)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries
回答您的問題	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/onlineInquiries/{inquiryId}/replies
詢問酷澎客服中心	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries
酷澎客服中心聯絡人	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/replies
聯絡酷澎客服中心	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/confirms
聯絡酷澎客服中心	/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}

 

說明： 所有變更如下。

1. 支援多國語言：新增繁體中文支援，包括 24 個 API 文件 (台灣賣家需求)、FAQ、指南、如何使用等。
2. 國際化：為這 24 個應用程式推出新版本，以升級貨幣格式、日期/時間、電話號碼的格式，使其符合國際標準，這些API的請求與回應將遵循最新格式。
   1. 貨幣： 使用 json like {"currencyCode": "KRW", "units":1000, "nanos"：0} 表示貨幣，currencyCode 遵循 ISO-4217 https://en.wikipedia.org/wiki/ISO_4217
   2. 日期/時間：遵循 ISO-8601 https://en.wikipedia.org/wiki/ISO_8601
   3. 電話號碼：遵循 E.164 標準 https://en.wikipedia.org/wiki/E.164
3. 升級開發者入口網站：  所有賣家將在不同的市場共用相同的開發者入口網站。
   1. 移除登入功能
   2. 提問：賣家應透過 Wing 提交諮詢需求，路徑如下：點擊 「支援」/「在 Wing 上啟動線上詢問」→登入 Wing（若未登入）→點擊 「OpenAPI」提交需求