商品 API 品類 API 運輸 / 訂單 API 退貨 API 換貨 API 物流資訊客服 / 諮詢

物流資訊

GET

/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code示例https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047

2609170000

查看單件退貨地址

# 01

簡介

查看單件退貨地址

# 02

詳細內容

API 適用的买方用户區域：韓國、台灣

使用退貨地址中心程式碼 (returncenterCode)檢視退貨地址資訊。

路徑

GET/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code示例https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047

範例端點

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047

# 03

回應內容

回應訊息

Name

Type

Description

code

number

伺服器響應程式碼

message

string

伺服器響應資訊

data

object[]

退貨地址資訊

vendorId

data[].vendorId

string

賣家程式碼

returnCenterCode

data[].returnCenterCode

string

退貨地址中心程式碼

shippingPlaceName

data[].shippingPlaceName

string

退貨地名

deliverCode

data[].deliverCode

string

快遞公司程式碼

deliverName

data[].deliverName

string

快遞公司名

goodsflowStatus

data[].goodsflowStatus

string

Goodsflow狀態

errorMessage

data[].errorMessage

string

錯誤資訊

createAt

data[].createAt

string

建立日期 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

vendorCreditFee02kg

data[].vendorCreditFee02kg

object

商品重量為 2 kg時的信用費用（賣家信用）

必須大於 0。

currencyCode

data[].vendorCreditFee02kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCreditFee02kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCreditFee02kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCreditFee05kg

data[].vendorCreditFee05kg

object

商品重量為 5kg時的信用費用（賣家信用）

必須大於 0。

currencyCode

data[].vendorCreditFee05kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCreditFee05kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCreditFee05kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCreditFee10kg

data[].vendorCreditFee10kg

object

商品重量為 10 kg時的信用費用（賣家信用）

必須大於 0。

currencyCode

data[].vendorCreditFee10kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCreditFee10kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCreditFee10kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCreditFee20kg

data[].vendorCreditFee20kg

object

商品重量為 20 kg時的信用費用（賣家信用）

必須大於 0。

currencyCode

data[].vendorCreditFee20kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCreditFee20kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCreditFee20kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCashFee02kg

data[].vendorCashFee02kg

object

商品重量為2kg時的寄付現結費用（賣家現金）

必須大於 0。

currencyCode

data[].vendorCashFee02kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCashFee02kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCashFee02kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCashFee05kg

data[].vendorCashFee05kg

object

商品重量為5kg時的寄付現結費用（賣家現金）

必須大於 0。

currencyCode

data[].vendorCashFee05kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCashFee05kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCashFee05kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCashFee10kg

data[].vendorCashFee10kg

object

商品重量為10kg時的寄付現結費用（賣家現金）

必須大於 0。

currencyCode

data[].vendorCashFee10kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCashFee10kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCashFee10kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

vendorCashFee20kg

data[].vendorCashFee20kg

object

商品重量為20kg時的寄付現結費用（賣家現金）

必須大於 0。

currencyCode

data[].vendorCashFee20kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].vendorCashFee20kg.units

number

貨幣整數部分，64-bit

nanos

data[].vendorCashFee20kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

consumerCashFee02kg

data[].consumerCashFee02kg

object

商品重量為2kg時的貨到付款費（買家現金）

必須大於 0。

currencyCode

data[].consumerCashFee02kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].consumerCashFee02kg.units

number

貨幣整數部分，64-bit

nanos

data[].consumerCashFee02kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

consumerCashFee05kg

data[].consumerCashFee05kg

object

商品重量為5kg時的貨到付款費（買家現金）

必須大於 0。

currencyCode

data[].consumerCashFee05kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].consumerCashFee05kg.units

number

貨幣整數部分，64-bit

nanos

data[].consumerCashFee05kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

consumerCashFee10kg

data[].consumerCashFee10kg

object

商品重量為10kg時的貨到付款費（買家現金）

必須大於 0。

currencyCode

data[].consumerCashFee10kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].consumerCashFee10kg.units

number

貨幣整數部分，64-bit

nanos

data[].consumerCashFee10kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

consumerCashFee20kg

data[].consumerCashFee20kg

object

商品重量為20kg時的貨到付款費（買家現金）

必須大於 0。

currencyCode

data[].consumerCashFee20kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].consumerCashFee20kg.units

number

貨幣整數部分，64-bit

nanos

data[].consumerCashFee20kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

returnFee02kg

data[].returnFee02kg

object

商品重量為2kg時的退貨費

必須大於 0。

currencyCode

data[].returnFee02kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].returnFee02kg.units

number

貨幣整數部分，64-bit

nanos

data[].returnFee02kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

returnFee05kg

data[].returnFee05kg

object

商品重量為5kg時的退貨費

必須大於 0。

currencyCode

data[].returnFee05kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].returnFee05kg.units

number

貨幣整數部分，64-bit

nanos

data[].returnFee05kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

returnFee10kg

data[].returnFee10kg

object

商品重量為10kg時的退貨費

必須大於 0。

currencyCode

data[].returnFee10kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].returnFee10kg.units

number

貨幣整數部分，64-bit

nanos

data[].returnFee10kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

returnFee20kg

data[].returnFee20kg

object

商品重量為20kg時的退貨費

必須大於 0。

currencyCode

data[].returnFee20kg.currencyCode

string

貨幣程式碼（符合ISO-4217標準），3位大寫字元

units

data[].returnFee20kg.units

number

貨幣整數部分，64-bit

nanos

data[].returnFee20kg.nanos

number

貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]

usable

data[].usable

boolean

能否使用

placeAddresses

data[].placeAddresses

object[]

退貨地址

addressType

data[].placeAddresses[].addressType

string

地址型別
JIBUN, JIBUN&ROADNAME

代码	含义
JIBUN	地块编号
ROADNAME	道路名称

countryCode

data[].placeAddresses[].countryCode

string

國家程式碼（符合ISO-3166標準），有效長度: 2 。例如：韓國國內為“KR”, 臺灣地區為 “TW”

companyContactNumber

data[].placeAddresses[].companyContactNumber

string

退貨地址電話號碼 (格式需符合E.164標準)

phoneNumber2

data[].placeAddresses[].phoneNumber2

string

備選電話號碼 (格式需符合E.164標準)

returnZipCode

data[].placeAddresses[].returnZipCode

string

退貨地址郵編

returnAddress

data[].placeAddresses[].returnAddress

string

退貨地址

returnAddressDetail

data[].placeAddresses[].returnAddressDetail

string

詳細退貨地址

# 04

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400 (check request parameter)	中心程式碼不可為空...	檢視是否沒有輸入退貨地址中心程式碼（returnCenterCodes）。
500	500 (server error)	讀取超時	檢視退貨地址時發生錯誤。稍後重試或更改輸入值。點擊檢視相關FAQ

HTTP

類型

錯誤訊息

解決方案

400

400 (check request parameter)

中心程式碼不可為空...

檢視是否沒有輸入退貨地址中心程式碼（returnCenterCodes）。

500

500 (server error)

讀取超時

檢視退貨地址時發生錯誤。稍後重試或更改輸入值。

點擊檢視相關FAQ