Coupang Developer Center

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

创建发货地址。您可通过该API创建多个发货地，所创建的发货地将被指定为注册商品时使用的的发货地。

创建相同地址的发货地会受限。

创建/修改发货地时，请将usable参数值设置为true (use)。

Path

POST

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

Example Endpoint

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

Request Parameters

Path Segment Parameter

Name				Required	Type	Description
vendorId				O	String	卖家ID 酷澎提供给卖家的固有代码例) A00012345

Body Parameter

Name

Required

Type

Description

vendorId

String

卖家ID

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

例) A00012345

userId

String

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

shippingPlaceName

String

发货地名称，最多50个字符

不可重复注册相同名称的发货地

0usable

boolean

是否可用

true	可用
false	不可用

默认值: true

global

boolean

默认值: false

国内或海外

CODE	Mean
false	国外
true	海外

placeAddresses

Array

发货地址

addressType

String

地址类型

JIBUN, ROADNAME, OVERSEA

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

偏远地区额外信息

deliveryCode

String

物流代码

查看物流代码

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

jeju

Number

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

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

不包括货到付款。

notJeju

Number

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

与济州地区相同

Request Example

{
  "vendorId": "A00011620",
  "userId": "testId",
  "shippingPlaceName": "상품출고지 생성",
  "global": "false",
  "usable": "true",
  "placeAddresses": [
    {
      "addressType": "JIBUN",
      "countryCode": "KR",
      "companyContactNumber": "02-1234-5678",
      "phoneNumber2": "010-1234-5678",
      "returnZipCode": "10516",
      "returnAddress": "경기도 파주시 탄현면 월롱산로",
      "returnAddressDetail": "294-58"
    }
  ],
  "remoteInfos": [
    {
      "deliveryCode": "KGB",
      "jeju": "5000",
      "notJeju": "2500"
    },
    {
      "deliveryCode": "CJGLS",
      "jeju": "5000",
      "notJeju": "2500"
    }
  ]
}

Response Message

Name		Type	Description
code		Number	服务器响应码
message		String	服务器响应消息
data		Object	发货地创建结果
	resultCode	String	结果代码 SUCCESS or FAIL
	resultMessage	String	结果信息(发货地代码) 显示为outbound shipping place code 可通过该代码查看发货地列表

Response Example

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

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
400 (确认请求参数)	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位数字，包括 '-'
500 (确认请求参数)	shipping-places create error.	请确认输入的物流公司合同代码(contractNumber)数值是否正确。

URL API Name

REGISTER_OUTBOUND_SHIPPING_CENTER

发货地创建

简介

详细内容

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name