1. 내역 수집
1.1. RequestJob - 수집 요청
- 홈택스에 신고된 전자세금계산서 매입/매출 내역 수집을 팝빌에 요청합니다. (조회기간 단위 : 최대 3개월)
def requestJob(CorpNum, Type, DType, SDate, EDate, UserID=None):- 주기적으로 자체 DB에 세금계산서 정보를 INSERT 하는 경우, {DType} 값을 "S"로 하는 것을 권장합니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| Type | str | 7 | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| DType | str | 1 | Y |
조회할 일자 유형 (택 1)
W작성일자
I발행일자
S전송일자
|
|
| SDate | str | 8 | Y |
조회 기간의 시작일자
형식 : yyyyMMdd
|
|
| EDate | str | 8 | Y |
조회 기간의 종료일자
형식 : yyyyMMdd
|
|
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
str - 요청에 대한 작업아이디(JobID)
Throws
1.2. GetJobState - 수집 상태 확인
- 함수 [RequestJob – 수집 요청]을 통해 반환 받은 작업 아이디의 상태를 확인합니다.
- [Search – 수집 결과 조회] 또는 [Summary – 수집결과 요약정보 조회]를 사용하기 전에 수집 작업의 진행 상태, 수집 작업의 성공 여부를 확인해야 합니다.
def getJobState(CorpNum, JobID, UserID=None):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| JobID | str | 18 | Y |
작업 아이디
[RequestJob - 수집 요청]의 반환값
|
|
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
1.3. ListActiveJob - 수집 상태 목록 확인
- 전자세금계산서 매입/매출 내역 수집요청에 대한 상태 목록을 확인합니다.
- 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
def listActiveJob(CorpNum, UserID=None):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | str | 50 | N | 팝빌회원 아이디 |