商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

物流信息

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

发货地修改

# 01

简介

发货地修改

# 02

详细内容

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

修改发货地址。
修改发货地址，需要outboundShippingPlaceCode及remoteInfoId。
您可通过“发货地查询”API获取outboundShippingPlaceCode及remoteInfoId

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

路径

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

示例端点

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

URL API Name

UPDATE_OUTBOUND_SHIPPING_PLACECODE

# 03

Path 参数

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

# 04

请求体参数

请求参数

请求体参数

Name

Type

Description

vendorId*

string

卖家ID

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

例) A00012345

userId*

string

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

outboundShippingPlaceCode

integer

发货地代码

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

shippingPlaceName

string

发货地名称

usable

boolean

是否可用

global

boolean

国内或海外

CODE	Mean
false	国内
true	海外

placeAddresses*

object[]

发货地址

addressType

placeAddresses[].addressType

string

地址类型

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

countryCode

placeAddresses[].countryCode

string

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

companyContactNumber

placeAddresses[].companyContactNumber

string

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

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

phoneNumber2

placeAddresses[].phoneNumber2

string

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

returnZipCode

placeAddresses[].returnZipCode

string

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

returnAddress

placeAddresses[].returnAddress

string

地址，最长150个字符

returnAddressDetail

placeAddresses[].returnAddressDetail

string

详细住址，最长200个字符

remoteInfos

object[]

偏远地区额外运费

remoteInfoId

remoteInfos[].remoteInfoId

integer

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

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

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

deliveryCode

remoteInfos[].deliveryCode

string

物流代码

查看物流代码

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

jeju

remoteInfos[].jeju

integer

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

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

不包括货到付款。

notJeju

remoteInfos[].notJeju

integer

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

与济州地区相同

usable

remoteInfos[].usable

boolean

是否使用

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

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

请求示例application/json

{
  "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
}

# 05

响应体

响应消息

Name	Type	Description
code	string	服务器响应状态码
message	string	详细信息
data	object
resultCode data.resultCode	string	代码
resultMessage data.resultMessage	string	消息

Response Example

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

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

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