2. 계좌 거래내역 수집
2.1. RequestJob - 수집 요청
-
계좌 거래내역을 확인하기 위해 팝빌에 수집요청을 합니다. (조회기간 단위 : 최대 1개월)
※ 조회일로부터 최대 3개월 이전 내역까지 조회할 수 있습니다.
function string requestjob(string corpnum, string bankcode, string accountnumber, string sdate, string edate, string userid) throws popbillexception
- 반환 받은 작업아이디는 함수 호출 시점부터 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 | 팝빌회원 아이디 |
Return
string - 요청에 대한 작업아이디(JobID)
Throws
2.2. GetJobState - 수집 상태 확인
- [RequestJob - 수집 요청]를 통해 반환 받은 작업아이디의 상태를 확인합니다.
-
[Search – 거래 내역 조회] 또는 [Summary – 거래 요약 정보 조회]를 사용하기 전에 수집 작업의 진행 상태, 수집 작업의 성공 여부를 확인해야 합니다.
※ 작업 상태(jobState) = 3(완료), 수집 결과 코드(errorCode) = 1(수집성공)이면 거래 내역 조회 또는 거래 요약 정보 조회를 해야합니다.
function easyfinjobstate getjobstate(string corpnum, string jobid, string userid) throws popbillexception
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
corpnum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
jobid | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청]의 반환값
|
|
userid | string | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.3. ListActiveJob - 수집 상태 목록 확인
- [RequestJob - 수집 요청]를 통해 반환 받은 작업아이디의 목록을 확인합니다.
- 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
subroutine listactivejob(string corpnum, ref easyfinjobstate ref_returnlist[], string userid) throws popbillexception
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
corpnum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ref_returnlist | ref EasyFinJobState[ ] | Y | 서브루틴 반환 결과값 | ||
userid | string | 50 | N | 팝빌회원 아이디 |
Return
-