바로빌의 홈택스 매입매출조회 API 연동하여 이용하기

 

 

 

안녕하세요. 

회사 매입매출관리를 효율적으로 관리할 수 있는,

바로빌의 '홈택스 매입매출조회 API' 연동에 대해 소개해드리려고 합니다.

 

 

 

 

 

 회사에서 회사 내부 정산 프로그램 개발 중에

홈택스에 신고된 세금계산서와 현금영수증의 매입매출자료를 어디서 손쉽게 가져올 수 있을까? 하다가,

지인의 추천을 통해 바로빌 개발자센터의 홈택스 매입매출조회 API 서비스를 알게 되었습니다.

 

바로빌은 2009년부터 운영중인 표준전자인증을 받아 20만 사업자가와 함께하고 있는 전자세금계산서 발급 전문 기관으로,

전자(세금)계산서를 중심으로 다양한 서비스를 API형태로 제공하고 있습니다.

 

 

 

 

 

 

 

바로빌의 다양한 API 서비스 중 홈택스 매입매출조회 API는 홈택스로부터 파트너의 매입매출내역 데이터를 수집하여,

파트너가 매입매출자료를 손쉽게 조회 및 관리할 수 있도록 도와주는 서비스입니다.

 

상세한 API 가이드와 다양한 샘플언어를 제공하고 있어 개발중인 사이트에 연동하기 쉬워보였고,

회사 월간 매입매출 내역이 약 7,000건에서 10,000건 정도 발생하는데, 해당 홈택스 매입매출조회 API를 사용하면 대량의 데이터를 조회할 수 있으며 홈택스 연동 시 현금영수증 발급이 무료로 제공되어 큰 메리트를 느꼈습니다.

현재는 홈택스 매입매출조회 API 연동문의 후 견적서를 받았고, 견적이 마음에 들어 샘플소스를 활용해 테스트 개발을 진행 중인 단계에 있습니다.

 

 

 

 

 

 

 

홈택스 매입매출 조회 API를 사용하기위해 바로빌 개발자센터 페이지에 들어가보면 ,

전자(세금)계산서 발급 API, 홈택스 전자(세금)계산서 매입매출 조회 API, 전자문서 발급 API, 현금영수증 발급 API, 홈택스 현금영수증 매입매출 조회 API 등등...! 홈택스 매입매출조회 API 뿐만 아니라 다양한 API 서비스를 OPEN API 형태로 제공하고 있어서, 여러 필요한 기능들만 골라 회사시스템에 자유롭게 도입할 수 있을 것 같아보였습니다.

별도의 프로그램 설치 없이 필요한 서비스만을 선택해 원하는 시스템/솔루션/웹사이트/앱에 연동할 수 있으니 활용성도 좋아보였구요!

 

 

 

 

 

홈택스 매입매출조회 API 개발 테스트를 해보기 위해 API 레퍼런스를 찾아보았는데요.

API서비스가 처음인 분들도 쉽게 API 연동 개발을 할 수 있도록 상세한 API 가이드와 레퍼런스를 제공하고 있더라구요,

자세한 API 레퍼런스는 아래 링크에서 확인하실 수 있습니다.

https://dev.barobill.co.kr/docs/references/홈택스-매입매출조회-API?src=text&kw=0001C1

 

 

 

 

 

 

아래는 API 레퍼런스에 나와있는 홈택스 매입매출조회 API 목록입니다.

홈택스 매입매출조회 API는 아래와 같이 4개의 API로 구성되어 있고,

API명(Daily, Monthly)만 봐도 일별, 월별 매출내역, 매입내역을 가져오는 API라는 것을 쉽게 알아볼 수 있었습니다.

 

 

 

매출내역 조회 API : GetDailyTaxInvoiceSalesList, GetMonthlyTaxInvoiceSalesList
매입내역 조회 API : GetDailyTaxInvoicePurchaseList, GetMonthlyTaxInvoicePurchaseList

 

 

 

그 중 일별매출내역조회 API (GetDailyTaxInvoiceSalesList API)의 파라미터를 살펴보았습니다.

원하는 조회일자(BaseDate)의 매출내역을 TaxType별로 나누어 호출할 수 있고,

CountPerPage와 CurrentPage 파라미터를 통해 대량의 데이터라도 페이징을 통해 호출하여 가져오는 것이 가능합니다.

해당 API를 호출하면 바로빌에 등록된 매출 세금계산서를 1일분씩 조회하며, 국세청 전송완료 상태의 세금계산서만 조회됩니다.

 

 

 

API를 호출하면 전달받는 응답메세지(Response) 포맷도 함께 작성되어있는데요,

공급자정보, 공급받는자정보, 수탁자정보, 거래처정보 등등 디테일한 세금계산서 정보를 전달해주네요!

 

 

 

 

 

 

 

응답 메시지에 포함되는 오류 코드는 기본 오류 코드, 연동 정보 관련 오류, 회원 정보 관련 오류 등으로 세분화되어 있어

API 호출 시 오류 코드가 반환되더라도 정확한 원인을 신속하게 파악할 수 있고,

Spring, Java, Python, Node.js, .NET, PHP 등 다양한 개발 언어로 작성된 샘플 코드를 제공하여 개발자들이 각자의 환경에 맞는 코드를 골라 쉽고 빠르게 연동할 수 있으므로 사내 프로그램에 연동하는 과정이 훨씬 더 수월할 것 같습니다.

 

 

 

 

 

 

 

샘플소스코드는 다운로드받아 사용할 수 있고, 언어마다 사용가능한 버전이 적혀있습니다. 

대부분의 언어에서 하위버전부터 지원하고 있기 때문에 대부분의 웬만한 버전에서 사용이 가능해보였습니다.

저는 Django로 개발한 사이트에 연동하기 위해 파이썬 소스코드를 다운받았습니다.

다운받은 폴더 안에는 계좌조회, 문자전송, 세금계산서, 전자문서, 카드조회, 현금영수증 등등 다양한 API의 샘플코드가 들어있습니다.

 

 

 

 

 

 

 

 

아까 요청파라미터와 응답파라미터를 살펴보았던 일별매출내역조회 API (GetDailyTaxInvoiceSalesList API) py파일을 열어보면,

API를 테스트용, 운영용으로 호출할 수 있도록하여 운영쪽에는 주석처리가 되어있고, 테스트용 호출 결과를 출력하는 코드가 작성되어있습니다.

 

 

 

 

 

 

임포트해야하는 라이브러리(zeep)를 간단하게 설치해주고 일별 매출내역조회 API를 호출해보았습니다.

샘플코드를 그대로 사용하여 필수 요청파라미터 8개를 입력하고 테스트서버로 API를 호출하여보니 result로 오류코드 -10002를 반환받았습니다. 오류코드 -10002는 연동정보 관련 오류코드로 인증키를 찾을 수 없다는 코드였습니다.

라이브러리로 묶여져있어 호출하는 코드도 복잡한 로직이 없고, 오류코드도 한번에 알 수 있어 사용이 굉장히 간단하고 편리했습니다.

 

 

 

pip3 install zeep

 

 

 

 

매우 간단한 API 연동과 직관적인 사용법으로, 별도 홈택스 사이트에 접속하지 않아도 사내 시스템에서 전자세금계산서 매입/매출 내역을 한눈에 파악할 수 있고, 효율적으로 조회하고 관리할 수 있을 것 같습니다.

실제로 바로빌의 홈택스 매입매출조회 API를 사용한 국내 다양한 기업들의 실제 활용 사례들이 이미 사이트에 게시되어 있어,

이 활용사례를 통해 얼마나 업무가 편리해졌는지 확인할 수 있었습니다.

 

 

 

 

 

관심 있는 분들은 아래 링크에서 자세한 정보를 확인하시고,

바로빌의 홈택스 매입매출 연동 API를 통해 업무 효율성을 높여보시기 바랍니다.

https://dev.barobill.co.kr/docs/references/홈택스-매입매출조회-API?src=text&kw=0001C1

 

 

 

 

 

 

해당 게시물은 업체로부터 소정의 대가를 받아 작성된 글입니다.