계좌 거래내역 확인

1. Search - 수집 내역 확인

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

Function Search(CorpNum As String, jobID As String, TradeType As Collection, SearchString As String, page As Integer, perPage As Integer, order As String, Optional UserID As String = "") As PBEasyFinBankSearch

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

요청

Parameters

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

응답

PBEasyFinBankSearch

순번	변수명	타입	길이	설명
1	code	Long	-	API 처리에 대한 응답코드 1 성공
2	Message	String	-	API 처리에 대한 응답 메시지
3	total	Integer	-	총 검색결과 건수
4	perPage	Integer	-	페이지 당 목록 건수
5	pageNum	Integer	-	페이지 번호
6	pageCount	Integer	-	페이지 개수
7	lastScrapDT	String	14	최종 조회일시 → 형식 : yyyyMMddHHmmss
8	list	PBEasyFinBankSearchDetail	-	거래내역 조회 목록 → 최대 : 1,000건
PBEasyFinBankSearchDetail 순번 변수명 타입 길이 설명 1 tid String 32 거래내역 아이디 → 거래 내역에 대해 팝빌이 할당한 고유 식별값 2 trdate String 8 거래일자 → 형식 : yyyyMMdd 3 trserial Integer - 거래일련번호 → 거래일자별 거래 내역 순번 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 – 거래 내역 메모저장]을 사용하여 저장한 값

예외

Err

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

2. Summary - 수집 내역 합계

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

Function Summary(CorpNum As String, jobID As String, TradeType As Collection, SearchString As String, Optional UserID As String = "") As PBEasyFinBankSummary

요청

Parameters

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

응답

PBEasyFinBankSummary

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

예외

Err

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

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

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

Function SaveMemo(CorpNum As String, TID As String, Memo As String, Optional UserID As String = "") As PBResponse

요청

Parameters

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

응답

PBResponse

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

예외

Err

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