유니패스 오픈API 신청, 가이드 정보 통관정보 조회, 개인통관고유부호 검증
개요
수출입화물의 화물통관정보 조회나 수입신고 개인통관고유부호 검증을 하려고 할 때 관세청에서 운영하는 유니패스(UniPass)사이트에서 직접 조회를 할 수도 있지만 각 쇼핑몰 사이트 등에서 해당 기능을 만들어서 제공하려고 할 때는 유니패스에서 제공하는 Open API를 활용하면 됩니다.
사용 신청
일단 유니패스 사이트 주소는 다음과 같습니다.
⁃ https://unipass.customs.go.kr/
![유니패스 오픈API 신청, 가이드 정보 : 통관정보 조회, 개인통관고유부호 검증](/images/programming/api/api_unipass_openapi_01.jpg)
유니패스 사이트에 접속해서 회원 가입을 한 이후에 오른쪽 상단에 있는 My메뉴에 들어가시면 [서비스 관리] - [OpenAPI 사용관리] 메뉴가 있습니다.
현재는 총 30건의 오픈API를 제공하고 있고, 화면 오른쪽 하단에 보면 [연계가이드 다운로드]와 [Open API 신청] 버튼이 있습니다.
우선 필요한 항목의 API를 선택해서 신청 버튼을 누르면 바로 승인이 완료되고 필요한 인증키 등의 정보가 제공됩니다.
OpenAPI 목록
현재 제공되는 OpenAPI 목록은 다음과 같습니다.
-
화물통관 : 진행정보 수입화물의 일반정보와 진행상태별 정보 제공
-
수출신고번호별 수출이행 내역 : 수출신고번호별 수출이행내역 및 잔량 정보 제공
-
수출입요건 승인 내역 : 수출입화물의 요건승인내역 정보 제공
-
검사검역 : 내역 수출입 화물의 검사/검역 정보 제공
-
장치장 정보 : 보세구역 부호 및 주소 정보 제공
-
화물운송주선업자 목록 : 화물운송주선업자 부호 및 상호 정보 제공
-
화물운송주선업자 내역 : 화물운송주선업자 주소, 전화번호 등 정보 제공
-
항공사 목록 : 항공사 부호 정보 제공
-
항공사 내역 : 항공사 부호, 상호, 주소 등 상세 정보 제공
-
통관고유부호 : 통관고유부호 및 상호 정보 제공
-
해외공급자부호 : 해외공급자 부호 및 상호 정보 제공
-
관세확율 정보 : 관세확율 정보 제공
-
관세사 목록 : 관세사 부호 및 상호 정보 제공
-
관세사 내역 : 관세사 부호 및 전화번호등 상세 정보 제공
-
간이정액 환급율표 : 간이정액환급율 정보 제공
-
간이정액 적용/비적용 업체 : 간이정액 환급 적용/비적용 업체 정보 제공
-
수출이행기간 단축대상 품목 : 수출이행기간 단축대상 품목 정보 제공
-
HS부호 :HS 정보 제공
-
통계부호 : 내국세율, 관세 감면/분납부호 등 통계부호 제공
-
컨테이너내역조회 : 컨테이너번호, 규격, 봉인번호 제공
-
입항보고내역조회 : 적하목록관리번호, 호출번호 등 입항정보 제공
-
수입신고필증검증 : 수입신고필증 검증 여부 제공
-
보세운송차량등록내역 : 보세운송차량등록내역 조회 제공
-
입출항보고내역조회 : 입출항보고내역 조회 제공
-
통관단일창구 처리이력 : 통관단일창구 처리이력 조회
-
선박회사 목록 : 선박회사 부호 정보 제공
-
선박회사 내역 : 선박회사 부호, 상호, 주소 등 상세 정보 제공
-
수입신고 개인통관고유부호 검증 : 수입신고 개인통관고유부호 검증 제공
-
세관장확인대상 물품조회 : 세관장확인대상 물품조회 제공
-
관세율 기본 조회 : 관세율 기본조회 제공
연계가이드를 다운로드 받으면 압축파일인데 압축을 풀면 아래와 같이 MS워드 문서와 PDF문서 2가지가 제공됩니다.
![유니패스 오픈API 신청, 가이드 정보 : 통관정보 조회, 개인통관고유부호 검증](/images/programming/api/api_unipass_openapi_02.jpg)
이용 방법
이용하는 방법은 가이드에 자세히 나와있지만 간단하게 살펴보면
https://unipass.customs.go.kr:38010/ext/rest/cargCsclPrgsInfoQry/retrieveCargCsclPrgsInfo?crkyCn=인증키&cargMtNo=
이런식으로 REST 방식으로 위 URL 형식으로 인증키와 필요한 정보를 전달하면 값이 반환됩니다.
반환되는 형식은 XML형식으로 간단하게 살펴보면 다음과 같습니다.
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<cargCsclPrgsInfoQryRtnVo> <ntceInfo/>
<cargCsclPrgsInfoQryVo>
<csclPrgsStts>수입신고수리</csclPrgsStts>
<vydf/>
<rlseDtyPridPassTpcd>N</rlseDtyPridPassTpcd>
<prnm>MAG****LAY</prnm>
<ldprCd>D****K</ldprCd>
<agnc/>
</cargCsclPrgsInfoQryVo>
<tCnt>8</tCnt>
문서 업데이트 내역
날짜 | 내용 |
---|---|
2022-01-04 | 문서 최초 생성 |