POPBill Developers
가이드

발행유형

세금계산서 프로세스는 작성 및 발행 주체에 따라 정발행/역발행/위수탁발행으로 구분되며, 각 프로세스의 작성자와 전자서명자의 팝빌 회원가입 및 전자서명자의 인증서 등록이 필수로 선행되어야 합니다.

1. 정발행

정발행이란 공급자가 세금계산서를 작성하여 공급자의 인증서로 전자서명하여 발행하는 유형입니다.

세금계산서 작성 전자서명 팝빌 회원가입 안내메일 수신
공급자 공급자 공급자 공급받는자

전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서] 상세보기

발행

팝빌 전자세금계산서 프로세스는 "임시저장"과 "발행" 단계로 구분됩니다.

  • 즉시 발행(권장) - 프로그램 공급사의 트랜잭션 처리 편리성을 고려하여 임시저장과 발행을 동시에 처리 [RegistIssue-즉시 발행]
  • 임시저장 후 발행 - 임시저장과 발행을 분리하여 단계적으로 처리 [Register-임시저장][Issue-발행]
    ※ 전자세금계산서 파일첨부 기능은 "임시저장 후 발행" 유형으로만 구현 가능

문서번호 관리체계

문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 구성하여 할당하는 고유번호 입니다.

관리주체 유형 변수명 길이 필수 비고
프로그램 공급사 공급자 문서번호 invoicerMgtKey 24 O 영문, 숫자, '-', '_' 이용 가능
팝빌 국세청 승인번호 ntsConfirmNum 24 O 전자세금계산서 발행과 동시에 생성

"국세청 승인번호"는 세금계산서의 국세청 신고를 위해 팝빌이 구성하여 할당하며, 세금계산서 식별 값으로 이용됩니다.

상태확인

팝빌에서 처리된 전자세금계산서 상태 확인을 위해 아래 2가지 방법을 지원합니다.

  • API(Polling) : 프로그램 공급사가 직접 API를 호출하여 수동으로 상태 확인
  • Webhook : 사전에 등록한 콜백 URL로 상태변경 이벤트 발생 시점에 팝빌 전달한 실시간 메시지를 수신하여 확인 [Webhook] 상세보기

2. 역발행

역발행이란 공급받는자가 세금계산서를 작성하여 공급자에게 이메일로 발행 요청하고, 공급자가 확인하여 세금계산서를 발행(전자서명)하는 유형입니다.

세금계산서 작성 전자서명 팝빌 회원가입 안내메일 수신
공급받는자 공급자 공급자, 공급받는자 모두 역발행요청 – 공급자
발행 – 공급받는자

전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서] 상세보기

역발행 세금계산서 과금
  • 역발행 요청된 세금계산서를 공급자가 발행(전자서명)하는 시점에 포인트가 차감됩니다.
  • 포인트 과금 주체는 객체 'Taxinvoice'의 변수 'chargeDirection' 값으로 공급자(정과금, 기본값) 또는 공급받는자(역과금)로 설정 가능합니다.

요청

팝빌 전자세금계산서 프로세스는 "임시저장"과 "역발행 요청" 단계로 구분됩니다.

  • 즉시 요청(권장) – 프로그램 공급사의 트랜잭션 처리 편리성을 고려하여 임시저장과 역발행 요청을 동시에 처리 [RegistRequest-즉시 요청]
  • 임시저장 후 요청 – 임시저장과 역발행 요청을 분리하여 단계적으로 처리 [Regist-임시저장][Request-역발행 요청]
    ※ 전자세금계산서 파일첨부 기능은 "임시저장 후 요청" 유형으로만 구현 가능

문서번호 관리체계

문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 구성하여 할당하는 고유번호 입니다.

관리주체 유형 변수명 길이 필수 비고
프로그램 공급사 공급받는자 문서번호 invoiceeMgtKey 24 O 영문, 숫자, '-', '_' 이용 가능
팝빌 국세청 승인번호 ntsConfirmNum 24 O 전자세금계산서 발행과 동시에 생성

"국세청 승인번호"는 세금계산서의 국세청 신고를 위해 팝빌이 구성하여 할당하며, 세금계산서 식별 값으로 이용됩니다.

상태확인

팝빌에서 처리된 전자세금계산서 상태 확인을 위해 아래 2가지 방법을 지원합니다.

  • API(Polling) : 프로그램 공급사가 직접 API를 호출하여 수동으로 상태 확인
  • Webhook : 사전에 등록한 콜백 URL로 상태변경 이벤트 발생 시점에 팝빌 전달한 실시간 메시지를 수신하여 확인 [Webhook] 상세보기

3. 위수탁

위수탁발행이란 공급자로부터 세금계산서 발행 및 관리 권한을 위탁을 받은 수탁자가 세금계산서를 작성하여 발행(전자서명)하는 유형입니다.

세금계산서 작성 전자서명 팝빌 회원가입 안내메일 수신
수탁자 수탁자 수탁자 공급자, 공급받는자

전자서명자는 사업자번호 기반으로 발급된 공동인증서를 팝빌에 사전 등록해야만 전자세금계산서 발행이 가능합니다. [공동인증서] 상세보기

발행

팝빌 전자세금계산서 프로세스는 "임시저장"과 "발행" 단계로 구분됩니다.

  • 즉시 발행(권장) - 프로그램 공급사의 트랜잭션 처리 편리성을 고려하여 임시저장과 발행을 동시에 처리 [RegistIssue-즉시 발행]
  • 임시저장 후 발행 – 임시저장과 발행을 분리하여 단계적으로 처리 [Register-임시저장][Issue-발행]
    ※ 전자세금계산서 파일첨부 기능은 "임시저장 후 요청" 유형으로만 구현 가능

문서번호 관리체계

문서번호란 전자세금계산서의 중복발행을 방지하고 내부 관리 목적으로 프로그램 공급사가 직접 구성하여 할당하는 고유번호 입니다.

관리주체 유형 변수명 길이 필수 비고
프로그램 공급사 수탁자 문서번호 trusteeMgtKey 24 O 영문, 숫자, '-', '_' 이용 가능
팝빌 국세청 승인번호 ntsConfirmNum 24 O 전자세금계산서 발행과 동시에 생성

"국세청 승인번호"는 세금계산서의 국세청 신고를 위해 팝빌이 구성하여 할당하며, 세금계산서 식별 값으로 이용됩니다.

상태확인

팝빌에서 처리된 전자세금계산서 상태 확인을 위해 아래 2가지 방법을 지원합니다.

  • API(Polling) : 프로그램 공급사가 직접 API를 호출하여 수동으로 상태 확인
  • Webhook : 사전에 등록한 콜백 URL로 상태변경 이벤트 발생 시점에 팝빌 전달한 실시간 메시지를 수신하여 확인 [Webhook] 상세보기