POPBill Developers
API Reference

2. 내역 수집 결과 조회

2.2. Summary - 수집결과 요약정보 조회

  • 함수 [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 수집된 전자세금계산서 매입/매출 내역의 요약 정보를 조회합니다.

    ※ 요약정보: 전자세금계산서 수집 건수, 공급가액 합계, 세액 합계, 합계 금액

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 - 상세정보 확인 (JSON)

  • 국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 반환합니다.
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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
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