정보확인

1. GetInfo - 상태 확인

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

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

def getInfo(CorpNum, MgtKeyType, MgtKey)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	str	24	Y	파트너가 할당한 문서번호

응답

TaxinvoiceInfo

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

예외

PopbillException

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

2. GetInfos - 다수건 상태 확인

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

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

def getInfos(CorpNum, MgtKeyType, MgtKeyList)

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKeyList	list	1,000	Y	문서번호 목록 → 최대 : 1,000건

응답

list[TaxinvoiceInfo]

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

예외

PopbillException

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

3. GetDetailInfo - 상세정보 확인

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

def getDetailInfo(CorpNum, MgtKeyType, MgtKey)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	str	24	Y	파트너가 할당한 문서번호

응답

Taxinvoice

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

예외

PopbillException

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

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

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

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

def checkMgtKeyInUse(CorpNum, MgtKeyType, MgtKey)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	str	24	Y	확인할 문서번호

응답

bool - True : (사용중) / False : (미사용중)

예외

PopbillException

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

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

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

def getXML(CorpNum, MgtKeyType, MgtKey)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	str	24	Y	파트너가 할당한 문서번호

응답

TaxinvoiceXML

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

예외

PopbillException

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

6. Search - 목록 조회

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

def search(CorpNum, MgtKeyType, DType, SDate, EDate, State, Type, TaxType, LateOnly, TaxRegIDYN, TaxRegIDType, TaxRegID, Page, PerPage, Order, UserID=None, QString=None, InterOPYN=None, IssueType=None, RegType=None, CloseDownState=None, MgtKey=None)

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

요청

Parameters

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

응답

TISearchResult

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

예외

PopbillException

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

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

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

def getLogs(CorpNum, MgtKeyType, MgtKey)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	MgtKeyType	str	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	MgtKey	str	24	Y	파트너가 할당한 문서번호

응답

list[TaxinvoiceLog]

순번	변수명	타입	길이	설명
1	docLogType	int	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	str	2000	이력정보
3	procType	str	3	처리형태 연동 API를 통해 처리함 일반 팝빌 사이트를 통해 처리함 시스템 팝빌이 처리함
4	procCorpName	str	70	처리회사명
5	procContactName	str	30	처리담당자
6	procMemo	str	200	처리메모
7	regDT	str	14	등록일시 → 형식 : yyyyMMddHHmmss
8	ip	str	39	아이피

예외

PopbillException

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

8. GetURL - 문서함 팝업 URL

미리보기

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

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

def getURL(CorpNum, UserID, ToGo)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	UserID	str	50	N	팝빌회원 아이디
3	ToGo	str	-	Y	접근 메뉴 (택 1) TBOX 임시 문서함 SWBOX 매출 발행 대기함 SBOX 매출 문서함 PWBOX 매입 발행 대기함 PBOX 매입 문서함 WRITE 정발행 작성

응답

str - 요청에 대한 응답 URL

예외

PopbillException

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