홈택스 화면에서 누르던 세금계산서 발행을 우리 서비스 코드로 옮기고 싶다면, 먼저 경로부터 정해야 해요. 국세청 고시가 정한 전자세금계산서 발급 방법은 홈택스에서 직접 발급하는 것, 표준인증을 받은 자체 시스템(ERP)으로 발급하는 것, 표준인증을 받은 발급 대행 사업자(ASP)를 통해 발급하는 것입니다. 개발팀이 코드로 붙일 수 있는 경로는 뒤의 두 가지입니다.
한눈에 비교
방법 | 코드로 발행 | 준비할 것 | 비용 | 맞는 경우 |
|---|---|---|---|---|
홈택스에서 직접 발급 | 불가 | 사업자 공동인증서 | 무료 | 월 발행이 적고 사람이 직접 누를 때 |
자체 시스템 표준인증 | 가능 | 국세청 표준인증 취득, 전송 시스템 구축과 운영 | 구축과 인증 비용 | 발행량이 아주 많고 전담 조직이 있을 때 |
ASP API 연동 | 가능 | API 키, 사업자 공동인증서 등록 | 건당 요금 | 대부분의 서비스와 사내 시스템 |
1. 홈택스에서 직접 발급
비용이 들지 않고 공동인증서만 있으면 됩니다. 다만 사람이 화면에서 한 건씩 누르는 방식이라 거래가 늘면 발행 누락과 기한 관리가 부담이 돼요. 여러 건을 한 번에 올리는 일괄 발급 기능은 있지만 우리 시스템의 거래 데이터와 자동으로 이어지지는 않습니다.
2. 자체 시스템으로 표준인증 받기
국세청은 ERP나 발급 대행 시스템을 운영하려는 사업자가 표준을 지키는지 인증하는 "전자세금계산서 표준인증" 제도를 둡니다(국세청고시 제2023-17호). 인증 대상은 ERP, ASP처럼 발급과 전송을 맡는 시스템이에요(제10조). 인증을 받으면 자체 시스템에서 발행하고, 발급일 다음 날까지 국세청에 직접 전송합니다(제4조). 대신 인증 준비와 전송 시스템 운영, 고시가 바뀔 때마다 따라가는 유지보수를 직접 떠안습니다. 세금계산서가 핵심 업무가 아니라면 비용이 이득보다 큰 경우가 많아요.
3. ASP의 세금계산서 API 연동
표준인증을 이미 받은 ASP가 만든 API를 호출하는 방식입니다. 우리 서비스는 거래 데이터를 보내고, 국세청 전송과 결과 수신은 ASP가 맡아요. 국내에서 세금계산서 API를 제공하는 곳으로는 팝빌, 바로빌, 스마트빌, 볼타 등이 있습니다.
API를 고를 때는 다섯 가지를 비교하세요.
건당 요금과 최소 사용료: 월 발행량이 적을 때는 최소 사용료가 건당 요금보다 크게 작용합니다.
테스트 환경: 국세청 전송과 과금 없이 연동을 검증할 수 있는지 봅니다.
결과 수신 방식: 발행 결과를 웹훅으로 받는지, 조회 API를 반복 호출해야 하는지 확인합니다.
발행 유형: 정발행, 수정발행, 역발행, 현금영수증까지 한 API로 되는지 봅니다.
대리 발행: 플랫폼이 입점 고객사 대신 발행해야 한다면 고객사 인증서 등록 방식을 확인합니다.
"홈택스 데이터를 가져오는" API는 따로 있습니다
검색하다 보면 홈택스 수집 API나 홈택스 연동 API라는 이름도 보여요. 이쪽은 발행이 아니라, 이미 홈택스에 쌓인 매입과 매출 세금계산서 내역을 가져오는 조회형입니다. 팝빌의 홈택스수집 API, 코드에프의 전자세금계산서 통합 API, 스마트빌의 홈택스 연동 API가 이런 성격이에요. 발행을 붙이려는지 내역을 가져오려는지에 따라 찾을 상품이 다릅니다.
거래처 상태 확인, 국세청 무료 API와 볼타 API는 무엇이 다른가요
세금계산서 발행 API는 아니지만, 국세청은 공공데이터포털에서 "국세청_사업자등록정보 진위확인 및 상태조회 서비스"를 무료로 엽니다. 사업자등록번호로 휴업, 폐업 여부와 과세유형을 조회할 수 있어요. 테스트나 적은 양의 조회라면 이것으로 충분합니다.
운영 서비스에 붙인다면 가용성을 먼저 확인하세요. 초당 호출량을 넘기면 요청이 거절되고(포털 에러 코드 23), 응답이 늦으면 타임아웃(05)이 납니다. 그때 받은 번호는 다시 불러야 해요. 볼타가 운영하며 관측한 바로는 한국 시간 새벽에 요청이 실패하는 일이 잦고, 낮에도 응답하지 않을 때가 있습니다. 한국 새벽은 미국 업무 시간이라, 해외 고객이 쓰는 서비스라면 그 시간대 장애가 곧 업무 중단입니다.
볼타 사업자등록 상태 조회 API는 국세청 응답을 받지 못한 번호를 따로 알려 줍니다.
조회 실패와 정보 없음을 별도 상태로 돌려줘 재조회 대상을 바로 가를 수 있어요.
확인하지 못한 번호는 요금을 받지 않습니다.
요청 한 번에 최대 100건까지 조회하고, 응답에 과세유형(일반과세자, 간이과세자, 면세사업자 등)이 함께 옵니다.
기업 상세 정보가 더 필요하거나 예상 조회량에 맞춘 요금이 궁금하면 사업자등록 상태 조회 API 페이지에서 문의해 주세요.
볼타 API로 첫 발행 요청 보내기
볼타 API는 정발행과 수정발행 1건 90원, 역발행 1건 200원이고 최소 사용료, 기술지원비, 유지보수비가 없습니다. test_ 키로 부르면 국세청 전송도 과금도 일어나지 않아요.
볼타에 가입하고 워크스페이스를 만든 뒤 개발자센터에서
test_키를 발급합니다.자사 발행이면 우리 회사, 대리 발행이면 고객사의 인증서를 등록합니다. 테스트에는 테스트 인증서를 씁니다.
거래 정보를 보내면 API가 접수 응답으로
issuanceKey를 돌려줍니다. 최종 결과는 웹훅이나 조회 API로 받으세요.
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
--user 'test_YOUR_API_KEY:' \
-H 'Bolta-Client-Reference-Id: YOUR_UNIQUE_REFERENCE_ID' \
-H 'Content-Type: application/json' \
-d '{
"date": "YYYY-MM-DD",
"purpose": "RECEIPT",
"taxType": "TAXABLE",
"supplier": {
"identificationNumber": "SUPPLIER_BUSINESS_NUMBER",
"organizationName": "공급자 상호",
"representativeName": "홍길동",
"manager": { "email": "supplier@example.com" }
},
"supplied": {
"identificationNumber": "RECIPIENT_BUSINESS_NUMBER",
"organizationName": "공급받는자 상호",
"representativeName": "김철수",
"managers": [{ "email": "recipient@example.com" }]
},
"items": [{
"date": "YYYY-MM-DD",
"name": "테스트 품목",
"unitPrice": 10000,
"quantity": 1,
"supplyCost": 10000,
"tax": 1000
}]
}'
개발자가 없다면 MAKE 같은 노코드 도구로도 같은 API를 부를 수 있어요. 방법은 MAKE로 볼타 API 연동하기에 정리했습니다.
자주 묻는 질문
홈택스가 세금계산서 발행 API를 직접 제공하나요?
아니요. 공공데이터포털에서 국세청이 여는 Open API는 사업자등록정보 진위확인 및 상태조회 서비스뿐이고, 세금계산서 발행 API는 없습니다(2026년 9월 기준). 홈택스 화면을 거치지 않고 자체 시스템에서 발급해 국세청에 전송하려면 그 시스템이 국세청 표준인증을 받아야 해요(국세청고시 제2023-17호 제9조, 제10조). 그래서 대부분의 서비스는 표준인증을 받은 ASP의 API를 씁니다.
위택스 API도 같은 방식인가요?
위택스는 지방세를 신고하고 납부하는 시스템이라 세금계산서 발행과는 관계가 없습니다. 공공데이터포털에는 위택스 Open API가 없어요(2026년 9월 기준). 지방세 납부확인서나 부과내역을 가져오는 조회형 API는 코드에프 같은 민간 업체가 제공합니다.
API로 발행해도 홈택스에서 조회되나요?
네. ASP가 국세청에 전송한 세금계산서는 홈택스 발급목록에 나타납니다.
월 발행이 10건뿐인데 API가 필요할까요?
사람이 직접 누르는 게 부담이 없다면 홈택스나 볼타 웹 무료 플랜으로 충분해요. 거래 데이터가 이미 시스템에 있고 발행을 잊는 일이 생긴다면 그때 API를 붙이세요. 최소 사용료가 없는 API라면 10건은 900원입니다.
참고
전자(세금)계산서 시스템을 구축·운영하는 사업자가 지켜야 할 사항 및 표준 인증에 관한 고시, 국가법령정보센터
국세청_사업자등록정보 진위확인 및 상태조회 서비스, 공공데이터포털
지방세 부과내역 (위택스), 코드에프 개발자 문서