2. 수집 내역 확인

2.1. Search - 수집 내역 확인

홈택스에서 수집된 전자세금계산서 매입/매출 내역을 확인합니다.

38개 항목으로 구성된 내역 확인이 가능합니다.

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 - 수집 요청] API의 반환값
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 - 수집 요청] API의 매개변수 {DType} 기준
userID	String	50	N	팝빌회원 아이디
searchString	String	-	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회

Return

HTTaxinvoiceSearchResult

Throws

PopbillException

2.2. Summary - 수집 내역 합계

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

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

Parameters

변수명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
jobID	String	18	Y	작업아이디 [RequestJob - 수집 요청] API의 반환값
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 - 수집 상세 확인

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

60개 항목과 99개 품목으로 구성된 정보 확인이 가능합니다.

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초 동안만 유효합니다.

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초 동안만 유효합니다.

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

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException