수집 내역 확인

1. Search - 수집 내역 확인

홈택스에서 수집된 현금영수증 매입/매출 내역을 확인합니다.

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

def search(CorpNum, JobID, TradeType, TradeUsage, Page, PerPage, Order, UserID=None)

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	`CorpNum`	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	`JobID`	str	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값
3	`TradeUsage`	list	-	N	현금영수증 거래구분 (다중 선택 가능) `P` 소득공제용 `C` 지출증빙용 기본값 : 전체조회
4	`TradeType`	list	-	N	현금영수증 문서형태 (다중 선택 가능) `N` 승인 현금영수증 `C` 취소 현금영수증 기본값 : 전체조회
5	`Page`	int	-	N	목록 페이지번호 기본값 : 1
6	`PerPage`	int	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
7	`Order`	str	1	N	목록 정렬 방향 `D` 내림차순 : 기본값 `A` 오름차순 API를 호출하고 반환 받은 거래일시(tradeDT) 기준
8	`UserID`	str	50	N	팝빌회원 아이디

응답

HTCashbillSearchResult

순번 변수명 타입 길이 설명

code

int

API 처리에 대한 응답코드

1 성공

message

str

API 처리에 대한 응답메시지

total

int

총 검색결과 건수

perPage

int

페이지당 목록 건수

pageNum

int

페이지 번호

pageCount

int

페이지 개수

list

1,000

현금영수증 정보

최대 : 1,000건

HTCashbill[]

순번	변수명	타입	길이	설명
1	`ntsconfirmNum`	str	24	국세청승인번호
2	`tradeDate`	str	8	거래일자 형식 : yyyyMMdd
3	`tradeDT`	str	14	거래일시 형식 : yyyyMMddHHmmss
4	`tradeType`	str	4	문서형태 `승인거래` `취소거래`
5	`tradeUsage`	str	5	거래구분 `소득공제용` `지출증빙용`
6	`totalAmount`	str	9	거래금액
7	`supplyCost`	str	9	공급가액
8	`tax`	str	9	부가세
9	`serviceFee`	str	9	봉사료
10	`invoiceType`	str	2	현금영수증 유형 `매입` `매출`
11	`franchiseCorpNum`	str	10	가맹점(발행자) 사업자번호 {invoiceType}="매입" 경우 반환
12	`franchiseCorpName`	str	200	가맹점(발행자) 상호 {invoiceType}="매입" 경우 반환
13	`franchiseCorpType`	str	1	가맹점(발행자) 사업자유형 `1` 일반과세자 `2` 간이과세자 `3` 과세특례자 `4` 면세사업자 `5` 법인사업자 {invoiceType}="매입" 경우 반환
14	`identityNum`	str	4	식별번호 식별번호의 마지막 4자리 숫자만 반환
15	`identityNumType`	str	1	식별번호 유형 `1` 주민등록번호 `2` 사업자번호 `3` 휴대폰번호 `4` 카드번호
16	`customerName`	str	70	구매자(고객) 성명
17	`cardOwnerName`	str	70	카드소유자명
18	`deductionType`	str	1	공제유형 `1` 공제 `2` 공제 `3` 불공제 `4` 불공제

예외

PopbillException

순번	변수명	타입	길이	설명
1	`code`	int	-	API 처리 실패에 대한 오류코드 음의 정수 8자리 숫자값 [참고] 오류코드
2	`message`	str	-	API 처리 실패에 대한 오류메시지

2. Summary - 수집 내역 합계

홈택스에서 수집된 현금영수증 매입/매출 내역의 합계정보를 제공합니다.
※ 합계정보 - 수집 건수, 공급가액 합계, 부가세 합계, 봉사료 합계, 거래금액 합계 (공급가액 합계+부가세 합계+봉사료 합계)

def summary(CorpNum, JobID, TradeType, TradeUsage, UserID=None)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	`CorpNum`	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	`JobID`	str	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값
3	`TradeType`	list	-	N	현금영수증 문서형태 (다중 선택 가능) `N` 승인 현금영수증 `C` 취소 현금영수증 기본값 : 전체조회
4	`TradeUsage`	list	-	N	현금영수증 거래구분 (다중 선택 가능) `P` 소득공제용 `C` 지출증빙용 기본값 : 전체조회
5	`UserID`	str	50	N	팝빌회원 아이디

응답

HTCashbillSummary

순번	변수명	타입	길이	설명
1	`count`	int	-	수집 건수
2	`supplyCostTotal`	int	18	공급가액 합계
3	`taxTotal`	int	18	부가세 합계
4	`serviceFeeTotal`	int	18	봉사료 합계
5	`amountTotal`	int	18	거래금액 합계 (공급가액 합계+부가세 합계+봉사료 합계)

예외

PopbillException

순번	변수명	타입	길이	설명
1	`code`	int	-	API 처리 실패에 대한 오류코드 음의 정수 8자리 숫자값 [참고] 오류코드
2	`message`	str	-	API 처리 실패에 대한 오류메시지