국세청 api 연동하여 간단히 정산시스템을 구축해 보자.

 

경영전략팀의 요청으로 회사 내부 정산 프로그램 개발을 담당하게 되었다. 어떻게 개발해야 하나 고민하던 중, 지인의 추천을 통해 바로빌 개발자센터에서 제공하는 API를 연동해 국세청 API를 사용해보려 한다. 이 API는 홈택스 매입매출 조회뿐만 아니라 현금영수증 발급, 전자세금계산서 발급 기능도 제공한다. 바로빌 API 상품을 개발 중인 웹에 연동하여 사용하기로 하였다.

 

바로빌이란?

바로빌 (barobill) 은 2009년부터 운영 중인 표준 전자 인증을 받아 약 20만 명의 사업자와 함께하고 있는 전자세금계산서 발급 전문 기관이다. 바로빌은 전자세금계산서와 관련된 API를 제공하는 업체로, 주로 홈택스 스크래핑, 국세청 API와 연동된 API를 지원한다. 또한, 실제 서비스 운영에 필요한 카카오톡, 문자 전송 API, 홈택스 스크래핑 등의 기능경영전략팀의 요청으로 회사 내부 정산 프로그램 개발을 담당하게 되었다. 어떻게 개발해야 하나 고민하던 중, 지인의 추천을 통해 바로빌 개발자센터에서 제공하는 API를 연동해 국세청 API를 사용해보려 한다. 이 API는 홈택스 매입매출 조회뿐만 아니라 현금영수증 발급, 전자세금계산서 발급 기능도 제공한다. 바로빌 API 상품을 개발 중인 웹에 연동하여 사용하기로 하였다.

 

 

 

바로빌이란?

바로빌 (barobill) 은 2009년부터 운영 중인 표준 전자 인증을 받아 약 20만 명의 사업자와 함께하고 있는 전자세금계산서 발급 전문 기관이다. 바로빌은 전자세금계산서와 관련된 API를 제공하는 업체로, 주로 홈택스 스크래핑과 연동된 API를 지원한다. 또한, 실제 서비스 운영에 필요한 카카오톡, 문자 전송 API, 홈택스 스크래핑 등의 기능도 모두 함께 제공하고 있다.

- URL (LINK) 을 첨부하니, 관심 있으면 사용해보아도 좋겠다.

 

바로빌은 다양한 API를 제공하여, 관련 기능을 함께 구현하는 데에 매우 편리하다는 인상을 주었다. 위에서 볼 수 있듯이, 전자문서 / 세금 계산서 / 현금 영수증 등과 관련된 다양한 API를 제공한다. 또한, 원하는 API만 선택하여 사용한만큼 지불하는 합리적인 시스템을 제공하며, API 한 건 이상 연동 시 사업자 휴폐업 조회 와 현금영수증 발급 은 건수 상관 없이 무료로 사용 가능하다는 점에서, 사내 경영지원 팀에서 크게 만족하였다.

 

바로빌 API는 SOAP 방식의 통신을 지원하는데, 이를 통해 국세청 시스템과 호환도 되고, REST API에 비해 안전하다는 이점을 가져가는 듯 하다.

 

API 통신 가이드

다양한 전자세금계산서 API 제공 업체가 존재하는데, 바르빌을 선택한 건 약 세 가지 정도의 이유에서이다.

1. 개발을 요청한 경영지원팀에서 원하는 모든 기능을 API 형태로 제공

2. API 사용의 가이드가 상세하다는 점

3. 다양한 언어로 예시 코드를 작성해주는지

 

위 이미지에서 볼 수 있듯이, 다양한 언어로 샘플소스를 제공하여 거의 모든 개발자들이 샘플코드를 참고하여 국세청 API를 연동 쉽게 서비스를 제공할 수 있겠다는 생각이 들었다. 필자는 파이썬을 주로 사용하므로, 파이썬 버전의 샘플 코드를 다운 받아 확인해보려 한다.

 

다운 받은 파일의 압축을 풀어 확인해보면, 바로빌에서 제공하는 계좌조회, 홈택스 스크래핑 등의 API의 사용 방법에 대한 샘플 코드가 제공되는 것을 확인할 수 있다. 아래 코드를 이용해 국세청 오픈 API를 쉽게 사용해보자.

그 중, 세금계산서의 저장 / 발급예정을 동시에 처리하는 RegistAndPreIssueTaxInvoice API의 코드와 가이드를 함께 살펴보았다.

바로빌 사이트에서 제공하는 세금계산서 API 가이드



API를 호출할 때 사용할 변수들에 대한 자세한 설명과, 이를 사용하는 방법에 대해 코드로 제공하니, 개발자 입장에서는 (특히 나처럼 맡은 업무에서 조금은 벗어난 일을 하게 된 경우) 너무나도 반갑게 사용할 수 있는 점이 바로빌 홈택스 API의 장점이라 생각한다.

 

필자는 머신러닝 개발자이므로 국세청 오픈 API를 호출하고, 서비스를 연동하는 작업이 무척 어려울 것이라 예상했는, 실제 체감되는 개발의 허들이 매우 낮아 감사히 사용할 수 있었다.

다양한 스크래핑을 위한  API들

바로빌에서는 다양한 스크래핑을 위한 API도 제공한다. 제공하는 API들로는 홈택스스크래핑,  매입매출조회 API, 사업자등록 상태조회 API, 카드/계좌 조회 API 가 있다. 이를 통해 쉽게 국세청 API를 이용할 수 있다.

현금영수증 서비스 신청

사업자등록 상태조회 API

마치며

세금계산서, 현금영수증, 홈택스 스크핑 등의 다양한 정산에 관련된 기능을 구현하고 싶다면, 바로빌 API를 고려해보자. 사용해본 입장에서 입문의 허들이 무척 낮고, 개발 가이드, 에러 코드 가이드가 친절하며, 다양한 언어에 대해 샘플 코드를 제공한 것이 정말 개발좌 친화적이란 인상을 주었기 때문이다. 

 

합리적인 가격으로 API 사용을 제공한다는 점과, 국세청 API를 어렵지 않게 사용할 수 있다는 점, 개발친화적이란 점에서 바로빌 API를 강력히 추천한다.

 

바로빌 개발자센터 URL:

API 레퍼런스 - 홈택스 매입매출조회 API | 바로빌 개발자센터

 

 

 

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