수집
프로그램 공급사가 직접 API 호출하여 국세청 홈택스에 신고된 전자세금계산서 매입/매출 내역을 수집하는 "API(Polling)" 방식과 팝빌이 업데이트된 데이터를 수집하여 프로그램 공급사가 등록한 콜백 URL에 1시간(정시) 간격으로 자동 전달하는 "Webhook(Push)" 방식을 제공합니다.
"Webhook(Push)" 방식을 이용하는 프로그램 공급사는 "부서사용자" 인증방식이 필수사항 입니다. [인증관리]
-
팝빌이 업데이트된 데이터를 수집하여 등록된 콜백 URL에 1시간(정시) 간격으로 자동으로 전달합니다. [Webhook]
-
프로그램 공급사가 직접 API 호출하여 국세청 홈택스에 신고된 전자세금계산서 매입/매출 내역을 수집을 요청하고, 팝빌이 수집 완료한 내역을 Polling 방식으로 수동 확인합니다.
-
1. 수집 요청 [RequestJob API]
- 팝빌에 홈택스 매입/매출 내역 수집을 요청합니다. (*인증정보가 완료된 상태에서만 정상 응답이 반환됩니다.)
- 리턴값 'JobID'(작업아이디)로 수집 작업의 상태를 확인 할 수 있습니다. (*JobID는 함수 호출 시점부터 1시간 동안 유효합니다.)
-
2. 상태 확인 [GetJobState API]
- JobID(작업아이디)로 팝빌 수집 작업의 진행 상태(접수/대기/진행/완료)와 성공 여부(성공/실패)를 확인합니다.
- 진행 상태가 '완료'이고, 성공 여부가 '성공'인 상태에서만 수집된 정보 확인이 가능합니다.
-
3. 수집결과 조회 [Search, Summary API]
- 수집내역의 상세정보(Search) 또는 요약정보(Summary)를 확인합니다.
-
1. 수집 요청 [RequestJob API]