계좌 거래내역 확인

1. Search - 수집 내역 확인

금융기관에서 수집된 계좌 거래내역을 확인합니다.

EasyFinBankSearchResult Search(String CorpNum, String JobID, String[] TradeType, String SearchString, int Page, int PerPage, String Order, String UserID)

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	`CorpNum`	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	`JobID`	String	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값
3	`TradeType`	String[ ]	-	N	거래유형 (다중선택 가능) `I` 입금 `O` 출금 기본값 : 전체조회
4	`SearchString`	String	-	N	조회 검색어 `입·출금액` 입금 또는 출금 금액을 입력 `거래 내역 메모` [SaveMemo – 거래 내역 메모저장] 을 사용하여 저장한 값 `비고` EasyFinBankSearchDetail의 변수 'remark1', 'remark2', 'remark3' 기본값 : 전체조회
5	`Page`	int	-	N	목록 페이지번호 기본값 : 1
6	`PerPage`	int	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
7	`Order`	String	-	N	목록 정렬 방향 `D` 내림차순 : 기본값 `A` 오름차순 API를 호출하고 반환 받은 거래일시(trdt) 기준
8	`UserID`	String	50	N	팝빌회원 아이디

응답

EasyFinBankSearchResult

순번 변수명 타입 길이 설명

code

long

API 처리에 대한 응답코드

1 성공

message

String

API 처리에 대한 응답 메시지

total

long

총 검색결과 건수

perPage

long

페이지 당 목록 건수

pageNum

long

페이지 번호

pageCount

long

페이지 개수

lastScrapDT

String

최종 조회일시

형식 : yyyyMMddHHmmss

balance

String

현재 잔액

list

1,000

거래내역 조회 목록

최대 : 1,000건

List<EasyFinBankSearchDetail>

순번	변수명	타입	길이	설명
1	`tid`	String	32	거래내역 아이디 거래 내역에 대해 팝빌이 할당한 고유 식별값
2	`trdate`	String	8	거래일자 형식 : yyyyMMdd
3	`trserial`	long?	-	거래일련번호 거래일자별 거래 내역 순번
4	`trdt`	String	14	거래일시 형식 : yyyyMMddHHmmss
5	`accIn`	String	20	입금액
6	`accOut`	String	20	출금액
7	`balance`	String	20	잔액
8	`remark1`	String	500	비고 1 {BankCode}="0003"(기업은행) 경우 받는분 계좌번호 {BankCode}="0004"(국민은행) 경우 내통장 표시내용
9	`remark2`	String	500	비고 2 은행별 제공 정보 다름(거래구분, 거래종류, 거래내용, 적요 등)
10	`remark3`	String	500	비고 3 은행별 제공 정보 다름(거래내용, 적요, 내역, 비고 등)
11	`remark4`	String	500	비고 4 은행별 제공 정보 다름(거래점, 취급점, 처리점 등)
12	`regDT`	String	14	등록일시 형식 : yyyyMMddHHmmss
13	`memo`	String	100	거래 내역 메모 [SaveMemo – 거래 내역 메모저장]을 사용하여 저장한 값

예외

PopbillException

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

2. Summary - 수집 내역 합계

금융기관에서 수집된 계좌 거래내역의 입금 및 출금 합계정보를 제공합니다.

EasyFinBankSummary Summary(String CorpNum, String JobID, String[] TradeType, String SearchString)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	`CorpNum`	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	`JobID`	String	18	Y	팝빌에서 할당한 작업아이디 [RequestJob - 수집 요청] API의 반환값
3	`TradeType`	String[ ]	-	N	거래유형 (다중선택 가능) `I` 입금 `O` 출금 기본값 : 전체조회
4	`SearchString`	String	-	N	조회 검색어 `입·출금액` 입금 또는 출금 금액을 입력 `거래 내역 메모` [SaveMemo – 거래 내역 메모저장] 을 사용하여 저장한 값 `비고` EasyFinBankSearchDetail의 변수 'remark1', 'remark2', 'remark3' 기본값 : 전체조회
5	`UserID`	String	50	N	팝빌회원 아이디

응답

EasyFinBankSummary

순번	변수명	타입	길이	설명
1	`count`	long?	-	수집 건수
2	`cntAccIn`	long?	-	입금거래 건수
3	`cntAccOut`	long?	-	출금거래 건수
4	`totalAccIn`	long?	-	입금액 합계
5	`totalAccOut`	long?	-	출금액 합계

예외

PopbillException

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

3. SaveMemo - 거래 내역 메모저장

한 건의 거래 내역에 메모를 저장합니다.

Response SaveMemo(String CorpNum, String TID, String Memo, String UserID)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	`CorpNum`	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	`TID`	String	32	Y	메모를 저장할 거래내역 아이디 [Search - 수집 내역 확인] API를 호출하고 반환 받은 거래내역 아이디(tid)
3	`Memo`	String	100	Y	거래내역에 저장할 메모
4	`UserID`	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	`code`	long	-	API 처리에 대한 응답코드 `1` 성공
2	`message`	String	-	API 처리에 대한 응답 메시지

예외

PopbillException

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