안녕하세요. 카카오 쇼핑하기 담당자입니다.
관세청에서 해외주문에 대한 개인통관고유부호 및 통관 절차 시스템 개편됨에 따라,
톡스토어 주문정보 조회 API 가 변경되어 안내드립니다.
적용 일자
2026년 9월 7일(월) 오후 예정
ㄴ 내부일정 조정으로 인한 적용일 변경 (*As-Is : 9월 3일)
대상
해외배송 주문
변경 사항
1. 일회용 개인통관고유부호의 인증번호 컬럼 추가
주문정보 조회 API 내 OrderDeliveryRequest 오브젝트 하위에 인증번호 컬럼이 추가됩니다.
- 일회용 개인통관고유부호의 인증번호 : singleUseCertNo - 신규 추가
| 키 | 타입 | 설명 | 필수값 여부 |
|---|---|---|---|
| personalClearanceCode | String | 개인통관고유부호 / 일회용 개인통관부호 | 선택 (해외배송only) |
| singleUseCertNo | String | 일회용 개인통관부호의 인증번호 - 신규 추가 |
❐ 대상 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
❐ 관세청 차세대 플랫폼 도입 (8/28) 이전 주문
- personalClearanceCode : 기존 개인통관고유부호 값 노출
❐ 관세청 통관플랫폼 오픈(8/28) 이후 ~ 배포일(9/7) 이전 발생 주문
- personalClearanceCode : 일회용 개인통관고유부호 값 노출
- 통관 시 인증번호가 필요한 경우, 임시 인증번호 Z99999를 사용하여 통관을 진행해주세요.
❐ 배포일(9/7) 이후 발생한 주문
- personalClearanceCode (유지): 일회용 개인통관고유부호 값 노출
- singleUseCertNo (신규추가) : 일회용 개인통관고유부호의 인증번호 값 노출
ℹ️ 참고사항
- 관세청 통관 플랫폼 오픈 시, 일회용 개인통관고유부호 및 인증코드로 통관이 필요합니다.
- 일회용 개인통관고유부호의 인증번호 컬럼 추가 오픈 전에는 기존 OrderDeliveryRequest > personalClearanceCode 값으로 통관을 진행하시면 됩니다.
- 관세청에서 통관 시 인증코드를 요청할 경우, 임시 인증코드(z99999)로 통관을 진행해주세요.
- 일회용 개인통관고유부호가 제공된 이후부터는 singleUseCertNo를 통해 제공되는 실제 일회용 인증번호를 사용하여 통관해주시기 바랍니다.
2. 관세청 유효성 검증 추가
교환요청 시, 관세청에 등록된 주소 및 수령인명/연락처 체크 로직 추가
1) 대상 API
- 교환요청 : POST /v2/shopping/claims/exchange/request
2) 유효성 검증
- 교환요청 시, 재배송지 주소가 관세청 개인통관고유부호 정보에 등록된 20개의 주소, 수령인명, 연락처가 구매자와 동일한지 검증
- 아래 케이스인 경우, 교환요청 불가
CASE 주문자와 수령인명/연락처 불일치 재배송지가 관세청 등록 정보와 불일치 관세청 장애
관련하여 궁금하신 점이 있을 경우, http://kko.to/G5xpSFS4j 을 통해 문의 부탁드립니다.
감사합니다.