2. 수집 내역 확인
2.1. Search - 수집 내역 확인
홈택스에서 수집된 현금영수증 매입/매출 내역을 확인합니다.
- 18개 항목으로 구성된 내역 확인이 가능합니다.
def search(corpNum, jobID, tradeType, tradeUsage, page, perPage, order, userID = '')- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| jobID | String | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
| tradeType | Array | Y |
현금영수증 문서형태 (다중 선택 가능)
N승인 현금영수증
C취소 현금영수증
기본값 : 전체조회
|
||
| tradeUsage | Array | Y |
현금영수증 거래구분 (다중 선택 가능)
P소득공제용
C지출증빙용
기본값 : 전체조회
|
||
| page | Integer | - | N |
목록 페이지번호
기본값 : 1
|
|
| perPage | Integer | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
| order | String | 1 | Y |
목록 정렬 방향
D내림차순 : 기본값
A오름차순
API를 호출하고 반환 받은 거래일시(tradeDT) 기준
|
|
| userID | String | 50 | N | 팝빌회원 아이디 | |
Return
Throws
2.2. Summary - 수집 내역 합계
홈택스에서 수집된 현금영수증 매입/매출 내역의 합계정보를 제공합니다. ※ 합계정보 - 수집 건수, 공급가액 합계, 세액 합계, 총계 (공급가액 합계+세액 합계)
def summary(corpNum, jobID, tradeType, tradeUsage, userID = '')Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| jobID | String | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
| tradeType | Array | Y |
현금영수증 문서형태 (다중 선택 가능)
N승인 현금영수증
C취소 현금영수증
기본값 : 전체조회
|
||
| tradeUsage | Array | Y |
현금영수증 거래구분 (다중 선택 가능)
P소득공제용
C지출증빙용
기본값 : 전체조회
|
||
| userID | String | 50 | N | 팝빌회원 아이디 | |