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