전자세금계산서 API, 발행 흐름과 연동 항목표
전자세금계산서 API로 쇼핑몰 · ERP · 정산 프로그램에서 세금계산서를 자동 발행하는 흐름을 정리했습니다. 시행령이 정한 발급 방법 네 가지, 인증서 등록부터 전송 확인까지 발행 순서, 연동 항목표, 수정전자세금계산서 사유 9가지, 발급 · 전송 기한과 가산세, 비용 요인을 담았습니다.

전자세금계산서 API 연동은 부가가치세법 시행령이 정한 전자 발급 방법 가운데 발급 대행 사업자의 시스템을 쓰는 방식을, 그 사업자가 열어 둔 API로 자사 쇼핑몰 · ERP · 정산 프로그램에 붙이는 일입니다. 우리 시스템에서 거래가 확정되면 발행을 요청하고, 국세청 전송과 처리 상태를 받아 기록합니다. 흐름은 두 기한에 맞춰 짭니다 — 세금계산서는 공급시기에 발급하되 월합계 등은 다음 달 10일까지 발급할 수 있고, 발급한 내용은 발급일 다음 날까지 국세청에 전송해야 합니다.
전자세금계산서 API는 어떤 방식으로 붙이나요
부가가치세법 시행령 제68조 제5항은 전자세금계산서를 발급하는 전자적 방법을 네 가지로 정합니다. 어느 방법이든 작성자 신원과 변경 여부를 확인하는 인증시스템을 거쳐 정보통신망으로 발급합니다.
| 방법(시행령 제68조 제5항) | 내용 | 자사 시스템 자동 발행과의 관계 |
|---|---|---|
| 1호 전사적 기업자원 관리설비 | 회사가 갖춘 ERP 설비로 발급 | 설비를 구축 · 운영하려면 미리 국세청장 또는 관할 세무서장에게 등록 |
| 2호 발급 대행 사업자 시스템 | 발급 업무를 대신하는 사업자의 시스템 이용 | 그 사업자의 API로 연동 — 이 글이 다루는 방식(이 시스템도 미리 등록 대상) |
| 3호 국세청 발급 시스템 | 국세청장이 구축한 시스템(홈택스) | 화면에서 직접 발급 |
| 4호 현금영수증 발급장치 등 | 전자세금계산서 발급이 되는 현금영수증 발급장치, 국세청장이 지정한 시스템 | 그 장치 · 시스템을 쓰는 곳 |
자사 프로그램에서 거래가 확정될 때 자동으로 발행하려면 1호처럼 설비를 직접 갖춰 등록하거나, 2호의 발급 대행 사업자 API를 쓰는 길이 있습니다. 1호는 등록 요건과 인증 절차를 직접 갖춰야 하므로, 처음 자동 발행을 붙일 때는 2호 방식이 준비할 것이 적습니다. 발행 건수와 기존 ERP 구성에 따라 세무 · 개발 담당이 함께 고릅니다.
발행 흐름은 어떤 순서로 짜나요
- 인증서 등록 — 발행 전에 공급자의 인증서를 발급 대행 사업자 서버에 미리 등록합니다. 한 서비스의 공식 문서는 위수탁 발행이면 수탁자 인증서를 등록해야 한다고 적고 있습니다.
- 발행 시점 정하기 — 주문 완료 · 납품 확인 · 월 마감 가운데 어느 때 발행할지 정합니다. 이 시점이 공급시기와 맞아야 합니다.
- 받는 쪽 정보 확인 — 공급받는 자의 등록번호 · 상호 · 메일 주소를 거래처 자료에서 불러옵니다. 사업자 상태 조회 API를 함께 두는 서비스도 있습니다.
- 문서번호 붙이기 — 우리 시스템에서 거래마다 겹치지 않는 문서번호를 붙여 보냅니다. 같은 거래가 두 번 발행되지 않게 막는 장치입니다.
- 발행 요청 — 즉시 발행으로 보내거나, 임시저장 뒤 담당자가 확인하고 발행합니다. 발행되면 공급받는 자에게 발행 메일이 갑니다.
- 국세청 전송 확인 — 발급 대행 시스템이 국세청에 전송하고, 우리 시스템은 상태 조회나 웹훅(처리 결과를 우리 주소로 보내 주는 알림)으로 결과를 받아 기록합니다.
- 수정 처리 — 반품 · 계약 해제 · 금액 변경이 생기면 사유에 맞는 수정전자세금계산서를 발행합니다.
발행 방향도 정합니다. 공급자가 작성해 보내는 정발행, 공급받는 자가 작성해 발행을 요청하는 역발행, 위탁판매 · 대리인 판매처럼 공급자 · 공급받는 자가 아닌 쪽이 발행하는 위수탁이 있고, 붙이는 방향이 늘수록 개발 항목도 늘어납니다.
전자세금계산서 API 연동 항목은 무엇을 챙기나요
아래는 한 발급 대행 서비스의 공식 전자세금계산서 API 문서 구성을 바탕으로 정리한 연동 항목입니다. 기능 이름과 가능한 상태는 서비스마다 다르므로 계약 전에 그 서비스의 문서와 대조합니다.
| 연동 항목 | 하는 일 | 우리 시스템에서 정할 것 |
|---|---|---|
| 인증서 등록 | 공급자 인증서를 발급 대행 서버에 미리 등록 | 인증서 갱신일과 담당자 |
| 즉시 발행 | 저장과 발행(전자서명)을 한 번에 처리 | 자동 발행할 거래 조건 |
| 임시저장 · 발행 | 저장해 두고 확인한 뒤 발행 | 확인 담당과 마감 시각 |
| 발행취소 | 국세청 전송 전의 발행완료 건을 신고 대상에서 제외 | 전송 전 취소를 허용할 경우 |
| 수정 발행 | 수정전자세금계산서 발행 | 반품 · 해제 · 금액 변경과 수정 사유 짝짓기 |
| 상태 조회 · 웹훅 | 발행 · 전송 결과 확인 | 실패 건 알림을 받을 사람 |
| 국세청 즉시 전송 | 발행완료 건을 바로 전송(한 서비스는 호출 뒤 최대 30분 안에 처리) | 마감일에 즉시 전송을 쓸지 |
| 역발행 요청 · 거부 | 공급받는 자의 발행 요청 처리 | 역발행을 받을지 |
수정 발행은 사유와 작성일 적는 법이 시행령 제70조 제1항에 정해져 있습니다. 우리 시스템의 이벤트(반품 · 해지 · 금액 변경)를 이 사유와 미리 짝지어 두면 담당자가 사유를 고르느라 멈추지 않습니다.
| 수정 사유 | 작성일과 표시 |
|---|---|
| 처음 공급한 재화가 환입(반품)된 경우 | 환입된 날, 비고에 처음 작성일, 음(-)의 표시 |
| 계약 해제로 공급되지 않은 경우 | 계약해제일, 비고에 처음 작성일, 음의 표시 |
| 계약 해지 등으로 공급가액이 늘거나 줄어든 경우 | 증감 사유가 생긴 날, 늘면 검은색 · 줄면 음의 표시 |
| 과세기간 종료 후 25일 안에 내국신용장 · 구매확인서가 개설 · 발급된 경우 | 처음 작성일, 영세율분 발행과 함께 처음 내용을 음의 표시로 발행 |
| 필요적 기재사항을 착오로 잘못 적은 경우 | 처음 내용을 음의 표시로, 고친 내용을 새로 발행 |
| 착오 외의 사유로 잘못 적은 경우 | 확정신고기한 다음 날부터 1년 안에, 처음 내용 음의 표시와 고친 내용 발행 |
| 착오로 이중 발급한 경우 | 처음 내용대로 음의 표시 |
| 면세 등 발급 대상이 아닌 거래에 발급한 경우 | 처음 내용대로 음의 표시 |
| 세율을 잘못 적용한 경우 | 처음 내용을 음의 표시로, 고친 내용을 새로 발행 |
기재사항 · 세율 착오 사유는 세무조사 통지를 받은 때처럼 경정을 미리 알고 있는 경우를 제외합니다. 실제 사례에 어느 사유를 적용할지는 세무 전문가와 확인합니다.
발급 기한과 전송 기한은 어떻게 지키나요
- 발급 시기 — 재화 · 용역의 공급시기에 발급합니다(부가가치세법 제34조 제1항).
- 월합계 등 — 거래처별로 한 달 공급가액을 합해 말일을 작성 연월일로 발급하는 경우 등은 공급일이 속한 달의 다음 달 10일까지 발급할 수 있고, 그날이 토요일 · 공휴일이면 다음 영업일까지입니다(같은 조 제3항).
- 국세청 전송 — 전자세금계산서 발급일의 다음 날까지 발급명세를 전송합니다(시행령 제68조 제7항).
- 의무 발급 대상 — 법인사업자와, 직전 연도 사업장별 공급가액(면세 포함) 합계가 8천만원 이상인 개인사업자입니다(법 제32조 제2항, 시행령 제68조 제1항). 그 밖의 사업자도 전자로 발급할 수 있습니다.
기한을 넘기면 가산세가 붙습니다. 법 제60조 제2항은 발급 시기가 지난 뒤 확정신고 기한까지 발급하면 공급가액의 1%, 전송 기한이 지난 뒤 확정신고기한까지 전송하면 0.3%, 그때까지 전송하지 않으면 0.5%로 정합니다. 자동 발행을 붙일 때는 월합계 발행 작업을 매달 1일부터 10일 사이 영업일에 돌리고, 전송 실패 알림은 발행 다음 날 오전에 확인하도록 일정표에 넣어 둡니다. 개별 거래의 공급시기 판단과 가산세 적용은 세무 전문가와 확인합니다.
연동 비용은 무엇으로 정해지나요
- 발급 수수료 — 한 서비스는 발행할 때마다 포인트가 차감되는 방식입니다. 단가 · 기본료는 서비스마다 달라 계약 조건으로 비교합니다.
- 연동 범위 — 정발행만 붙이는지, 역발행 · 위수탁 · 수정 발행까지 붙이는지에 따라 개발 항목이 달라집니다.
- 거래처 자료 정리 — 사업자등록번호 · 상호 · 받는 메일 주소가 비거나 틀린 거래처가 많으면 연동 전 정리 작업이 더해집니다.
- 테스트 환경 — 테스트용 인증서 · 테스트 포인트를 두는 서비스가 있어, 실제 발행 전에 수정 발행까지 시험할 수 있는지 봅니다.
- 운영 — 인증서 갱신, 실패 건 재처리, 서비스 사양 변경 반영이 계속 이어집니다.
ERP를 새로 들이는 중이라면 세금계산서를 ERP 안에서 발행할지부터 정합니다. 도입 범위를 정하는 순서는 ERP, 중소기업이 도입 전에 정할 범위와 순서에, 반복 업무를 어디부터 자동화할지는 업무 자동화, 어디서부터 시작하나에 있습니다.
자주 묻는 질문
전자세금계산서는 발행한 뒤 취소할 수 있나요?
부가가치세법 제32조 제7항과 시행령 제70조는 발급한 뒤 내용을 바로잡는 방법으로 수정전자세금계산서를 정하고 있습니다 — 계약 해제 · 이중 발급 같은 사유별로 음의 표시를 해 발행합니다. 일부 발급 대행 서비스는 국세청 전송 전의 발행완료 건을 발행취소로 신고 대상에서 빼는 기능을 두고 있으니, 그 조건을 서비스 문서로 확인합니다.
국세청 전송은 누가 하나요?
발급 대행 시스템으로 발행하면 그 시스템이 국세청에 전송하고, 기한은 발급일 다음 날입니다. 우리 시스템은 상태 조회나 웹훅으로 전송 결과를 받아 두고, 실패 건을 다시 보내는 담당을 정해 둡니다.
개인사업자도 전자세금계산서를 꼭 발급해야 하나요?
직전 연도 사업장별 공급가액(면세 포함) 합계가 8천만원 이상이면 의무 발급 대상이고, 그 금액 이상인 해의 다음 해 제2기 과세기간이 시작하는 날부터 발급합니다. 기준에 못 미치는 사업자도 전자로 발급할 수 있습니다.
개발 중에 시험 발행은 어떻게 하나요?
테스트 환경을 두는 서비스라면 테스트용 인증서와 포인트를 신청해 즉시 발행 · 발행취소 · 수정 발행을 차례로 시험합니다. 시험이 끝나면 서비스가 정한 운영 전환 절차를 거쳐 실제 발행으로 바꿉니다.
오늘 할 일
지난달 발행한 세금계산서를 거래처별로 세어, 월합계로 묶을 수 있는 거래와 건마다 발행하는 거래를 나눠 적어 보세요.
이어서 읽기 — 정기결제 연동, 빌링키 흐름·실패·해지 규칙표



