정보확인

1. GetInfo - 상태 확인

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

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

def getInfo(corpNum, mgtKeyType, mgtKey, userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	userID	String	50	N	팝빌회원 아이디

응답

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	preIssueDT	String	14	발행예정일시 → 형식 : yyyyMMddHHmmss
12	openYN	Boolean	-	개봉 여부 true 개봉 false 미개봉 → {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
13	openDT	String	14	개봉일시 → 형식 : yyyyMMddHHmmss
14	stateMemo	String	200	상태메모
15	stateCode	Integer	3	상태코드 → [참고] 팝빌 상태코드
16	stateDT	String	14	상태 변경일시 → 형식 : yyyyMMddHHmmss
17	ntsconfirmNum	String	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
18	ntsresult	String	6	국세청 전송결과
19	ntssendDT	String	14	국세청 전송일시 → 형식 : yyyyMMddHHmmss
20	ntsresultDT	String	14	국세청 결과 수신일시 → 형식 : yyyyMMddHHmmss
21	ntssendErrCode	String	8	국세청 결과코드 → [참고] 국세청 결과코드
22	modifyCode	Integer	1	수정세금계산서 발행시 입력한 사유코드 → [참고] 수정세금계산서
23	interOPYN	Boolean	-	연동문서 여부 true API를 통해 발행한 연동문서 false 팝빌 사이트를 통해 발행한 문서
24	invoicerCorpName	String	200	공급자 상호
25	invoicerCorpNum	String	10	공급자 사업자번호
26	invoicerMgtKey	String	24	파트너가 팝빌에 세금계산서를 임시저장 또는 발행시 할당한 문서번호
27	invoicerPrintYN	Boolean	-	공급자 인쇄여부 true 인쇄 false 미인쇄
28	invoiceeCorpName	String	200	공급받는자 상호
29	invoiceeCorpNum	String	13	공급받는자 사업자번호
30	invoiceeMgtKey	String	24	파트너가 할당한 문서번호
31	invoiceePrintYN	Boolean	-	공급받는자 인쇄여부 true 인쇄 false 미인쇄
32	closeDownState	Integer	1	공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패
33	closeDownStateDate	String	8	공급받는자 휴폐업일자 → 형식 : yyyyMMdd
34	trusteeCorpName	String	200	수탁자 상호
35	trusteeCorpNum	String	10	수탁자 사업자번호
36	trusteeMgtKey	String	24	파트너가 할당한 문서번호
37	trusteePrintYN	Boolean	-	수탁자 인쇄여부 true 인쇄 false 미인쇄

예외

PopbillException

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

2. GetInfos - 다수건 상태 확인

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

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

def getInfos(corpNum, mgtKeyType, mgtKeyList, userID = '')

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKeyList	Array	1,000	Y	문서번호 목록 → 최대 : 1,000건
4	userID	String	50	N	팝빌회원 아이디

응답

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	preIssueDT	String	14	발행예정일시 → 형식 : yyyyMMddHHmmss
12	openYN	Boolean	-	개봉 여부 true 개봉 false 미개봉 → {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
13	openDT	String	14	개봉일시 → 형식 : yyyyMMddHHmmss
14	stateMemo	String	200	상태메모
15	stateCode	Integer	3	상태코드 → [참고] 팝빌 상태코드
16	stateDT	String	14	상태 변경일시 → 형식 : yyyyMMddHHmmss
17	ntsconfirmNum	String	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
18	ntsresult	String	6	국세청 전송결과
19	ntssendDT	String	14	국세청 전송일시 → 형식 : yyyyMMddHHmmss
20	ntsresultDT	String	14	국세청 결과 수신일시 → 형식 : yyyyMMddHHmmss
21	ntssendErrCode	String	8	국세청 결과코드 → [참고] 국세청 결과코드
22	modifyCode	Integer	1	수정세금계산서 발행시 입력한 사유코드 → [참고] 수정세금계산서
23	interOPYN	Boolean	-	연동문서 여부 true API를 통해 발행한 연동문서 false 팝빌 사이트를 통해 발행한 문서
24	invoicerCorpName	String	200	공급자 상호
25	invoicerCorpNum	String	10	공급자 사업자번호
26	invoicerMgtKey	String	24	파트너가 팝빌에 세금계산서를 임시저장 또는 발행시 할당한 문서번호
27	invoicerPrintYN	Boolean	-	공급자 인쇄여부 true 인쇄 false 미인쇄
28	invoiceeCorpName	String	200	공급받는자 상호
29	invoiceeCorpNum	String	13	공급받는자 사업자번호
30	invoiceeMgtKey	String	24	파트너가 할당한 문서번호
31	invoiceePrintYN	Boolean	-	공급받는자 인쇄여부 true 인쇄 false 미인쇄
32	closeDownState	Integer	1	공급받는자 휴폐업상태 null 미확인 0 미등록 1 사업중 2 폐업 3 휴업 4 확인실패
33	closeDownStateDate	String	8	공급받는자 휴폐업일자 → 형식 : yyyyMMdd
34	trusteeCorpName	String	200	수탁자 상호
35	trusteeCorpNum	String	10	수탁자 사업자번호
36	trusteeMgtKey	String	24	파트너가 할당한 문서번호
37	trusteePrintYN	Boolean	-	수탁자 인쇄여부 true 인쇄 false 미인쇄

예외

PopbillException

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

3. GetDetailInfo - 상세정보 확인

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

def getDetailInfo(corpNum, mgtKeyType, mgtKey, userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	userID	String	50	N	팝빌회원 아이디

응답

Taxinvoice

순번	변수명	타입	길이	설명
1	ntsconfirmNum	String	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
2	issueType	String	3	발행형태 정발행 역발행 위수탁
3	taxType	String	2	과세형태 과세 영세 면세
4	chargeDirection	String	3	과금방향 정과금 공급자 과금 역과금 공급받는자 과금
5	serialNum	String	30	일련번호
6	kwon	Integer	4	책번호 "권" 항목
7	ho	Integer	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	Integer	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	Integer	1	수정 사유코드 → 수정세금계산서 작성시 반환 [참고] 수정세금계산서
66	orgNTSConfirmNum	String	24	당초 국세청승인번호 → 수정세금계산서 작성시 반환
67	businessLicenseYN	Boolean	-	팝빌에 등록된 사업자등록증 첨부 여부 true 첨부 false 미첨부
68	bankBookYN	Boolean	-	팝빌에 등록된 통장사본 첨부 여부 true 첨부 false 미첨부
69	detailList	TaxinvoiceDetail[ ]	-	품목 상세정보 → 최대 : 99개
TaxinvoiceDetail[ ] 순번 변수명 타입 길이 설명 1 serialNum Integer 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	TaxinvoiceAddContact[ ]	-	공급받는자 추가담당자 정보 → 최대 : 5명
TaxinvoiceAddContact[ ] 순번 변수명 타입 길이 설명 1 serialNum Integer 1 일련번호 → 1부터 순차적으로 입력 최대 : 5 2 contactName String 100 담당자 성명 3 email String 100 메일

예외

PopbillException

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

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

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

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

def checkMgtKeyInUse(corpNum, mgtKeyType, mgtKey)

요청

Parameters

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

응답

Boolean - true : (사용중) / false : (미사용중)

예외

PopbillException

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

5. Search - 목록 조회

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

def search(corpNum, mgtKeyType, dType, sDate, eDate, state, type, taxType, lateOnly, taxRegIDYN, taxRegIDType, taxRegID, page, perPage, order, queryString, userID = '', interOPYN = '', issueType = [ ], regType = [ ], closeDownState = [ ], mgtKey = '')

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

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	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	String	-	N	지연발행 여부 1 지연발행 0 정상발행 ※ 기본값 : 전체조회
10	taxRegIDYN	String	1	N	종사업장번호 유무 0 없음 1 있음 ※ 기본값 : 전체조회
11	taxRegIDType	String	1	N	종사업장번호의 주체 (택 1) S 공급자 B 공급받는자 T 수탁자 ※ 기본값 : 전체조회
12	taxRegID	String	-	N	종사업장번호 → 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 ※ 기본값 : 전체조회
13	page	Integer	-	N	목록 페이지번호 ※ 기본값 : 1
14	perPage	Integer	-	N	페이지당 표시할 목록 건수 → 최대 : 1,000건 ※ 기본값 : 500건
15	order	String	1	Y	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D 내림차순 : 기본값 A 오름차순
16	queryString	String	-	N	조회 검색어 ('-' 제외) → 상호명 조회시 거래처상호 입력 사업자 조회시 사업자번호 입력 개인 조회시 주민등록번호 입력 외국인 조회시 "9999999999999" 입력 ※ 기본값 : 전체조회
17	userID	String	50	N	팝빌회원 아이디
18	interOPYN	String	1	N	세금계산서 작성유형 0 팝빌 사이트를 통해 작성한 세금계산서 1 API로 작성한 세금계산서 ※ 기본값 : 전체조회
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	문서번호 → 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 ※ 기본값 : 전체조회

응답

TISearchResult

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

예외

PopbillException

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

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

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

def getLogs(corpNum, mgtKeyType, mgtKey, userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	userID	String	50	N	팝빌회원 아이디

응답

TaxinvoiceLog[ ]

순번	변수명	타입	길이	설명
1	docLogType	Integer	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	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

7. GetURL - 문서함 팝업 URL

미리보기

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

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

def getURL(corpNum, togo, userID = "")

요청

Parameters

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

응답

String - 요청에 대한 응답 URL

예외

PopbillException

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