발행유형
전자세금계산서는 발행유형에 따라 정발행, 역발행, 위수탁발행으로 구분됩니다. 세금계산서 작성자와 발행자에 따른 발행유형을 선택하여 고객사 업무에 적합한 프로세스로 구현합니다.
1. 정발행
공급자가 세금계산서를 작성하고 공급자의 인증서로 전자서명하여 발행하는 유형입니다.
| 세금계산서 작성 | 전자서명(발행) | 팝빌 회원가입 | 안내메일 수신 |
| 공급자 | 공급자 | 공급자 | 공급받는자 |
전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서]
발행 프로세스
세금계산서 발행은 '임시저장'과 '발행' 단계로 구분됩니다. 프로그램 공급사는 각 단계의 처리방식에 따라 구별되는 2가지 프로세스 중 업무에 적합한 프로세스를 선택하여 구현합니다.
- 즉시 발행(권장) - 프로그램 공급사의 트랜잭션 편의성을 고려하여 임시저장과 발행을 동시에 처리 [RegistIssue - 즉시 발행]
-
임시저장 후 발행 - 임시저장과 발행 트랜잭션을 순차적으로 처리 [Register - 임시저장] → [Issue-발행]
※ 파일첨부 기능은 "임시저장 후 발행" 유형으로만 가능
문서번호 관리체계
문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다.
| 관리주체 | 유형 | 변수명 | 길이 | 설명 |
| 프로그램 공급사 | 공급자 문서번호 | invoicerMgtKey | 24 |
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능 |
| 팝빌 | 국세청승인번호 | ntsConfirmNum | 24 | 세금계산서 발행 시점에 팝빌에서 자동으로 할당 |
"국세청승인번호"는 국세청 신고를 위해 팝빌이 생성하고 할당한 세금계산서의 식별값(Unique Value) 입니다.
상태확인
팝빌에서 처리된 전자세금계산서 상태 확인을 위해 2가지 방법을 지원합니다.
- Webhook(Push) : 팝빌에서 상태가 변경된 시점에 실시간으로 프로그램 공급사가 지정한 Callback URL 서버로 이벤트 전달 [Webhook]
- API(Polling) : 프로그램 공급사가 주기적으로 API를 호출하여 상태 확인
2. 역발행
공급받는자가 세금계산서를 작성하여 공급자에게 이메일로 발행 요청하고, 공급자가 확인하여 세금계산서를 발행(전자서명)하는 유형입니다.
| 세금계산서 작성 | 전자서명(발행) | 팝빌 회원가입 | 안내메일 수신 |
| 공급받는자 | 공급자 | 공급자, 공급받는자 모두 | 역발행요청 – 공급자 발행안내 – 공급받는자 |
전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서]
- 역발행 요청된 세금계산서를 공급자가 발행(전자서명)하는 시점에 포인트가 차감됩니다.
- 과금방식은 'Taxinvoice' 객체의 'chargeDirection' 변수값 설정에 따라 공급자 포인트에서 과금(Default) 하거나, 공급받는자 포인트에서 역과금 가능합니다.
역발행 프로세스
역발행 세금계산서 요청은 '임시저장'과 '역발행 요청' 단계로 구분됩니다. 프로그램 공급사는 각 단계의 처리방식에 따라 구별되는 2가지 프로세스 중 업무에 적합한 프로세스를 선택하여 구현합니다.
- 즉시 요청(권장) – 프로그램 공급사의 트랜잭션 편의성을 고려하여 임시저장과 역발행 요청을 동시에 처리 [RegistRequest - 즉시 요청]
-
임시저장 후 요청 – 임시저장과 역발행 요청을 트랜잭션을 순차적으로 처리
[Regist - 임시저장] →
[Request - 역발행 요청]
※ 파일첨부 기능은 "임시저장 후 요청" 유형으로만 가능
문서번호 관리체계
문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다.
| 관리주체 | 유형 | 변수명 | 길이 | 설명 |
| 프로그램 공급사 | 공급받는자 문서번호 | invoiceeMgtKey | 24 |
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능 |
| 팝빌 | 국세청승인번호 | ntsConfirmNum | 24 | 세금계산서 발행 시점에 팝빌에서 자동으로 할당 |
"국세청승인번호"는 국세청 신고를 위해 팝빌이 생성하고 할당한 세금계산서의 식별값(Unique Value) 입니다.
상태확인
팝빌에서 처리된 전자세금계산서 상태 확인을 위해 2가지 방법을 지원합니다.
- Webhook(Push) : 팝빌에서 상태가 변경된 시점에 실시간으로 프로그램 공급사가 지정한 Callback URL 서버로 이벤트 전달 [Webhook]
- API(Polling) : 프로그램 공급사가 주기적으로 API를 호출하여 상태 확인
3. 위수탁
공급자로부터 세금계산서 발행 및 관리 권한을 위탁을 받은 수탁자가 세금계산서를 작성하여 발행(전자서명)하는 유형입니다.
| 세금계산서 작성 | 전자서명(발행) | 팝빌 회원가입 | 안내메일 수신 |
| 수탁자 | 수탁자 | 수탁자 | 공급자(위탁자), 공급받는자 |
전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서]
위수탁발행 프로세스
위수탁 세금계산서 발행은 '임시저장'과 '발행' 단계로 구분됩니다. 프로그램 공급사는 각 단계의 처리방식에 따라 구별되는 2가지 프로세스 중 업무에 적합한 프로세스를 선택하여 구현합니다.
- 즉시 발행(권장) - 프로그램 공급사의 트랜잭션 편의성을 고려하여 임시저장과 발행을 동시에 처리 [RegistIssue - 즉시 발행]
-
임시저장 후 발행 – 임시저장과 발행 트랜잭션을 순차적으로 처리
[Register - 임시저장] →
[Issue - 발행]
※ 파일첨부 기능은 "임시저장 후 발행" 유형으로만 가능
문서번호 관리체계
문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 생성하여 할당하는 고유번호 입니다.
| 관리주체 | 유형 | 변수명 | 길이 | 설명 |
| 프로그램 공급사 | 수탁자 문서번호 | trusteeMgtKey | 24 |
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능 |
| 팝빌 | 국세청승인번호 | ntsConfirmNum | 24 | 세금계산서 발행 시점에 팝빌에서 자동으로 할당 |
"국세청승인번호"는 국세청 신고를 위해 팝빌이 생성하고 할당한 세금계산서의 식별값(Unique Value) 입니다.
상태확인
팝빌에서 처리된 전자세금계산서 상태 확인을 위해 아래 2가지 방법을 지원합니다.
- Webhook(Push) : 팝빌에서 상태가 변경된 시점에 실시간으로 프로그램 공급사가 지정한 Callback URL 서버로 이벤트 전달 [Webhook]
- API(Polling) : 프로그램 공급사가 주기적으로 API를 호출하여 상태 확인
