수집 내역 확인

1. Search - 수집 내역 확인

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

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

htCashbillService.search(CorpNum, JobID, TradeType, TradeUsage, Page, PerPage, Order, UserID, success, error)

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

요청

Parameters

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

응답

HTCashbillSearchResult

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지
3	total	number	-	총 검색결과 건수
4	perPage	number	-	페이지당 목록 건수
5	pageNum	number	-	페이지 번호
6	pageCount	number	-	페이지 개수
7	list	HTCashbill[]	1,000	현금영수증 정보 → 최대 : 1,000건
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	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

2. Summary - 수집 내역 합계

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

htCashbillService.summary(CorpNum, JobID, TradeType, TradeUsage, UserID, success, error)

요청

Parameters

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

응답

HTCashbillSummary

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

예외

PopbillException

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