배송추적 조회 V2

3 more properties

API

/v2/tracks

METHOD

$\color{green}\colorbox{#d1ffbd}{\scriptsize\textsf{GET}}$

REQUEST

header

필드	필수 여부	설명
Accept-Language	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	• ko • en • jp • zh

query

검색 조건

필드	필수 여부	설명
no	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	추적할 번호는 아래 중 하나 • 주문정보의 waybill_no (재배송번호 포함) • 주문정보의 receipt_no • 주문정보의 no_info1
lang	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	번역할 언어 코드 • ko (디폴트 값) • en • jp • zh-hans (간체) • zh-hant (번체)

RESPONSE

필드정의

필드	필수	설명
receipt_no	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	주문의 접수번호
no_info1	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	주문의 주문번호
flight_no	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	항공편명
waybill_no	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	운송장번호 (운송사에 따라 현지에서 발급된 후에 생성되는 경우 있음)
waybill_logs	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	운송장번호 배열 재배송번호가 발급될 경우 요소가 추가됨 idx값이 클수록 최신값이며 max= 3
recentStatus	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	주문의 최신 상태값
url	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	운송사 사이트의 배송조회 Url
check_point	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	추적된 위치정보 (운송사에 따라 위치정보가 없는 트랙이 존재할 수 있음)
departures	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	출발지
arrivals	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	도착지
courier	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	운송사명
nation	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	국가
nation_code	$\color{#333333}\colorbox{#eeeeee}{\scriptsize\textsf{선택}}$	국가 코드
status	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	배송 상태
detail	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	추적 내용 원본
local_time	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	추적된 시간 원본 문자열
checked_at	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	추적된 시간 (운송사에 타임존 정보가 없는 경우 존재함)
timezone	$\color{Red}\colorbox{oldlace}{\scriptsize\textsf{필수}}$	추적된 시간 UTC timezone별 시간 JSON -현재 사용가능: kst ex) "timezone": { "kst": "2024-08-03T10:37:04+09:00" }

recentStatus status 상태값

•

상태 값 별 정의는 주문/CS 상태 참고 

값	설명
waiting	입고 대기
pending	주문 보류
inbound	입고 완료
loaded	출고대기
outbound	출고완료
departure	항공 이륙
arrival	항공 착륙
incustoms	통관 중
customs_delay	통관 지연
customs	통관 완료
delivery_delay	배송 지연
started	배송 시작
shipping	배송중
delivered	배송 완료
terminated	배송 종료
bounce	현지 반송
bounce_kr	한국 반송
bounce_dom	국내 반송
error	주소 오류
rejected	수취 거절
revoked	배송 취소
failed	배달 실패
discarded	폐기
damaged	파손
lost	분실
accepted	수취인 직접 수령
return	반품
resend	한국 재배송
resend_local	현지 재배송
completed	종결

EXAMPLE

Cmd/Ctrl + Option/Alt + T : 전체 열기/닫기

Request

조회 예시

Response

Success

단건 조회 결과 

여러건 조회 결과

해당하는 주문을 찾을 수 없는 경우

주문은 존재하나 tracking 결과가 아직 없는 경우

Fail

송장번호 미전달 시(BAD_REQUEST) 

배송추적 조회 V2

API

/v2/tracks

METHOD

GET\color{green}\colorbox{#d1ffbd}{\scriptsize\textsf{GET}}GET​

REQUEST

header

query

RESPONSE

필드정의

EXAMPLE

Request

Response

Success

Fail

$\color{green}\colorbox{#d1ffbd}{\scriptsize\textsf{GET}}$