API Reference 홈택스수집 Node.js 내역 수집

1. 내역 수집

1.1. RequestJob - 수집 요청

• 홈택스에 신고된 전자세금계산서 매입/매출 내역 수집을 팝빌에 요청합니다. (조회기간 단위 : 최대 3개월)

htTaxinvoiceService.requestJob(CorpNum, Type, DType, SDate, EDate, UserID, success, error)

• 주기적으로 자체 DB에 세금계산서 정보를 INSERT 하는 경우, {DType} 값을 "S"로 하는 것을 권장합니다.

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	Type	string	7	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	DType	string	1	Y	조회할 일자 유형 (택 1) W작성일자 I발행일자 S전송일자
	SDate	string	8	Y	조회 기간의 시작일자 형식 : yyyyMMdd
	EDate	string	8	Y	조회 기간의 종료일자 형식 : yyyyMMdd
	UserID	string	50	N	팝빌회원 아이디
	success	function	-	Y	성공에 대한 콜백 함수
	error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

1.2. GetJobState - 수집 상태 확인

• 함수 [RequestJob – 수집 요청]을 통해 반환 받은 작업 아이디의 상태를 확인합니다.
• [Search – 수집 결과 조회] 또는 [Summary – 수집결과 요약정보 조회]를 사용하기 전에 수집 작업의 진행 상태, 수집 작업의 성공 여부를 확인해야 합니다.

htTaxinvoiceService.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

HTTaxinvoiceJobState

Throws

PopbillException

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

• 전자세금계산서 매입/매출 내역 수집요청에 대한 상태 목록을 확인합니다.
• 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.

htTaxinvoiceService.listActiveJob(CorpNum, UserID, success, error)

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	UserID	string	50	N	팝빌회원 아이디
	success	function	-	Y	성공에 대한 콜백 함수
	error	function	-	Y	실패에 대한 콜백 함수

Return

HTTaxinvoiceJobState[ ]

Throws

PopbillException