3. 계좌 거래내역 조회
3.1. Search - 거래 내역 조회
- [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 계좌 거래 내역을 조회합니다.
easyFinBankService.search(CorpNum, JobID, TradeType, SearchString, Page, PerPage, Order, UserID, success, error)
- 페이지 정보(Page, PerPage, Order) 항목을 사용하여 거래내역 조회 목록 페이징 기능을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
JobID | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청]의 반환값
|
|
TradeType | Array | N |
거래유형 (다중선택 가능)
I입금
O출금
기본값 : 전체조회
|
||
SearchString | string | - | N |
조회 검색어
입·출금액입금 또는 출금 금액을 입력
메모[SaveMemo – 거래내역 메모저장]을 사용하여 저장한 값
비고EasyFinBankSearchDetail의 remark1,remark2,remark3
기본값 : 전체조회
|
|
Page | number | - | N |
목록 페이지번호
기본값 : 1
|
|
Perpage | number | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
Order | string | - | N |
거래일자를 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
|
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |
Return
Throws
3.2. Summary - 거래 내역 요약정보 조회
-
[GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 계좌 거래내역의 요약 정보를 조회합니다.
※ 요약 정보는 입·출 금액 합계, 입·출 거래 건수를 가리킵니다.
easyFinBankService.summary(CorpNum, JobID, TradeType, SearchString, UserID, success, error)
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
JobID | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청]의 반환값
|
|
TradeType | Array | N |
거래유형 (다중선택 가능)
I입금
O출금
기본값 : 전체조회
|
||
SearchString | string | - | N |
조회 검색어
입·출금액입금 또는 출금 금액을 입력
메모[SaveMemo – 거래내역 메모저장]을 사용하여 저장한 값
비고EasyFinBankSearchDetail의 remark1,remark2,remark3
기본값 : 전체조회
|
|
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |
Return
Throws
3.3. SaveMemo - 거래 내역 메모저장
- 한 건의 거래 내역에 메모를 저장합니다.
easyFinBankService.saveMemo(CorpNum, TID, Memo, UserID, success, error)
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
TID | string | 32 | Y |
메모를 저장할 거래내역 아이디
[Search - 거래 내역 조회]의 반환 값 EasyFinBankSearchDetail의 'tid'를 통해 확인 가능
|
|
Memo | string | 100 | Y | 거래 내역에 저장할 메모 | |
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |