Coupang Developer Center

API支持的买家用户地区：韩国、台湾

修改发货地址。

修改发货地址，需要outboundShippingPlaceCode及remoteInfoId。

您可通过“发货地查询”API获取outboundShippingPlaceCode及remoteInfoId

※ 注册收货地址时设定的国内或海外分类确定后，不能从国内更改为海外或从海外更改为国内。如果您想更改国内和海外之间的划分，请重新注册一个新的收货地址.

Path

PUT

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/outboundShippingCenters/123456

Request Parameters

Path Segment Parameter

Name	Required	Type	Description
vendorId	O	String	卖家ID 酷澎提供给卖家的固有代码例) A00012345
outboundShippingPlaceCode	O	Number	想要修改的发货地代码

Name

Required

Type

Description

vendorId

String

卖家ID

酷澎提供给卖家的固有代码

例) A00012345

outboundShippingPlaceCode

Number

想要修改的发货地代码

Body Parameter

Name

Required

Type

Description

vendorId

String

卖家ID

酷澎提供给卖家的固有代码

例) A00012345

userId

String

用户ID (酷澎Wing登录账户)

outboundShippingPlaceCode

Number

发货地代码

如果为"null", 则发货地名称不变

shippingPlaceName

String

发货地名称

usable

Boolean

是否可用

global

Boolean

国内或海外

CODE	Mean
false	国内
true	海外

placeAddresses

Array

发货地址

addressType

String

地址类型

CODE	Mean
JIBUN	地区编号
ROADNAME	道路名
OVERSEA	海外

countryCode

String

国家代码，韩国国内为“KR”, 有效长度: 2

companyContactNumber

String

电话号码，例：xx-yyy-zzzz

Type	Min~Max
x	2~4 位
y	3~4 位
z	4 位

phoneNumber2

String

备用电话号码(格式：与电话号码相同)

returnZipCode

String

邮政编码: 数字，5～6位数

returnAddress

String

地址，最长150个字符

returnAddressDetail

String

详细住址，最长200个字符

remoteInfos

Array

偏远地区额外运费

remoteInfoId

Number

创建新的配送信息时无需填写该字段。

修改/删除配送信息时则必须输入。

您可通过查询 API 获取该字段的值。

deliveryCode

String

物流代码

查看物流代码

可注册多个物流公司，但不可重复注册

jeju

Number

济州岛运费（韩元）
您可以输入0韩元或1,000-8,000韩元之间（以100韩元为单位）；不包括货到付款。

例外：EPOST快递可填0或100 - 400KRW 之间（以KRW 100为单位）；

不包括货到付款。

notJeju

Number

济州地区外的配送费(韩元)

与济州地区相同

usable

Boolean

是否使用

创建新的配送信息时无需填写此字段。

如果修改，设置为“true”。如果删除，则设置为“false”。

Request Example

{
  "vendorId": "A00012345",
  "userId": "Test11",
  "outboundShippingPlaceCode": 123456,
  "shippingPlaceName": "테스트 출고지 코드",
  "placeAddresses": [
    {
      "addressType": "ROADNAME",
      "countryCode": "KR",
      "companyContactNumber": "02-1111-1111",
      "phoneNumber2": "",
      "returnZipCode": "05510",
      "returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
      "returnAddressDetail": "테스트 주소 101동 101호"
    },
    {
      "addressType": "JIBUN",
      "countryCode": "KR",
      "companyContactNumber": "02-1111-1111",
      "phoneNumber2": "",
      "returnZipCode": "05510",
      "returnAddress": "서울특별시 송파구 신천동 7-30",
      "returnAddressDetail": "테스트 주소 101동 101호"
    }
  ],
  "remoteInfos": [
    {
      "remoteInfoId": 176476,
      "deliveryCode": "DONGBU",
      "jeju": 0,
      "notJeju": 0,
      "usable": true
    }
  ],
  "usable": true
}

Response Message

Name		Type	Description
code		Number	服务器响应状态码
message		String	详细信息
data		Object
	resultCode	String	代码
	resultMessage	String	消息

Response Example

{
  "code": "200",
  "message": "SUCCESS",
  "data": {
    "resultCode": "SUCCESS",
    "resultMessage": "Modify successfully"
  }
}

Error Spec

HTTP status code (type of error)	Error message	Solution
400 (确认请求参数)	You can enter KRW 0 or between KRW 100 - 400	如果是 EPOST 快递，请确保输入0 KRW 或100 - 400 KRW之间
400 (确认请求参数)	Post code can't be empty	请确认是否输入了returnZipCode值。
400 (重复输入)	[发货地重复] 该地址已被登录。(重复地址代码: 2026xxxx)	请确认是否输入过相同的returnAddress 值。
400 (重复输入)	[发货地重复] Duplicated request. 公司名:xxxxx	请确认是否输入过相同的shippingPlaceName值。
400 (确认请求参数)	运费应为0韩元或1000～20000韩元。	请确认您输入的jeju, notJeju数值范围是否正确。偏远地区配送费请输入0韩元或1,000～20,000韩元。
400 (确认请求参数)	The format of postal code is invalid, it can only be number	请为 returnZipCode值输入非数字字符。
400 (确认请求参数)	params are not allowed null...	请确认是否输入了null 值。
400 (确认请求参数)	params's vendorId not equals gateway's vendorId!	请确认您输入的 vendorId是否正确。
400 (确认请求参数)	The max length of the shipping place name is 50, please input the correct length name	请确认shippingPlaceName值是否小于50个字符。
400 (确认请求参数)	The address detail info can't be null(placeAddress)	请确认是否输入了returnAddress值。
400 (确认请求参数)	Must input the default phone number(phoneNumber1)	请确认是否输入了phoneNumber1值。
400 (确认请求参数)	Must input the default address(address1)	请确认是否输入了returnAddress值。
400 (确认请求参数)	The length of country code is 2, please input correct length country code	请确认您输入的countryCode值是否正确。
400 (确认请求参数)	The format of phone number is invalid, min length is 11 and max length is 14 include the character '-'	请确认您输入的companyContactNumber值是否符合格式要求。须包含'-'，且为11～14个字符。
400 (确认请求参数)	The format of postal code is invalid, it can only be number, min length is 5 and max length is 6	请确认您输入的returnZipCode值是否正确。请输入5～6个数字。
400 (确认请求参数)	Please input the correct phone number format including numbers and '-' (min 9, max 13)	请检查companyContactNumber 或者 phoneNumber2 字段值是否输入正确。正确格式为9-13位数字，包括 '-'

URL API Name

UPDATE_OUTBOUND_SHIPPING_PLACECODE

发货地修改

简介

详细内容

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name