수집 내역 확인

1. Search - 수집 내역 확인

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

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

function Search(CorpNum : String; JobID : String; TradeType : Array Of String; TradeUsage : Array Of String; Page : Integer; PerPage : Integer; Order : String; UserID : String) : THomeTaxCBSearchList;

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

요청

Parameters

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

응답

THomeTaxCBSearchList

순번 변수명 타입 길이 설명

code

Integer

API 처리에 대한 응답코드

1 성공

message

String

API 처리에 대한 응답메시지

total

Integer

총 검색결과 건수

perPage

Integer

페이지당 목록 건수

pageNum

Integer

페이지 번호

pageCount

Integer

페이지 개수

list

현금영수증 정보

최대 : 1,000건

THometaxCashbill

순번	변수명	타입	길이	설명
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`	Integer	1	가맹점(발행자) 사업자유형 `1` 일반과세자 `2` 간이과세자 `3` 과세특례자 `4` 면세사업자 `5` 법인사업자 {invoiceType}="매입" 경우 반환
14	`identityNum`	String	4	식별번호 식별번호의 마지막 4자리 숫자만 반환
15	`identityNumType`	Integer	1	식별번호 유형 `1` 주민등록번호 `2` 사업자번호 `3` 휴대폰번호 `4` 카드번호
16	`customerName`	String	70	구매자(고객) 성명
17	`cardOwnerName`	String	70	카드소유자명
18	`deductionType`	Integer	1	공제유형 `1` 공제 `2` 공제 `3` 불공제 `4` 불공제

예외

EPopbillException

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

2. Summary - 수집 내역 합계

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

function Summary(CorpNum : String; JobID : String; TradeType : Array Of String; TradeUsage : Array Of String; UserID : String) : TCashbillSummary;

요청

Parameters

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

응답

TCashbillSummary

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

예외

EPopbillException

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