2. 내역 수집 결과 조회

2.1. Search - 수집 결과 조회

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

Function Search(CorpNum As String, jobID As String, tiType As Collection, taxType As Collection, purposeType As Collection, taxRegIDType As String, taxRegID As String, taxRegIDYN As String, page As Integer, perPage As Integer, order As String, Optional UserID As String = "", Optional SearchString As String = "") As PBHTTaxinvoiceSearch

페이지 정보(Page, PerPage, Order) 항목을 사용하여 전자세금계산서 매입/매출 내역 조회 목록 페이징 기능을 구현할 수 있습니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
jobID	String	18	Y	작업 아이디 [RequestJob - 수집 요청]의 반환값
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있음 기본값 : 전체조회
page	Integer	-	N	목록 페이지번호 기본값 : 1
perPage	String	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
order	String	1	Y	목록 정렬 방향 D내림차순 : 기본값 A오름차순 [RequestJob - 수집 요청] 함수의 {DType}을 기준으로 하는 목록 정렬 방향
UserID	String	50	N	팝빌회원 아이디
SearchString	String	13	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회

Return

PBHTTaxinvoiceSearch

Throws

Err

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	작업 아이디 [RequestJob - 수집 요청]의 반환값
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