2. 내역 수집 결과 조회

2.1. Search - 수집 결과 조회

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

def search(corpNum, jobID, type, taxType, purposeType, taxRegIDType, taxRegIDYN, taxRegID, page, perPage, order, userID = '', searchString = '')

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

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
jobID	String	18	Y	작업 아이디 [RequestJob - 수집 요청]의 반환값
type	Array		N	세금계산서 문서형태 (다중 선택 가능) N세금계산서 M수정세금계산서 기본값 : 전체조회
taxType	Array		N	과세형태 (다중 선택 가능) T과세 N면세 Z영세 기본값 : 전체조회
purposeType	Array		N	영수/청구 (다중 선택 가능) R영수 C청구 N없음 기본값 : 전체조회
taxRegIDType	String	-	N	종사업장번호의 주체 S공급자 B공급받는자 T수탁자 기본값 : 전체조회
taxRegIDYN	String	1	N	종사업장번호 유무 0없음 1있음 기본값 : 전체조회
taxRegID	String	-	Y	종사업장번호 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 기본값 : 전체조회
page	Integer	-	N	목록 페이지번호 기본값 : 1
perPage	String	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
order	String	1	Y	목록 정렬 방향 D내림차순 : 기본값 A오름차순 [RequestJob - 수집 요청] 함수의 {DType}을 기준으로 하는 목록 정렬 방향
userID	String	50	N	팝빌회원 아이디
searchString	String	-	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회

Return

HTTaxinvoiceSearchResult

Throws

PopbillException

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

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

def summary(corpNum, jobID, type, taxType, purposeType, taxRegIDType, taxRegIDYN, taxRegID, userID = '', searchString = '')

Parameters

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

Return

HTTaxinvoiceSummary

Throws

PopbillException

2.3. GetTaxinvoice - 상세정보 확인 (JSON)

국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 반환합니다.

def getTaxinvoice(corpNum, ntsConfirmNum, userID = "")

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
ntsConfirmNum	String	24	Y	전자세금계산서 국세청승인번호
userID	String	50	N	팝빌회원 아이디

Return

HTTaxinvoice

Throws

PopbillException

2.4. GetXML - 상세정보 확인 (XML)

국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 XML 형태의 문자열로 반환합니다.

def getXML(corpNum, ntsConfirmNum, userID = "")

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
ntsConfirmNum	String	24	Y	전자세금계산서 국세청승인번호
userID	String	50	N	팝빌회원 아이디

Return

HTTaxinvoiceXMLResponse

Throws

PopbillException

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

수집된 전자세금계산서 1건의 상세내역을 확인하는 페이지의 팝업 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

def getPopUpURL(corpNum, ntsConfirmNum, userID ="")

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
ntsConfirmNum	String	24	Y	전자세금계산서 국세청승인번호
userID	String	50	N	팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

수집된 전자세금계산서 1건의 상세내역을 인쇄하는 페이지의 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

def getPrintURL(corpNum, ntsConfirmNum, userID ="")

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
ntsConfirmNum	String	24	Y	전자세금계산서 국세청승인번호
userID	String	50	N	팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException