2. 수집 내역 확인

2.1. Search - 수집 내역 확인

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

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

def search(CorpNum, JobID, Type, TaxType, PurposeType, TaxRegIDType, TaxRegIDYN, TaxRegID, Page, PerPage, Order, UserID=None, SearchString=None):

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

Parameters

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

Return

HTTaxinvoiceSearchResult

Throws

PopbillException

2.2. Summary - 수집 내역 합계

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

def summary(CorpNum, JobID, Type, TaxType, PurposeType, TaxRegIDType, TaxRegIDYN, TaxRegID, UserID=None, SearchString=None):

Parameters

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

Return

HTTaxinvoiceSummary

Throws

PopbillException

2.3. GetTaxinvoice - 수집 상세 확인

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

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

def getTaxinvoice(CorpNum, NTSConfirmNum, UserID=None):

Parameters

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

Return

HTTaxinvoice

Throws

PopbillException

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

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

def getXML(CorpNum, NTSConfirmNum, UserID=None):

Parameters

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

Return

HTTaxinvoiceXMLResponse

Throws

PopbillException

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

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

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

def getPopUpURL(CorpNum, NTSConfirmNum, UserID=None):

Parameters

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

Return

str - 요청에 대한 응답 URL

Throws

PopbillException

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

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

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

def getPrintURL(CorpNum, NTSConfirmNum, UserID=None):

Parameters

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

Return

str - 요청에 대한 응답 URL

Throws

PopbillException