팝빌로 세금계산서 API 연동을 검토하다가 요금 체계나 개발 문서가 기대와 다르다는 이유로 대안을 찾는 담당자가 많다. 이 글은 세금계산서 API가 무엇인지 짧게 정리하고, 팝빌·바로빌·스마트빌·볼타를 비교할 때 실무자가 확인해야 할 기준과 공개된 요금 정보를 정리했다.
세금계산서 API란?
세금계산서 API는 국세청 전자세금계산서 발행·수정·조회 기능을 자체 서비스나 회계 프로그램에 코드로 연결하는 인터페이스다. 정발행(공급자가 발행), 역발행(공급받는 자 요청 기반 발행), 수정발행(착오·환입 등 사유로 재발행)을 API 호출로 처리할 수 있고, 발행 결과를 웹훅으로 받아 내부 시스템에 자동 반영하는 구조가 일반적이다. 홈택스를 직접 열어 건별로 입력하는 대신, 매출·매입 데이터가 쌓이는 시스템(ERP, 자체 청구 시스템, 회계 프로그램)에서 바로 세금계산서를 발행하고 상태를 추적하려는 곳에서 주로 도입한다.
세금계산서 API 제공사를 비교할 때 볼 기준
팝빌, 바로빌, 스마트빌, 볼타 모두 국세청 전자세금계산서 발행 대행 사업자로 API를 제공한다. 비방 없이 기능·도입 방식·문서 접근성을 기준으로 비교하면 다음과 같다.
비교 항목 | 확인 포인트 |
|---|---|
과금 방식 | 건당 단가인지, 월 정액 또는 최소 사용료가 있는지 |
계약·심사 절차 | 가입 후 바로 테스트 가능한지, 별도 계약이나 심사가 선행되는지 |
API 문서 공개 범위 | 회원가입 없이 문서를 열람할 수 있는지, 요청·응답 예시가 충분한지 |
테스트(샌드박스) 환경 | 실제 발행 전에 테스트 키로 전체 흐름을 검증할 수 있는지 |
지원 발행 유형 | 정발행·역발행·수정발행을 모두 API로 지원하는지 |
웹훅·상태 알림 | 발행 성공/실패, 국세청 전송 결과를 콜백으로 받을 수 있는지 |
노코드/저코드 연동 | 개발 리소스가 부족할 때 코드 없이 붙일 수 있는 옵션이 있는지 |
세금계산서 API 요금 비교
요금은 각 사 공개 페이지 기준으로 정리했다. 표에 없는 항목은 해당 페이지에 공개되지 않은 값이므로 "공개 정보 없음"으로 남겨두고, 실제 도입 전에는 반드시 각 사 최신 페이지에서 직접 확인해야 한다.
제공사 | 건당 단가(공개 기준) | 최소 사용료·기술지원비 | 확인 시점 / 출처 |
|---|---|---|---|
볼타 | 정발행 1건 90원, 역발행 1건 200원 | 최소 사용료, 기술지원비, 유지보수비 없음 | 볼타 요금 안내 페이지(bolta.io/pricing) 기준 |
팝빌 | 공개 정보 없음(요금표는 팝빌 사이트 로그인·문의 후 확인 필요) | 공개 정보 없음 | popbill.com/Taxinvoice/API 확인 필요 |
바로빌 | 공개 정보 없음(개발자센터 페이지에 이용요금 안내가 있으나 세부 단가는 별도 확인 필요) | 공개 정보 없음 | dev.barobill.co.kr/partners/cost/partner 확인 필요 |
스마트빌 | 공개 정보 없음 | 공개 정보 없음 | smartbill.co.kr/Svc/svc_openAPI.aspx 확인 필요 |
팝빌, 바로빌, 스마트빌은 API 이용요금이 회원가입이나 별도 문의를 거쳐야 정확히 확인되는 구조라, 이 글에서는 각 사 공개 페이지에 명시된 값만 인용했다. 견적을 받을 때는 건당 단가 외에 최소 사용료, 기술지원비, 유지보수비가 별도로 붙는지 함께 물어보는 것이 좋다.
볼타 API가 지원하는 연동 범위
볼타는 국세청 인가를 받은 발행 대행 사업자로 REST API 기반 연동을 제공한다. 볼타 세금계산서 API 연동 페이지와 볼타 API 개요 문서에서 확인할 수 있는 핵심 지원 범위는 다음과 같다.
정발행 API: 공급자가 직접 세금계산서를 발행하는 구조로, 전자세금계산서 정발행 API 문서에서 요청·응답 명세를 확인할 수 있다.
역발행 API: 공급받는 자의 요청을 기반으로 발행을 진행하는 흐름을 지원한다.
수정발행 API: 착오 정정, 공급가액 변동 등 사유별 수정세금계산서 발행을 API로 처리한다.
웹훅: 발행·전송 상태 변화를 콜백으로 수신해 내부 시스템에 자동 반영할 수 있다.
테스트 키 기반 샌드박스: 실제 발행 전 테스트 환경에서 전체 흐름을 검증할 수 있다.
노코드 연동: 개발 리소스 없이도 붙일 수 있는 연동 방식을 함께 제공한다.
도입 전 확인할 체크리스트
요금 구조: 건당 단가, 최소 사용료, 기술지원비·유지보수비 유무를 견적서로 받아 비교했는가
개발 리소스: 자체 개발 인력으로 API 연동이 가능한지, 노코드 옵션이 필요한지 판단했는가
공동인증서(구 공인인증서) 준비: 발행 대행에 필요한 인증 수단을 사전에 확보했는가
테스트 환경: 실제 발행 전에 테스트 키로 정발행·역발행·수정발행 시나리오를 모두 검증했는가
운영 알림: 발행 실패, 국세청 전송 오류를 담당자에게 즉시 알리는 웹훅·알림 체계를 구성했는가
기존 시스템 연결: ERP, 회계 프로그램, 자체 청구 시스템과 데이터 흐름이 끊기지 않는지 확인했는가
자주 묻는 질문
Q. 팝빌 대신 세금계산서 API를 바꾸려면 기존 발행 이력은 어떻게 되나요?
발행 이력은 국세청에 귀속되므로 제공사를 변경해도 홈택스에서 조회할 수 있다. 다만 각 사 관리 화면에서의 이력 열람 방식은 다를 수 있으므로 이관 시 확인이 필요하다.
Q. 정발행과 역발행 API를 모두 지원하는지는 어떻게 확인하나요?
각 제공사의 API 문서에서 발행 유형별 엔드포인트가 별도로 문서화되어 있는지 확인하면 된다. 볼타는 정발행·역발행·수정발행 API를 각각 문서로 제공한다.
Q. 개발 인력이 없어도 API 연동이 가능한가요?
제공사에 따라 노코드 연동 옵션을 제공하기도 한다. 도입 전에 개발 없이 붙일 수 있는 방식이 있는지 확인하는 것이 좋다.
Q. 요금은 어디서 정확히 확인하나요?
제공사별 공식 요금 안내 페이지를 최신 기준으로 직접 확인해야 한다. 일부 제공사는 회원가입이나 문의 후에만 상세 단가를 안내한다.