수집 내역 확인

1. Search - 수집 내역 확인

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

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

HTCashbillSearchResult search(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType, Integer Page, Integer PerPage, String Order, String UserID) throws PopbillException

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

요청

Parameters

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

응답

HTCashbillSearchResult

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	total	long	-	총 검색결과 건수
4	perPage	long	-	페이지당 목록 건수
5	pageNum	long	-	페이지 번호
6	pageCount	long	-	페이지 개수
7	list	List<HTCashbill>	1,000	현금영수증 정보 → 최대 : 1,000건
List<HTCashbill> 순번 변수명 타입 길이 설명 1 ntsconfirmNum String 24 국세청승인번호 2 tradeDate String 8 거래일자 → 형식 : yyyyMMdd 3 tradeDT String 14 거래일시 → 형식 : yyyyMMddHHmmss 4 tradeType String 4 문서형태 승인거래 취소거래 5 tradeUsage String 5 거래구분 소득공제용 지출증빙용 6 totalAmount String 9 거래금액 7 supplyCost String 9 공급가액 8 tax String 9 부가세 9 serviceFee String 9 봉사료 10 invoiceType String 2 현금영수증 유형 매입 매출 11 franchiseCorpNum String 10 가맹점(발행자) 사업자번호 ✓ {invoiceType}="매입" 경우 반환 12 franchiseCorpName String 200 가맹점(발행자) 상호 ✓ {invoiceType}="매입" 경우 반환 13 franchiseCorpType String 1 가맹점(발행자) 사업자유형 1 일반과세자 2 간이과세자 3 과세특례자 4 면세사업자 5 법인사업자 ✓ {invoiceType}="매입" 경우 반환 14 identityNum String 4 식별번호 → 식별번호의 마지막 4자리 숫자만 반환 15 identityNumType String 1 식별번호 유형 1 주민등록번호 2 사업자번호 3 휴대폰번호 4 카드번호 16 customerName String 70 구매자(고객) 성명 17 cardOwnerName String 70 카드소유자명 18 deductionType String 1 공제유형 1 공제 2 공제 3 불공제 4 불공제

예외

PopbillException

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

2. Summary - 수집 내역 합계

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

HTCashbillSummary summary(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType, String UserID) throws PopbillException

요청

Parameters

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

응답

HTCashbillSummary

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

예외

PopbillException

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