수집 내역 확인

1. Search - 수집 내역 확인

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

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

Function Search(CorpNum As String, jobID As String, tradeType As Collection, tradeUsage As Collection, page As Integer, perPage As Integer, order As String, Optional UserID As String = "") As PBHTCashbillSearch

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

요청

Parameters

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

응답

PBHTCashbillSearch

순번	변수명	타입	길이	설명
1	code	Long	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	total	Integer	-	총 검색결과 건수
4	perPage	Integer	-	페이지당 목록 건수
5	pageNum	Integer	-	페이지 번호
6	pageCount	Integer	-	페이지 개수
7	list	PBHTCashbill[ ]	-	현금영수증 정보 → 최대 : 1,000건
PBHTCashbill[ ] 순번 변수명 타입 길이 설명 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 불공제

예외

Err

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

2. Summary - 수집 내역 합계

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

Function Summary(CorpNum As String, jobID As String, tradeType As Collection, tradeUsage As Collection, Optional UserID As String = "") As PBHTCashbillSummary

요청

Parameters

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

응답

PBHTCashbillSummary

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

예외

Err

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