POPBill Developers
API Reference

2. 수집 내역 확인

2.2. Summary - 수집 내역 합계

홈택스에서 수집된 전자세금계산서 매입/매출 내역의 합계정보를 제공합니다. ※ 합계정보 - 수집 건수, 공급가액 합계, 세액 합계, 총계 (공급가액 합계+세액 합계)

Function Summary(CorpNum As String, jobID As String, tiType As Collection, taxType As Collection, purposeType As Collection, taxRegIDType As String, taxRegID As String, taxRegIDYN As String, Optional UserID As String = "", Optional SearchString As String = "") As PBHTTaxinvoiceSummary
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
jobID String 18 Y 작업아이디
tiType Collection N 세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
taxType Collection N 과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
purposeType Collection N 영수/청구 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
taxRegIDType String - N 종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
taxRegID String - Y 종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
taxRegIDYN String 1 N 종사업장번호 유무
0없음
1있음
기본값 : 전체조회
UserID String 50 N 팝빌회원 아이디
SearchString String 13 N 조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력
- 사업자 조회시 사업자번호 입력
- 개인 조회시 주민등록번호 입력
- 외국인 조회시 "9999999999999" 입력
기본값 : 전체조회
Return

PBHTTaxinvoiceSummary

Throws

Err

2.3. GetTaxinvoice - 수집 상세 확인

홈택스에서 수집된 전자세금계산서 1건의 상세정보를 제공합니다.

  • 60개 항목과 99개 품목으로 구성된 정보 확인이 가능합니다.
Function GetTaxinvoice(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As PBHTTaxinvoice
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
ntsconfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

PBHTTaxinvoice

Throws

Err

2.4. GetXML - 수집 상세 확인 (XML)

홈택스에서 수집된 전자세금계산서 1건의 상세정보를 XML 데이터 포맷으로 제공합니다.

Function GetXML(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As PBHTTaxinvoiceXML
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
ntsconfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

PBHTTaxinvoiceXML

Throws

Err

2.5. GetPopUpURL - 전자세금계산서 보기 팝업 URL

홈택스에서 수집된 전자세금계산서 1건을 확인하는 페이지 팝업 URL을 반환합니다.

  • 반환 받은 URL 정보는 30초 동안만 유효합니다.
Function GetPopUpURL(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As String
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
ntsconfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

Err

2.6. GetPrintURL - 전자세금계산서 인쇄 팝업 URL

홈택스에서 수집된 전자세금계산서 1건 출력하는 페이지 팝업 URL을 반환합니다.

  • 반환 받은 URL 정보는 30초 동안만 유효합니다.
Function GetPrintURL(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As String
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
ntsconfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

Err