POPBill Developers
API Reference

2. 계좌 거래내역 수집 요청

2.1. RequestJob - 수집 요청

계좌 거래내역 수집을 팝빌에 요청합니다.

  • 최대 1개월 단위로 수집 요청이 가능하며, 조회일로부터 최대 3개월 이전 내역까지 조회가 가능합니다.
  • API를 호출하고 반환 받은 작업아이디(JobID)는 수집을 요청한 시점으로부터 1시간 동안만 유효합니다.
String RequestJob(String CorpNum, String BankCode, String AccountNumber, String SDate, String EDate, String UserID)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
BankCode String 4 Y 은행 기관코드
  • 0011농협
  • 0004국민은행
  • 0020우리은행
  • 0088신한은행
  • 0003기업은행
  • 0081하나은행
  • 0023SC은행
  • 0002산업은행
  • 0027씨티은행
  • 0031대구은행
  • 0032부산은행
  • 0039경남은행
  • 0034광주은행
  • 0037전북은행
  • 0035제주은행
  • 0071우체국
  • 0045새마을금고
  • 0048신협
  • 0007수협
AccountNumber String 30 Y 계좌번호
SDate String 8 Y 조회 기간의 시작일자
형식 : yyyyMMdd
EDate String 8 Y 조회 기간의 종료일자
형식 : yyyyMMdd
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 작업아이디(JobID)

Throws

PopbillException

2.2. GetJobState - 수집 상태 확인

[RequestJob - 수집 요청] API를 호출하고 반환 받은 작업아이디(JobID)를 이용하여 수집 상태를 확인합니다.

  • 수집 상태(jobState) = 3(완료)이면서, 수집 결과코드(errorCode) = 1(수집성공)인 경우 [Search - 수집 내역 확인] 이 가능합니다.
EasyFinBankJobState GetJobState(String CorpNum, String JobID, String UserID)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
JobID String 18 Y 작업아이디
UserID String 50 N 팝빌회원 아이디
Return

EasyFinBankJobState

Throws

PopbillException

2.3. ListActiveJob - 수집 상태 목록 확인

[RequestJob - 수집 요청] API를 호출하고 반환 받은 작업아이디(JobID) 목록의 수집 상태를 확인합니다.

List<EasyFinBankJobState> ListActiveJob(String CorpNum, String UserID)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
Return

List<EasyFinBankJobState>

Throws

PopbillException