2. 내역 수집 결과 조회

2.1. Search - 수집 결과 조회

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

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 - 수집 요청]의 반환값
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 - 수집 요청] 함수의 {DType}을 기준으로 하는 목록 정렬 방향
UserID	str	50	N	팝빌회원 아이디
SearchString	str	13	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회

Return

HTTaxinvoiceSearchResult

Throws

PopbillException

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

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

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

Parameters

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

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

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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

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

Parameters

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

Return

str - 요청에 대한 응답 URL

Throws

PopbillException