개요

수출입화물의 화물통관정보 조회나 수입신고 개인통관고유부호 검증을 하려고 할 때 관세청에서 운영하는 유니패스(UniPass)사이트에서 직접 조회를 할 수도 있지만 각 쇼핑몰 사이트 등에서 해당 기능을 만들어서 제공하려고 할 때는 유니패스에서 제공하는 Open API를 활용하면 됩니다.

사용 신청

일단 유니패스 사이트 주소는 다음과 같습니다.

https://unipass.customs.go.kr/

유니패스 오픈API 신청, 가이드 정보 : 통관정보 조회, 개인통관고유부호 검증

유니패스 사이트에 접속해서 회원 가입을 한 이후에 오른쪽 상단에 있는 My메뉴에 들어가시면 [서비스 관리] - [OpenAPI 사용관리] 메뉴가 있습니다.

현재는 총 30건의 오픈API를 제공하고 있고, 화면 오른쪽 하단에 보면 [연계가이드 다운로드]와 [Open API 신청] 버튼이 있습니다.

우선 필요한 항목의 API를 선택해서 신청 버튼을 누르면 바로 승인이 완료되고 필요한 인증키 등의 정보가 제공됩니다.

OpenAPI 목록

현재 제공되는 OpenAPI 목록은 다음과 같습니다.

  • 화물통관 : 진행정보 수입화물의 일반정보와 진행상태별 정보 제공

  • 수출신고번호별 수출이행 내역 : 수출신고번호별 수출이행내역 및 잔량 정보 제공

  • 수출입요건 승인 내역 : 수출입화물의 요건승인내역 정보 제공

  • 검사검역 : 내역 수출입 화물의 검사/검역 정보 제공

  • 장치장 정보 : 보세구역 부호 및 주소 정보 제공

  • 화물운송주선업자 목록 : 화물운송주선업자 부호 및 상호 정보 제공

  • 화물운송주선업자 내역 : 화물운송주선업자 주소, 전화번호 등 정보 제공

  • 항공사 목록 : 항공사 부호 정보 제공

  • 항공사 내역 : 항공사 부호, 상호, 주소 등 상세 정보 제공

  • 통관고유부호 : 통관고유부호 및 상호 정보 제공

  • 해외공급자부호 : 해외공급자 부호 및 상호 정보 제공

  • 관세확율 정보 : 관세확율 정보 제공

  • 관세사 목록 : 관세사 부호 및 상호 정보 제공

  • 관세사 내역 : 관세사 부호 및 전화번호등 상세 정보 제공

  • 간이정액 환급율표 : 간이정액환급율 정보 제공

  • 간이정액 적용/비적용 업체 : 간이정액 환급 적용/비적용 업체 정보 제공

  • 수출이행기간 단축대상 품목 : 수출이행기간 단축대상 품목 정보 제공

  • HS부호 :HS 정보 제공

  • 통계부호 : 내국세율, 관세 감면/분납부호 등 통계부호 제공

  • 컨테이너내역조회 : 컨테이너번호, 규격, 봉인번호 제공

  • 입항보고내역조회 : 적하목록관리번호, 호출번호 등 입항정보 제공

  • 수입신고필증검증 : 수입신고필증 검증 여부 제공

  • 보세운송차량등록내역 : 보세운송차량등록내역 조회 제공

  • 입출항보고내역조회 : 입출항보고내역 조회 제공

  • 통관단일창구 처리이력 : 통관단일창구 처리이력 조회

  • 선박회사 목록 : 선박회사 부호 정보 제공

  • 선박회사 내역 : 선박회사 부호, 상호, 주소 등 상세 정보 제공

  • 수입신고 개인통관고유부호 검증 : 수입신고 개인통관고유부호 검증 제공

  • 세관장확인대상 물품조회 : 세관장확인대상 물품조회 제공

  • 관세율 기본 조회 : 관세율 기본조회 제공

연계가이드를 다운로드 받으면 압축파일인데 압축을 풀면 아래와 같이 MS워드 문서와 PDF문서 2가지가 제공됩니다.

유니패스 오픈API 신청, 가이드 정보 : 통관정보 조회, 개인통관고유부호 검증

이용 방법

이용하는 방법은 가이드에 자세히 나와있지만 간단하게 살펴보면

  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 문서 최초 생성