안녕하세요.
카카오쇼핑입니다.
톡스토어에 해외배송상품 등록 및 판매가 가능하도록 관련 기능이 추가될 예정입니다.
이에 따라 open api에 신규 추가되는 API와 필드를 안내드리오니 확인 부탁드립니다.
■ 적용 일자
2024년 11월 14일 (목) 오픈 완료
■ 해외배송상품 관련 추가/변경 정책
1. 톡스토어 해외배송상품
1) 판매자주소록에 해외주소 등록/수정이 가능하며, 상품등록 시 해외 출고지/반품지를 설정하여 등록하실 수 있습니다.
2) 해외배송상품 주문시 구매자에게 개인통관고유부호를 수집, 판매자에게 판매자센터 및 open api를 통해 개인통관고유부호를 제공합니다.
3) 해외배송상품 주문은 해외 택배사 및 송장으로 발송 처리가 가능합니다.
2. 해외배송상품 판매 권한 신청 방법
-상품 출고지가 해외 주소지인 ‘해외배송상품’을 판매 하시려면 먼저 해외배송상품 판매 권한을 신청하셔야 합니다.
-신청 시 별도의 승인 절차 없이 바로 판매 권한이 부여되며, 상품상세 페이지 내에 노출되는 ‘스토어 정보 페이지에 해외 구매대행 판매자임을 안내하는 배너가 노출됩니다.
*국내 사업자의 해외배송상품 판매만 가능합니다. 국내 사업자 등록번호가 없는 해외 사업자는 톡스토어 판매자로 입점할 수 없습니다.
■ Open API 변경 사항
1. 해외 주소록 조회/등록/수정 API 신규 추가
-대상 API 판매자 주소록 API
|
No |
신규추가 API |
|
1 |
해외 주소록 단건 조회 GET /v1/shopping/bizseller/foreign-seller-addresses?id={id} |
|
2 |
해외 주소록 목록 조회 GET /v1/shopping/bizseller/foreign-seller-addresses/search |
|
3 |
해외 주소록 등록 POST /v1/shopping/bizseller/foreign-seller-addresses/register |
|
4 |
해외 주소록 수정 PUT/v1/shopping/bizseller/foreign-seller-addresses/modify |
*해외 주소록 API가 신규 추가되며, 기존 국내 주소록 API에는 변경사항 없음.
2. 톡스토어 카테고리 ‘해외 KC 인증 필수 여부’ 컬럼 추가
1) 대상 API
- 카테고리 전체 목록 조회 : GET /v1/store/categories?leafOnly={true|false}
- 하위카테고리목록 조회 : GET /v1/store/sub_categories?categoryId={categoryId}
- 카테고리명 검색 조회 : GET /v1/store/categories/search?keyword={keyword}
2) 해외 KC 인증 필수 여부 컬럼 추가
- Category > 'certKcForeign' 컬럼 추가
- 어린이 제품 등 일부 해외배송상품 등록 시 KC 인증정보가 필수 입력되어야 하는 카테고리의 경우 "REQUIRED”로 연동 됩니다.
|
키 |
타입 |
필수여부 |
설명 |
|
certKcForeign |
String |
선택 |
해외 KC 인증 입력 필수는 "REQUIRED" 해당 없으면 리턴되지 않음 |
3. 톡스토어 상품 등록/수정 해외배송상품 관련 정보 추가
1) 대상 API
- 상품등록/수정 API : POST /v1/store/product/register?product={}, POST /v1/store/product/update?product={}
- 상품조회 API : GET /v1/store/product?productId={productId}
2) 상품 출고지 및 반품지로 해외 주소지ID 설정 가능하도록 변경
- 상품 출고지 및 반품지로 해외 주소지ID를 설정할 수 있습니다.
3) 상품 Delivery 정보로 ‘병행수입여부’ 추가
- Delivery > 'parallelImport' 컬럼 추가
|
키 |
타입 |
필수여부 |
설명 |
|
parallelImport |
Boolean |
선택 |
병행수입인 경우 "true" 병행수입 상품이 아닌 경우 "false" |
*국내/해외배송상품 모두 설정 가능함.
*오픈api로 상품 등록/수정시 ’병행수입 여부(parallelImport)’ 데이터가 없는 경우, 기본값인 ‘대상아님’으로 설정됨
4. 해외배송 여부 및 개인통관고유부호 컬럼 추가
1) 대상 API
- 주문정보 조회 API : GET /v1/shopping/order?order_id={order_id}
- 주문정보 복수 조회 API : GET /v1/shopping/orders/bulk?order_ids={order_ids}
- 변경 주문내역 조회 API : GET /v1/shopping/orders
2) 해외배송여부 컬럼 추가
- OrderDelivery > 'isInternational' (해외배송 여부) 컬럼 추가
|
키 |
타입 |
설명 |
|
isInternational |
String |
해외배송 여부 |
3) 개인통관고유부호 컬럼 추가
- OrderDeliveryRequest > 'personal_clearance_code' 컬럼 추가
|
키 |
타입 |
설명 |
|
personal_clearance_code |
String |
개인통관고유부호 (해외배송 only) |
<requestBody 예시>
{
"id": 3000917210,
"orderBase": {
"id": 3000917210,
"paymentId": 3000833461,
"channelType": "STORE",
"status": "ShippingProgress",
"createdAt": "20241007171450",
"paidAt": "20241007171452",
"modifiedAt": "20241028141227"
},
~~~~~~~~~~~~~~~중략~~~~~~~~~~~~~~~
"orderDeliveryRequest": {
"receiverName": "알리샤",
"receiverAddress": "경기 성남시 분당구 판교역로 지하 160 (백현동, 판교역) 판교아지트 7F",
"receiverAddress1": "경기 성남시 분당구 판교역로 지하 160 (백현동, 판교역)",
"receiverAddress2": "판교아지트 7F",
"receiverPhoneNumber": "",
"receiverMobileNumber": "010-9699-2268",
"zipcode": "13529",
"roadZipCode": "13529",
"requirement": "",
"personalClearanceCode": "P012345678912"
},
"orderDelivery": {
"deliveryRequestAt": "20241007171452",
"confirmedAt": "20241007171504",
"invoiceRegisteredAt": "20241007171549",
"shippingMethod": "SHIPPING",
"deliveryCompanyCode": "GLOBAL_ETC",
"invoiceNumber": "12316546465",
"isInternational": true
}
5. 택배사 코드 > 해외기타택배 추가
1) 대상 API
- 택배사 코드 조회 API : /v1/shopping/delivery/companies
2) 해외기타택배 추가
- 해외배송상품 주문인 경우에 한해, 해외기타택배 선택이 가능합니다. (국내배송상품 입력 불가)
<requestBody 예시>
{
"id": 9998,
"code": "GLOBAL_ETC",
"name": "해외기타택배"
}
]
관련하여 추가 문의사항은 아래 경로로 전달 부탁드립니다.
*문의하기 > http://kko.to/G5xpSFS4j
감사합니다.