0. Intro
회사업무에서 Notion SDK 를 사용한 API 를 끄적여 본 경험을 토대로, 지금은 정산관련 서비스를 연동해보고있다.
정산업무를 하려면 홈택스API 로 연결해야하는데, 홈택스API에 직접 연동하면, 직접 개발해야하는 분량이 커지므로 업체에서 제공하는 서비스를 찾아보게되었다.
다양한 업체를 찾아보던 중 바로빌에서 제공하는 API 를 확인했고, 이번게시글에서는 API 제공업체인 바로빌에 대한 내용을 작성해보려한다.
1. 바로빌?
바로빌(barobill) 은 전자세금계산서 관련한 API 를 제공하는 업체이다. 주로 홈택스스크래핑과 관련된 API를 제공하고있고, 실제로 서비스를 제공할때 필요한 카카오톡, 문자전동 API등을 전부 제공하고 있다.
다양한 API업체 중 바로빌을 사용하는 이유는 다양한API를 통합해서 제공하고 있다는 장점때문인데, 이미지에서 확인가능하듯이 다양한 API 를 제공하고있다.
2. 제공하는 API 통신방식
바로빌 API 는 SOAP 기반 통신을 제공하고있다는 특징이 있다.
우리가 대부분알고있는 방식은 REST 기반의 HTTP 통신이라, SOAP 기반 통신이라고 해서 큰 차이는 없었다. 실제로 개발할때 상관없기도하고… 그냥 이런게있다.. 라는정도만 알아둬도 좋을것같아서 정리해둔다.
- AWS. SOAP과 REST의 차이점: https://aws.amazon.com/ko/compare/the-difference-between-soap-rest/
왜 바로빌에서는 REST가 아니라 SOAP로 제공하고있을까? 가 궁금해서 찾아봤는데
국세청에서 운영하는 전자세금계산서 시스템에서도 SOAP방식을 채택하고있었다. 국세청시스템과 호환을 맞추기 위해 진행한듯 보였다.
3. API 통신 가이드
내가 다양한 API제공업체를 찾다가 바로빌을 사용하는 이유가 여기때문이다.
처음 API통신을 하게되면 흔히 두가지를 확인하게되는데
- API 연결가이드 문서의 설명이 자세한지?
- 내가 개발하는 언어에도 API를 제공해주는지?
를 확인하게된다.
바로빌API 는 다양한 언어를 제공한다. Java, Python, 닷넷 등등 제공해주는언어가 꽤 많았다.
심지어 관련문서도 잘 제공해줬다.
API 를 사용하기에앞서, 해당기능이 어떤 메커니즘을 사용하고있는지 자세한 설명이 나와있고
홈택스API를 활용해서 서비스를개발할때 주의점과 실제 개발예제 코드 등을 제공해줘서 너무좋았다.
특히나 아래내용처럼 설명을 상세하게 작성된걸 확인가능하다.
심지어 개발샘플코드를 제공해주고 있는데 직접확인해보면
계좌조회, 문자전송, 세금계산서, 전자문서 등등 제공하고있는 API 에 대하여 다양한 예제를 미리 구현해두었다.
서비스를 개발하는 입장에서는, 그대로 다운로드받아서 우리서비스에 맞게 적용시키면된다.
데이터엔지니어로써 SQL쿼리를 작성하거나, CICD 랑 쿠버네티스를 다뤄본 경험만 있는 상태로 공공데이터포털의 API 를 사용하려니 여간 어려운게 아니었는데
기업에서 API를 제공해주고, 자세한 레퍼런스를 제공하다보니, 개발자는 서비스를 연동만 하면 된다.
이런부분때문에 너무 편하게 사용하여 많이들 찾게되는것같다.
추가적으로, 바로빌에서 제공하는 API 서비스를 1개만 연동해도
현금영수증 발급API와 사업자휴폐업 조회API 는 무료로 사용가능하다고한다.
실제로 서비스 개발하다보면 “현금영수증 발급API” 를 상대적으로 빈번하게 호출해야하는데, API비용이 무료라는점은 비용측면에서 매력적인것같다.
4. vs 공공데이터포털
위의 특징이 얼마나 큰것인지 체감하려면, 다른곳에서는 어떻게 API 를 제공하는지 비교해보면 좋은것같다.
사진은 공공데이터포털에서 제공하는 국세청_사업자등록정보 진위확인 관련 api이다.
예를들어서 API상세기능 항목을 봤을때
조금 더 설명이 자세했으면 어떘을까… 싶은 생각이 들게된다.
하단에는 Swagger까지 제공해주고 있다.
Swagger를 제공해준다는게 정말 좋은부분인것은 맞지만, 전체적인 API 에 대한 설명을 조금 더 가독성있게 해줬으면… 하는 아쉬움이 든다.
이런측면에서 홈택스API를 제공하는 바로빌서비스는 상당히 매력적으로 느껴진다.
Outro. 끝으로
기존 갖고있는 서비스에서 추가로 정산(세금계산서, 현금영수증, 홈택스 등등)의 기능개발을 위해 연동할 API 를 찾고있다면, 바로빌API 을 도입해보는게 좋아보인다.
가격도 상대적으로 저렴한편이고, 연관된 API 도 폭넓게 지원해주며, 무엇보다 API 연동관련된 문서화가 잘되어있기 때문이다. 나도 API를 만들어서 배포할땐, 이정도로 문서화를 진행해야 매력적이겠구나… 를 느낄수 있었다.
