2. 수집 내역 확인

2.1. Search - 수집 내역 확인

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

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

function httaxinvoicesearch search(string corpnum, string jobid, string titype[ ], string taxtype[ ], string purposetype[ ], string taxregidyn, string taxregidtype, string taxregid, int page, int perpage, string order, string userid, string searchstring) throws popbillexception

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

Parameters

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

Return

HTTaxinvoiceSearch

Throws

PopbillException

2.2. Summary - 수집 내역 합계

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

function httaxinvoicesummary summary(string corpnum, string jobid, string titype[ ], string taxtype[ ], string purposetype[ ], string taxregidyn, string taxregidtype, string taxregid, string userid, string searchstring) throws popbillexception

Parameters

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

Return

HTTaxinvoiceSummary

Throws

PopbillException

2.3. GetTaxinvoice - 수집 상세 확인

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

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

function httaxinvoice gettaxinvoice(string corpnum, string ntsconfirmnum, string userid) throws popbillexception

Parameters

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

Return

HTTaxinvoice

Throws

PopbillException

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

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

function httaxinvoicexml getxml(string corpnum, string ntsconfirmnum, string userid) throws popbillexception

Parameters

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

Return

HTTaxinvoiceXML

Throws

PopbillException

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

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

반환 받은 URL 정보는 30초 동안만 유효합니다.

function string getpopupurl(string corpnum, string ntsconfirmnum, string userid) throws popbillexception

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

function string getprinturl(string corpnum, string ntsconfirmnum, string userid) throws popbillexception

Parameters

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

Return

string - 요청에 대한 응답 URL

Throws

PopbillException