Item Object
Item 객체는 배송중인 물건의 대략적인 정보를 나타냅니다. 마스킹된 정보를 포함합니다.
Property | Type | Description |
name | string | 마스킹된 물건명 |
width | integer | 물건의 가로(너비), mm단위 |
depth | integer | 물건의 세로(깊이), mm단위 |
height | integer | 물건의 높이, mm단위 |
weight | integer | 물건의 무게, g단위 |
{
"name": "****",
"width": 10,
"depth": 15,
"height": 20,
"weight": 300
}
JavaScript
복사
Document Object
Document 객체는 연관이 있는 문서들에 대한 정보를 나타냅니다.
{
"type": "DOCUMENT_TYPE",
"code": "DOCUMENT_CODE"
}
JavaScript
복사
History Object
History 객체는 배송 이력에 대한 자세한 정보를 나타냅니다.
{
"statusCode": 800,
"statusText": "DELIVERED",
"statusLocation": "TOKYO, JAPAN",
"statusReason": "If there any specific reasons",
"lastUpdated": "2023-12-14T06:21:00.000Z",
"lastUpdatedLocal": "2023-12-14 15:21:00 JST"
}
JavaScript
복사
Status Code
Status Code | Status Text | Description |
30 | PROCESSING | 작업중 |
60 | PACKED | 포장 완료 |
100 | DISPATCHED | 발송됨 |
200 | AT_ORIGIN_SORT_FACILITY | 발송 터미널 도착 |
310 | DEPARTED_ORIGIN_FACILITY | 발송 터미널 출발 |
312 | DEPARTED_ORIGIN_COUNTRY | 발송국 출발 (첫 국가 출발) |
350 | ON_THE_WAY3 | 이동중 |
351 | ON_THE_WAY_GROUND | 이동중 (육상) |
352 | ON_THE_WAY_AIR | 이동중 (항공) |
390 | ARRIVED_AT_DESTINATION | 교환국 도착 |
410 | ARRIVED_AT_SORT_FACILITY | 중계 터미널 도착 |
450 | ARRIVED_AT_CUSTOMS | 세관 도착 |
460 | CLEARING_CUSTOMS | 통관 진행중 |
470 | CUSTOM_CLEARANCE_FAILED | 통관 실패 |
490 | CUSTOMS_CLEARED | 통관 완료 |
550 | ON_THE_WAY5 | 이동중 |
600 | AT_DESTINATION_SORT_FACILITY | 도착 터미널 |
750 | OUT_FOR_DELIVERY | 배송 출발 |
751 | DELIVERY_REATTEMPT | 배송 재시도 |
800 | DELIVERED | 배송 완료 |
900 | CANCELED | 취소됨 |
910 | NOT_DISPATCHED | 미발송 |
920 | DELIVERY_FAILED | 배송 실패 |
950 | RETURNING | 회송중 |
990 | RETURNED | 회송 완료 |
Tracking Response Object
Property | Type | Description |
result | string | OK: 정상적인 응답
NotFound: 찾을 수 없는 송장
InternalServerError: 해당 송장 조회중 서버 내부 에러 발생 |
trackingNumber | string | 요청한 송장 추적 번호 |
statusCode | string? | 이 문서의 statusCode 참고 |
statusText | string? | 이 문서의 statusText 참고 |
statusLocation | string? | 해당 상태가 발생한 위치 |
statusReason | string? | 해당 상태가 발생한 특수한 사유가 있는 경우 |
lastUpdated | string? | 업데이트된 시간 (UTC) |
lastUpdatedLocal | string? | 업데이트된 시간 (현지시간) |
packagingVideoStatus | string? | NORMAL: 정상
EXPIRED: 만료됨
NOT_ALLOWED: 접근 불가
VOID: 없음 |
packagingVideoUrl | string? | 포장 영상 주소 (있는 경우) |
origin.countryCode | string? | 출발지의 국가코드 (2자리 ISO) |
origin.administrativeArea | string? | 출발지의 최상위 주소 |
destination.countryCode | string? | 도착지의 국가코드 (2자리 ISO) |
destination.administrativeArea | string? | 도착지의 최상위 주소 |
items | Item[]? | 이 문서의 ItemObject 참고 |
documents | DocumentObject[]? | 이 문서의 DocumentObject 참고 |
history | HistoryObject[]? | 이 문서의 HistoryObject 참고 |
Example - OK
{
"result": "OK",
"trackingNumber": "210021232123",
"statusCode": 800,
"statusText": "DELIVERED",
"statusLocation": null,
"statusReason": null,
"lastUpdated": "2023-12-14T06:21:00.000Z",
"lastUpdatedLocal": "2023-12-14 15:21:00 JST",
"packagingVideoStatus": "VOID",
"packagingVideoUrl": null,
"origin": {
"countryCode": "KR",
"administrativeArea": null
},
"destination": {
"countryCode": "JP",
"administrativeArea": null
},
"items": [
[...ItemObject],
[...ItemObject]
],
"documents": [
[...DocumentObject],
[...DocumentObject]
],
"history": [
[...HistoryObject],
[...HistoryObject],
[...HistoryObject]
]
}
JavaScript
복사
Example - NotFound/InternalServerError
{
"result": "NotFound",
"trackingNumber": "210021232123"
}
JavaScript
복사