과학기술정보통신부 우정사업본부_우체국 종적 조회
| 분류체계 | 통신 - 우정 | 제공기관 | 과학기술정보통신부 우정사업본부 |
|---|---|---|---|
| 관리부서명 | 우정사업정보센터 인터넷우체국팀 | 관리부서 전화번호 | |
| API 유형 | REST | 데이터포맷 | XML |
| 활용신청 | 604 | 키워드 | 경제경영,마케팅,물류유통관리,통합배송조회,등기번호,보낸사람,배달상태,우체국 |
| 등록일 | 2019-03-19 | 수정일 | 2025-08-12 |
| 비용부과유무 | 무료 | 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | ||
| 공간범위 | 시간범위 | ||
| 이용허락범위 | |||
| 참고문서 | 기술문서양식_우정사업본부_통합배송조회_20190311.docx | ||
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 등기번호 | rgist | 13 | 필수 | 8690770027579 | 등기번호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 요청등기번호 | requestRegiNo | 13 | 필수 | 1111111111111 | API 요청 등기번호 |
| 응답 시간 | responseTime | 50 | 필수 | 2019-03-12 10:06:32 | API 응답 시간 |
| 성공 여부 | successYn | 4 | 필수 | Y | API 성공 여부 |
| 에러 메세지 | errorMessage | 100 | 필수 | 조회 결과가 없습니다. | API 에러 메세지 |
| 등기번호 | regiNo | 13 | 필수 | 1111111111111 | 조회된 등기번호 |
| 보낸 사람 | senderName | 50 | 옵션 | 남*구청 | 발신인명 |
| 보낸 날자 | senderData | 10 | 옵션 | 2019-01-19 | 발신날자 |
| 받는 사람 | receiveName | 50 | 옵션 | 최*홍 | 받는 사람 |
| 받은 날자 | receiveDate | 10 | 옵션 | 2019-01-19 | 받은 날자 |
| 배달 상태 | trackState | 10 | 옵션 | 배달완료/미배달등 | 배달 상태 |
| 서비스종류 | expressType | 10 | 옵션 | EMS | 국제우편인경우 해당 서비스 종류가 표기 |
| 정렬순서 | sortNo | 3 | 옵션 | 1 | 배송진행 사항에 대한 정렬 순서 |
| 처리일시 | date | 10 | 옵션 | 2019-01-19 | 배송 진행 처리 일시 |
| 처리시간 | time | 10 | 옵션 | 10:55 | 배송 진행 처리 시간 |
| 처리상태 | Statue | 10 | 옵션 | 접수 | 배송 진행 상태 |
| 처리장소 | location | 50 | 옵션 | 상주공검우체국 | 배송 처리 장소 |
| 상세설명 | remark | 500 | 옵션 | 발송국 : KRSELB(서울국제) 도착예정 교환국 : USORDA 발송횟수 : 68 운송편명 : OZ236 | 국제우편인경우 상세한 설명 표기 |
샘플코드는 PC에서 확인해주세요.
| 분류체계 | 통신 - 우정 | |
|---|---|---|
| 제공기관 | 과학기술정보통신부 우정사업본부 | |
| 관리부서명 | 우정사업정보센터 인터넷우체국팀 | |
| 관리부서 전화번호 | ||
| API 유형 | REST | |
| 데이터포맷 | XML | |
| 활용신청 | 604 | |
| 키워드 | 경제경영,마케팅,물류유통관리,통합배송조회,등기번호,보낸사람,배달상태,우체국 | |
| 등록일 | 2019-03-19 | |
| 수정일 | 2025-08-12 | |
| 심의유형 | 개발단계 : 자동승인 / 운영단계 : 자동승인 | |
| 공간범위 | ||
| 시간범위 | ||
| 비용부과유무 | 무료 | |
| 신청가능 트래픽 | 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능 | |
| 이용허락범위 | ||
| 참고문서 | 기술문서양식_우정사업본부_통합배송조회_20190311.docx | |
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | 필수 | - | 공공데이터포털에서 받은 인증키 |
| 등기번호 | rgist | 13 | 필수 | 8690770027579 | 등기번호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 요청등기번호 | requestRegiNo | 13 | 필수 | 1111111111111 | API 요청 등기번호 |
| 응답 시간 | responseTime | 50 | 필수 | 2019-03-12 10:06:32 | API 응답 시간 |
| 성공 여부 | successYn | 4 | 필수 | Y | API 성공 여부 |
| 에러 메세지 | errorMessage | 100 | 필수 | 조회 결과가 없습니다. | API 에러 메세지 |
| 등기번호 | regiNo | 13 | 필수 | 1111111111111 | 조회된 등기번호 |
| 보낸 사람 | senderName | 50 | 옵션 | 남*구청 | 발신인명 |
| 보낸 날자 | senderData | 10 | 옵션 | 2019-01-19 | 발신날자 |
| 받는 사람 | receiveName | 50 | 옵션 | 최*홍 | 받는 사람 |
| 받은 날자 | receiveDate | 10 | 옵션 | 2019-01-19 | 받은 날자 |
| 배달 상태 | trackState | 10 | 옵션 | 배달완료/미배달등 | 배달 상태 |
| 서비스종류 | expressType | 10 | 옵션 | EMS | 국제우편인경우 해당 서비스 종류가 표기 |
| 정렬순서 | sortNo | 3 | 옵션 | 1 | 배송진행 사항에 대한 정렬 순서 |
| 처리일시 | date | 10 | 옵션 | 2019-01-19 | 배송 진행 처리 일시 |
| 처리시간 | time | 10 | 옵션 | 10:55 | 배송 진행 처리 시간 |
| 처리상태 | Statue | 10 | 옵션 | 접수 | 배송 진행 상태 |
| 처리장소 | location | 50 | 옵션 | 상주공검우체국 | 배송 처리 장소 |
| 상세설명 | remark | 500 | 옵션 | 발송국 : KRSELB(서울국제) 도착예정 교환국 : USORDA 발송횟수 : 68 운송편명 : OZ236 | 국제우편인경우 상세한 설명 표기 |
샘플코드는 PC에서 확인해주세요.