2. 계좌 거래내역 수집
2.1. RequestJob - 수집 요청
-
계좌 거래내역을 확인하기 위해 팝빌에 수집요청을 합니다. (조회기간 단위 : 최대 1개월)
※ 조회일로부터 최대 3개월 이전 내역까지 조회할 수 있습니다.
easyFinBankService.requestJob(CorpNum, BankCode, AccountNumber, SDate, EDate, UserID, success, error)
- 반환 받은 작업아이디는 함수 호출 시점부터 1시간 동안 유효합니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
BankCode | string | 4 | Y |
은행 기관코드
|
|
AccountNumber | string | 30 | Y | 계좌번호 | |
SDate | string | 8 | Y |
조회 기간의 시작일자
형식 : yyyyMMdd
|
|
EDate | string | 8 | Y |
조회 기간의 종료일자
형식 : yyyyMMdd
|
|
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |
Return
string - 요청에 대한 작업아이디(JobID)
Throws
2.2. GetJobState - 수집 상태 확인
- [RequestJob - 수집 요청]를 통해 반환 받은 작업아이디의 상태를 확인합니다.
-
[Search – 거래 내역 조회] 또는 [Summary – 거래 요약 정보 조회]를 사용하기 전에 수집 작업의 진행 상태, 수집 작업의 성공 여부를 확인해야 합니다.
※ 작업 상태(jobState) = 3(완료), 수집 결과 코드(errorCode) = 1(수집성공)이면 거래 내역 조회 또는 거래 요약 정보 조회를 해야합니다.
easyFinBankService.getJobState(CorpNum, JobID, UserID, success, error)
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
JobID | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청]의 반환값
|
|
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |
Return
Throws
2.3. ListActiveJob - 수집 상태 목록 확인
- [RequestJob - 수집 요청]를 통해 반환 받은 작업아이디의 목록을 확인합니다.
- 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
easyFinBankService.listActiveJob(CorpNum, UserID, success, error)
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
UserID | string | 50 | N | 팝빌회원 아이디 | |
success | function | - | Y | 성공에 대한 콜백 함수 | |
error | function | - | Y | 실패에 대한 콜백 함수 |