판매자 주소록에 국내 주소를 신규 등록합니다.
| 등록된 국내 주소는 '톡스토어 및 선물하기 상품' 등록 시 출고지 및 반품/교환지 정보로 활용할 수 있습니다. 단, 동일한 주소는 중복 등록할 수 없으며, 에러 메시지가 리턴됩니다. 이 경우 에러 메시지 내 중복된 배송지ID 가 리턴되므로 기존에 등록된 주소를 활용해 주세요. |
1. 기본 정보
| 메서드 | URL |
|---|---|
| POST |
|
판매자 주소록 API 호출 시 판매 채널 정보를 따로 설정하지 않아도 됩니다.
등록된 배송지는 톡스토어 및 선물하기 상품 등록 시 공통으로 사용할 수 있습니다.
2. 요청 (파라미터)
| 필드명 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| name | String | 필수 | 배송지명 (50자 이내, 중복가능) |
| name | String | 필수 | 배송지명 |
| postNo | String | 필수 | 우편번호 |
| addressPost | String | 필수 | 기본주소 (500자 이내) |
| addressDetail | String | 필수 | 상세주소 (100자 이내) |
| contact | String | 필수 | 연락처 |
| returnFeeAmount | BigDecimal | 비필수 | 반품배송비 (편도 기준, 0~50만원) 미입력시 0원으로 저장 |
| exchangeFeeAmount | BigDecimal | 비필수 | 교환배송비 (왕복 기준, 0~100만원) 미입력시 0원으로 저장 |
| basicSenderAddress | boolean | 비필수 | 기본 출고지 (기본 값: false) |
| basicReturnAddress | boolean | 비필수 | 기본 반품지 (기본 값: false) |
3. 응답
| 필드명 | 타입 | 설명 |
|---|---|---|
| id | Long | 배송지 ID |
4. 예제
1) 응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 100000
}2) 응답 에러
"errorMessage":"유효하지 않은 요청입니다.",
"errorCode":-10001,
"errorName":"validation_error",
"errorCategory":"common",
"validation":{"name":["name을(를) 입력해주세요."],
"postNo":["postNo는 필수값입니다.을(를) 입력해주세요."]}}