정보확인

1. GetInfo - 상태 확인

세금계산서 1건의 상태 및 요약정보를 확인합니다.

• 응답 객체 TaxinvoiceInfo 의 변수 ‘stateCode’를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

taxinvoiceService.getInfo(CorpNum, KeyType, MgtKey, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	string	24	Y	파트너가 할당한 문서번호
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

TaxinvoiceInfo

순번	변수명	타입	길이	설명
1	itemKey	string	18	팝빌에서 할당한 식별번호
2	taxType	string	2	과세형태 과세 영세 면세
3	writeDate	string	8	작성일자 → 형식 : yyyyMMdd
4	regDT	string	14	임시저장 일시 → 형식 : yyyyMMddHHmmss
5	issueType	string	3	발행형태 정발행 역발행 위수탁
6	supplyCostTotal	string	18	공급가액 합계
7	taxTotal	string	18	세액 합계
8	purposeType	string	2	영수/청구 영수 청구 없음
9	issueDT	string	14	발행일시 → 형식 : yyyyMMddHHmmss
10	lateIssueYN	boolean	-	지연발행 여부 true 지연발행 false 정상발행
11	openYN	boolean	-	개봉 여부 true 개봉 false 미개봉 → {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
12	openDT	string	14	개봉일시 → 형식 : yyyyMMddHHmmss
13	stateMemo	string	200	상태메모
14	stateCode	number	3	상태코드 → [참고] 팝빌 상태코드
15	stateDT	string	14	상태 변경일시 → 형식 : yyyyMMddHHmmss
16	ntsconfirmNum	string	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
17	ntsresult	string	6	국세청 전송결과
18	ntssendDT	string	14	국세청 전송일시 → 형식 : yyyyMMddHHmmss
19	ntsresultDT	string	14	국세청 결과 수신일시 → 형식 : yyyyMMddHHmmss
20	ntssendErrCode	string	6	국세청 결과코드 → [참고] 국세청 결과코드
21	modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 → [참고] 수정세금계산서
22	interOPYN	boolean	-	연동문서 여부 true API를 통해 발행한 연동문서 false 팝빌 사이트를 통해 발행한 문서
23	invoicerCorpName	string	200	공급자 상호
24	invoicerCorpNum	string	10	공급자 사업자번호
25	invoicerMgtKey	string	24	공급자 문서번호 → 공급자의 문서 관리를 위해 파트너가 할당한 식별번호
26	invoicerPrintYN	boolean	-	공급자 인쇄여부 true 인쇄 false 미인쇄
27	invoiceeCorpName	string	200	공급받는자 상호
28	invoiceeCorpNum	string	13	공급받는자 사업자번호
29	invoiceeMgtKey	string	24	공급받는자 문서번호 → 파트너가 할당한 문서번호
30	invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true 인쇄 false 미인쇄
31	closeDownState	number	1	공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패
32	closeDownStateDate	string	8	공급받는자 휴폐업일자 → 형식 : yyyyMMdd
33	trusteeCorpName	string	200	수탁자 상호
34	trusteeCorpNum	string	10	수탁자 사업자번호
35	trusteeMgtKey	string	24	수탁자 문서번호 → 파트너가 할당한 문서번호
36	trusteePrintYN	boolean	-	수탁자 인쇄여부 true 인쇄 false 미인쇄

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

2. GetInfos - 다수건 상태 확인

다수건의 세금계산서 상태 및 요약 정보를 확인합니다. (1회 호출에 최대 1,000건 확인 가능)

• 리턴값 TaxinvoiceInfo 의 변수 ‘stateCode’를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

taxinvoiceService.getInfos(CorpNum, KeyType, MgtKeyList, UserID, success, error)

문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKeyList	Array	1,000	Y	문서번호 목록 → 최대 : 1,000건
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

TaxinvoiceInfo[ ]

순번	변수명	타입	길이	설명
1	itemKey	string	18	팝빌에서 할당한 식별번호
2	taxType	string	2	과세형태 과세 영세 면세
3	writeDate	string	8	작성일자 → 형식 : yyyyMMdd
4	regDT	string	14	임시저장 일시 → 형식 : yyyyMMddHHmmss
5	issueType	string	3	발행형태 정발행 역발행 위수탁
6	supplyCostTotal	string	18	공급가액 합계
7	taxTotal	string	18	세액 합계
8	purposeType	string	2	영수/청구 영수 청구 없음
9	issueDT	string	14	발행일시 → 형식 : yyyyMMddHHmmss
10	lateIssueYN	boolean	-	지연발행 여부 true 지연발행 false 정상발행
11	openYN	boolean	-	개봉 여부 true 개봉 false 미개봉 → {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
12	openDT	string	14	개봉일시 → 형식 : yyyyMMddHHmmss
13	stateMemo	string	200	상태메모
14	stateCode	number	3	상태코드 → [참고] 팝빌 상태코드
15	stateDT	string	14	상태 변경일시 → 형식 : yyyyMMddHHmmss
16	ntsconfirmNum	string	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
17	ntsresult	string	6	국세청 전송결과
18	ntssendDT	string	14	국세청 전송일시 → 형식 : yyyyMMddHHmmss
19	ntsresultDT	string	14	국세청 결과 수신일시 → 형식 : yyyyMMddHHmmss
20	ntssendErrCode	string	6	국세청 결과코드 → [참고] 국세청 결과코드
21	modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 → [참고] 수정세금계산서
22	interOPYN	boolean	-	연동문서 여부 true API를 통해 발행한 연동문서 false 팝빌 사이트를 통해 발행한 문서
23	invoicerCorpName	string	200	공급자 상호
24	invoicerCorpNum	string	10	공급자 사업자번호
25	invoicerMgtKey	string	24	공급자 문서번호 → 공급자의 문서 관리를 위해 파트너가 할당한 식별번호
26	invoicerPrintYN	boolean	-	공급자 인쇄여부 true 인쇄 false 미인쇄
27	invoiceeCorpName	string	200	공급받는자 상호
28	invoiceeCorpNum	string	13	공급받는자 사업자번호
29	invoiceeMgtKey	string	24	공급받는자 문서번호 → 파트너가 할당한 문서번호
30	invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true 인쇄 false 미인쇄
31	closeDownState	number	1	공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패
32	closeDownStateDate	string	8	공급받는자 휴폐업일자 → 형식 : yyyyMMdd
33	trusteeCorpName	string	200	수탁자 상호
34	trusteeCorpNum	string	10	수탁자 사업자번호
35	trusteeMgtKey	string	24	수탁자 문서번호 → 파트너가 할당한 문서번호
36	trusteePrintYN	boolean	-	수탁자 인쇄여부 true 인쇄 false 미인쇄

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

3. GetDetailInfo - 상세정보 확인

세금계산서 1건의 상세정보를 확인합니다.

taxinvoiceService.getDetailInfo(CorpNum, KeyType, MgtKey, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	string	24	Y	파트너가 할당한 문서번호
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

Taxinvoice

순번	변수명	타입	길이	설명
1	ntsconfirmNum	string	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
2	issueType	string	3	발행형태 정발행 역발행 위수탁
3	taxType	string	2	과세형태 과세 영세 면세
4	chargeDirection	string	3	과금방향 정과금 공급자 과금 역과금 공급받는자 과금
5	serialNum	string	30	일련번호
6	kwon	number	4	책번호 "권" 항목
7	ho	number	4	책번호 "호" 항목
8	writeDate	string	8	작성일자 → 형식 : yyyyMMdd
9	purposeType	string	2	영수/청구 영수 청구 없음
10	supplyCostTotal	string	18	공급가액 합계
11	taxTotal	string	18	세액 합계
12	totalAmount	string	18	합계금액
13	cash	string	18	현금
14	chkBill	string	18	수표
15	credit	string	18	외상
16	note	string	18	어음
17	remark1	string	150	비고1 → {invoiceeType}="외국인" 경우 외국인등록번호 또는 여권번호 반환
18	remark2	string	150	비고2
19	remark3	string	150	비고3
20	invoicerMgtKey	string	24	공급자 문서번호 → 문서 관리를 위해 파트너가 할당하는 고유 식별번호
21	invoicerCorpNum	string	10	공급자 사업자번호 ('-' 제외)
22	invoicerTaxRegID	string	4	공급자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성
23	invoicerCorpName	string	200	공급자 상호
24	invoicerCEOName	string	100	공급자 대표자 성명
25	invoicerAddr	string	300	공급자 주소
26	invoicerBizType	string	100	공급자 업태
27	invoicerBizClass	string	100	공급자 종목
28	invoicerContactName	string	100	공급자 담당자 성명
29	invoicerDeptName	string	100	공급자 담당자 부서명
30	invoicerTEL	string	20	공급자 담당자 연락처
31	invoicerHP	string	20	공급자 담당자 휴대폰
32	invoicerEmail	string	100	공급자 담당자 메일
33	invoicerSMSSendYN	boolean	-	공급자 알림문자 전송 여부 true 전송 false 미전송 → 수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
34	invoiceeMgtKey	string	24	공급받는자 문서번호 → 문서 관리를 위해 파트너가 할당하는 고유 식별번호
35	invoiceeType	string	3	공급받는자 유형 사업자 개인 외국인
36	invoiceeCorpNum	string	13	공급받는자 등록번호 ('-' 제외) → {invoiceeType}="사업자" 경우 사업자번호 {invoiceeType}="개인" 경우 주민등록번호 {invoiceeType}="외국인" 경우 "9999999999999"
37	invoiceeTaxRegID	string	4	공급받는자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성
38	invoiceeCorpName	string	200	공급받는자 상호
39	invoiceeCEOName	string	100	공급받는자 대표자 성명
40	invoiceeAddr	string	300	공급받는자 주소
41	invoiceeBizType	string	100	공급받는자 업태
42	invoiceeBizClass	string	100	공급받는자 종목
43	closeDownState	number	1	공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패 → 세금계산서 발행시 거래처 사업자등록 상태를 조회하여 결과값 반환
44	closeDownStateDate	string	8	공급받는자 휴폐업일자 → 형식 : yyyyMMdd → {closeDownState}=2 or 3 경우 반환
45	invoiceeContactName1	string	100	공급받는자 담당자 성명
46	invoiceeDeptName1	string	100	공급받는자 담당자 부서명
47	invoiceeTEL1	string	20	공급받는자 담당자 연락처
48	invoiceeHP1	string	20	공급받는자 담당자 휴대폰
49	invoiceeEmail1	string	100	공급받는자 담당자 메일
50	invoiceeSMSSendYN	boolean	-	공급받는자 알림문자 전송 여부 true 전송 false 미전송 → 수신자 : 공급자 휴대폰번호 {invoicerHP}
51	trusteeMgtKey	string	24	수탁자 문서번호 → 수탁자의 문서 관리를 위해 파트너가 할당하는 식별번호
52	trusteeCorpNum	string	10	수탁자 사업자번호 ('-' 제외)
53	trusteeTaxRegID	string	4	수탁자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성
54	trusteeCorpName	string	200	수탁자 상호
55	trusteeCEOName	string	100	수탁자 대표자 성명
56	trusteeAddr	string	300	수탁자 주소
57	trusteeBizType	string	100	수탁자 업태
58	trusteeBizClass	string	100	수탁자 종목
59	trusteeContactName	string	100	수탁자 담당자 성명
60	trusteeDeptName	string	100	수탁자 담당자 부서명
61	trusteeTEL	string	20	수탁자 담당자 연락처
62	trusteeHP	string	20	수탁자 담당자 휴대폰
63	trusteeEmail	string	100	수탁자 담당자 메일
64	trusteeSMSSendYN	boolean	-	수탁자 알림문자 전송 여부 true 전송 false 미전송 → 수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
65	modifyCode	number	1	수정 사유코드 → 수정세금계산서 작성시 반환 [참고] 수정세금계산서
66	orgNTSConfirmNum	string	24	당초 국세청승인번호 → 수정세금계산서 작성시 반환
67	businessLicenseYN	boolean	-	팝빌에 등록된 사업자등록증 첨부 여부 true 첨부 false 미첨부
68	bankBookYN	boolean	-	팝빌에 등록된 통장사본 첨부 여부 true 첨부 false 미첨부
69	detailList	List<TaxinvoiceDetail>	99	품목 상세정보 → 최대 : 99개
List<TaxinvoiceDetail> 순번 변수명 타입 길이 설명 1 serialNum number 2 일련번호 → 1부터 순차적으로 입력 최대 : 99 2 purchaseDT string 8 거래일자 → 형식 : yyyyMMdd 3 itemName string 100 품명 4 spec string 60 규격 5 qty string 12 수량 → -99999999.99 ~ 999999999.99 소수점 아래 2번째 자리까지 입력 가능 6 unitCost string 18 단가 → -99999999999999.99 ~ 999999999999999.99 소수점 아래 2번째 자리까지 입력 가능 7 supplyCost string 18 공급가액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 자동 절사 8 tax string 18 세액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 자동 절사 9 remark string 100 비고
70	addContactList	List<TaxinvoiceAddContact>	5	공급받는자 추가담당자 정보 → 최대 : 5명
List<TaxinvoiceAddContact> 순번 변수명 타입 길이 설명 1 serialNum number 1 일련번호 → 1부터 순차적으로 입력 최대 : 5 2 contactName string 100 담당자 성명 3 email string 100 메일

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

4. CheckMgtKeyInUse - 문서번호 사용 여부 확인

파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.

• 이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.

taxinvoiceService.checkMgtKeyInUse(CorpNum, KeyType, MgtKey, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	string	24	Y	확인할 문서번호
4	success	function	-	Y	성공에 대한 콜백 함수
5	error	function	-	Y	실패에 대한 콜백 함수

응답

boolean > true : (사용중)

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

5. GetXML - 상세정보 확인 (XML)

세금계산서 1건의 상세정보를 XML로 반환합니다.

taxinvoiceService.getXML(CorpNum, KeyType, MgtKey, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	string	24	Y	파트너가 할당한 문서번호
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

TaxinvoiceXML

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지
3	retObject	string	-	전자세금계산서 XML 문서

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

6. Search - 목록 조회

검색조건에 해당하는 세금계산서를 조회합니다. (최대 조회기간 : 6개월)

taxinvoiceService.search(CorpNum, KeyType, DType, SDate, EDate, State, Type, TaxType, LateOnly, Order, Page, PerPage, TaxRegIDType, TaxRegIDYN, TaxRegID, QString, InterOPYN, UserID, IssueType, RegType, CloseDownState, MgtKey, success, error)

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	DType	string	1	Y	검색일자 유형 (택 1) R 등록일자 W 작성일자 I 발행일자
4	SDate	string	8	Y	검색 시작일자 → 형식 : yyyyMMdd
5	EDate	string	8	Y	검색 종료일자 → 형식 : yyyyMMdd
6	State	Array	-	N	세금계산서 상태코드 → 2, 3번째 자리에 와일드카드(*) 사용가능. 예) "3**", "60*" [참고] 팝빌 상태코드 ※ 기본값 : 전체조회
7	Type	Array	-	N	세금계산서 문서 유형 (다중 선택 가능) N 세금계산서 M 수정세금계산서 ※ 기본값 : 전체조회
8	TaxType	Array	-	N	과세형태 (다중 선택 가능) T 과세 N 면세 Z 영세 ※ 기본값 : 전체조회
9	LateOnly	boolean	-	N	지연발행 여부 true 지연발행 false 정상발행 ※ 기본값 : 전체조회
10	Order	string	1	N	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D 내림차순 : 기본값 A 오름차순
11	Page	number	-	N	목록 페이지번호 ※ 기본값 : 1
12	PerPage	number	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건
13	TaxRegIDType	string	1	N	종사업장번호의 주체 (택 1) S 공급자 B 공급받는자 T 수탁자 ※ 기본값 : 전체조회
14	TaxRegIDYN	string	1	N	종사업장번호 유무 0 없음 1 있음 ※ 기본값 : 전체조회
15	TaxRegID	string	-	N	종사업장번호 → 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 ※ 기본값 : 전체조회
16	QString	string	-	N	조회 검색어 ('-' 제외) → 상호명 조회시 거래처상호 입력 사업자 조회시 사업자번호 입력 개인 조회시 주민등록번호 입력 외국인 조회시 "9999999999999" 입력 ※ 기본값 : 전체조회
17	InterOPYN	string	1	N	세금계산서 작성유형 0 팝빌 사이트를 통해 작성한 세금계산서 1 API로 작성한 세금계산서 ※ 기본값 : 전체조회
18	UserID	string	50	N	팝빌회원 아이디
19	IssueType	Array	-	N	발행형태 (다중 선택 가능) N 정발행 R 역발행 T 위수탁 ※ 기본값 : 전체조회
20	RegType	Array	-	N	전자세금계산서 등록 유형 (다중 선택 가능) P 팝빌에서 등록(발행) H 홈택스 또는 ASP에서 등록(발행) ※ 기본값 : 전체조회
21	CloseDownState	Array	-	N	휴폐업상태 (다중 선택 가능) N 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패 ※ 기본값 : 전체조회
22	MgtKey	string	-	N	문서번호 → 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 ※ 기본값 : 전체조회
23	success	function	-	Y	성공에 대한 콜백 함수
24	error	function	-	Y	실패에 대한 콜백 함수

응답

TISearchResult

순번	변수명	타입	길이	설명
1	code	number	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지
3	total	number	-	총 검색결과 건수
4	perPage	number	-	페이지당 목록 건수
5	pageNum	number	-	페이지 번호
6	pageCount	number	-	페이지 개수
7	list	TaxinvoiceInfo[]	1,000	세금계산서 상태/요약정보 → 함수 [GetInfo – 상태 확인]의 리턴값 구성과 동일 최대 : 1,000건
TaxinvoiceInfo[] 순번 변수명 타입 길이 설명 1 itemKey string 18 팝빌에서 할당한 식별번호 2 taxType string 2 과세형태 과세 영세 면세 3 writeDate string 8 작성일자 → 형식 : yyyyMMdd 4 regDT string 14 임시저장 일시 → 형식 : yyyyMMddHHmmss 5 issueType string 3 발행형태 정발행 역발행 위수탁 6 supplyCostTotal string 18 공급가액 합계 7 taxTotal string 18 세액 합계 8 purposeType string 2 영수/청구 영수 청구 없음 9 issueDT string 14 발행일시 → 형식 : yyyyMMddHHmmss 10 lateIssueYN boolean - 지연발행 여부 true 지연발행 false 정상발행 11 openYN boolean - 개봉 여부 true 개봉 false 미개봉 → {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 12 openDT string 14 개봉일시 → 형식 : yyyyMMddHHmmss 13 stateMemo string 200 상태메모 14 stateCode number 3 상태코드 → [참고] 팝빌 상태코드 15 stateDT string 14 상태 변경일시 → 형식 : yyyyMMddHHmmss 16 ntsconfirmNum string 24 국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당 17 ntsresult string 6 국세청 전송결과 18 ntssendDT string 14 국세청 전송일시 → 형식 : yyyyMMddHHmmss 19 ntsresultDT string 14 국세청 결과 수신일시 → 형식 : yyyyMMddHHmmss 20 ntssendErrCode string 6 국세청 결과코드 → [참고] 국세청 결과코드 21 modifyCode number 1 수정세금계산서 발행시 입력한 사유코드 → [참고] 수정세금계산서 22 interOPYN boolean - 연동문서 여부 true API를 통해 발행한 연동문서 false 팝빌 사이트를 통해 발행한 문서 23 invoicerCorpName string 200 공급자 상호 24 invoicerCorpNum string 10 공급자 사업자번호 25 invoicerMgtKey string 24 공급자 문서번호 → 공급자의 문서 관리를 위해 파트너가 할당한 식별번호 26 invoicerPrintYN boolean - 공급자 인쇄여부 true 인쇄 false 미인쇄 27 invoiceeCorpName string 200 공급받는자 상호 28 invoiceeCorpNum string 13 공급받는자 사업자번호 29 invoiceeMgtKey string 24 공급받는자 문서번호 → 파트너가 할당한 문서번호 30 invoiceePrintYN boolean - 공급받는자 인쇄여부 true 인쇄 false 미인쇄 31 closeDownState number 1 공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패 32 closeDownStateDate string 8 공급받는자 휴폐업일자 → 형식 : yyyyMMdd 33 trusteeCorpName string 200 수탁자 상호 34 trusteeCorpNum string 10 수탁자 사업자번호 35 trusteeMgtKey string 24 수탁자 문서번호 → 파트너가 할당한 문서번호 36 trusteePrintYN boolean - 수탁자 인쇄여부 true 인쇄 false 미인쇄

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

7. GetLogs - 상태 변경이력 확인

세금계산서의 상태에 대한 변경이력을 확인합니다.

taxinvoiceService.getLogs(CorpNum, KeyType, MgtKey, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	KeyType	string	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	string	24	Y	파트너가 할당한 문서번호
4	UserID	string	50	N	팝빌회원 아이디
5	success	function	-	Y	성공에 대한 콜백 함수
6	error	function	-	Y	실패에 대한 콜백 함수

응답

TaxinvoiceLog[ ]

순번	변수명	타입	길이	설명
1	docLogType	number	3	로그타입 100 임시저장 101 수정 102 개봉 103 수신확인 111 메일 재전송 112 문자 재전송 113 팩스 재전송 122 문자 전송결과 123 팩스 전송결과 124 사업자등록상태 확인 125 문서번호 할당 220 역발행요청 221 역발행요청 거부 222 역발행요청 취소 230 발행 240 발행취소 250 국세청전송 요청 251 국세청전송 대기중 252 국세청전송 진행중 253 국세청전송 접수 254 국세청전송 성공 255 국세청전송 실패
2	log	string	2000	이력정보
3	procType	string	3	처리형태 연동 API를 통해 처리함 일반 팝빌 사이트를 통해 처리함 시스템 팝빌이 처리함
4	procCorpName	string	70	처리회사명
5	procContactName	string	30	처리담당자
6	procMemo	string	200	처리메모
7	regDT	string	14	등록일시 → 형식 : yyyyMMddHHmmss
8	ip	string	39	아이피

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

8. GetURL - 문서함 팝업 URL

미리보기

전자세금계산서 문서함의 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,280px (최소 1,000px) / height = 800px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL은 팝빌회원의 로그인 세션을 포함하고 있으니 사용에 유의하여 주시기 바랍니다.

taxinvoiceService.getURL(CorpNum, TOGO, UserID, success, error)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	TOGO	string	-	Y	접근 메뉴 (택 1) TBOX 임시 문서함 SWBOX 매출 발행 대기함 SBOX 매출 문서함 PWBOX 매입 발행 대기함 PBOX 매입 문서함 WRITE 정발행 작성
3	UserID	string	50	N	팝빌회원 아이디
4	success	function	-	Y	성공에 대한 콜백 함수
5	error	function	-	Y	실패에 대한 콜백 함수

응답

string - 요청에 대한 응답 URL

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	number	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지