발행/전송

1. RegistIssue - 즉시 발행

작성된 세금계산서 데이터를 팝빌에 저장과 동시에 발행(전자서명)하여 “발행완료” 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책

• “발행완료”된 전자세금계산서는 국세청 전송 이전에 [CancelIssue – 발행취소] 함수로 국세청 신고 대상에서 제외할 수 있습니다.
• ※ [Register - 임시저장]과 [Issue - 발행] 함수 기능을 한 번의 프로세스로 처리합니다.

def registIssue(corpNum, taxinvoice, writeSpecification = false, forceIssue = false, dealInvoiceMgtKey = '', memo = '', emailSubject = '', userID = '')

세금계산서 발행을 위해서 공급자의 인증서가 팝빌 인증서버에 사전등록 되어야 합니다.
※ 위수탁의 경우, 수탁자의 인증서 등록이 필요합니다.
세금계산서 발행시 포인트가 과금되며, 공급받는자에게 발행 메일이 발송됩니다.

요청

Parameters

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

응답

IssueResponse

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	ntsConfirmNum	String	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당

예외

PopbillException

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

2. BulkSubmit - 초대량 발행 접수

최대 100건의 세금계산서 발행을 한번의 요청으로 접수합니다.

def bulkSubmit(corpNum, submitID, taxinvoiceList, forceIssue = false, userID = '')

세금계산서 발행을 위해서 공급자의 인증서가 팝빌 인증서버에 사전등록 되어야 합니다.
※ 위수탁의 경우, 수탁자의 인증서 등록이 필요합니다.
세금계산서 발행시 포인트가 과금되며, 공급받는자에게 발행 메일이 발송됩니다.

요청

Parameters

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

응답

BulkResponse

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	receiptID	String	36	접수아이디 → 접수 시점에 팝빌에서 자동으로 할당

예외

PopbillException

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

3. GetBulkResult - 초대량 접수결과 확인

접수시 기재한 SubmitID를 사용하여 세금계산서 접수결과를 확인합니다.

• txState(접수상태)가 2(완료)일 때, 개별 세금계산서 발행결과(성공/실패) 확인이 가능합니다.

def getBulkResult(corpNum, submitID, userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	submitID	String	36	Y	파트너가 할당한 제출아이디
3	userID	String	50	N	팝빌회원 아이디

응답

BulkTaxinvoiceResult

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	submitID	String	36	접수 시점에 고객사에서 할당한 제출아이디
4	submitCount	Integer	-	세금계산서 접수 건수
5	successCount	Integer	-	세금계산서 발행 성공 건수
6	failCount	Integer	-	세금계산서 발행 실패 건수
7	txState	Integer	1	접수상태 0 접수 1 처리중 2 처리완료
8	txResultCode	Integer	-	접수 결과코드 → 성공 : 1 실패 : 음의 정수 8자리 숫자값 [참고] 오류코드
9	txStartDT	String	14	발행처리 시작일시 → 형식 : yyyyMMddHHmmss
10	txEndDT	String	14	발행처리 완료일시 → 형식 : yyyyMMddHHmmss
11	receiptDT	String	14	접수일시 → 형식 : yyyyMMddHHmmss
12	receiptID	String	36	접수아이디 → 접수 시점에 팝빌에서 자동으로 할당
13	issueResult	BulkTaxinvoiceIssueResult[ ]	-	발행결과
BulkTaxinvoiceIssueResult[ ] 순번 변수명 타입 길이 설명 1 invoicerMgtKey String 24 공급자 문서번호 → 공급자의 문서 관리를 위해 파트너가 할당한 식별번호 2 trusteeMgtKey String 24 수탁자 문서번호 → 파트너가 할당한 문서번호 3 code Integer - API 처리에 대한 응답코드 → 성공 : 1 실패 : 음의 정수 8자리 숫자값 [참고] 오류코드 4 ntsconfirmNum String 24 국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당 5 issueDT String 14 발행일시 → 형식 : yyyyMMddHHmmss

예외

PopbillException

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

4. Register - 임시저장

작성된 세금계산서 데이터를 팝빌에 저장합니다.

• “임시저장” 상태의 세금계산서는 [Issue - 발행] 함수를 호출하여 “발행완료” 처리한 경우에만 국세청으로 전송됩니다.

def register(corpNum, taxinvoice, writeSpecification = false, userID = '')

세금계산서 파일첨부 기능을 구현하는 경우, [Register – 임시저장] → [AttachFile – 파일첨부] → [Issue – 발행] 함수를 차례로 호출합니다.
역발행 세금계산서를 저장하는 경우, 객체 Taxinvoice 의 변수 ‘chargeDirection’ 값을 통해 과금 주체를 지정할 수 있습니다.
※ 정과금: 공급자 과금, 역과금: 공급받는자 과금
임시저장된 세금계산서는 팝빌 사이트 ‘임시문서함’에서 확인 가능합니다.

요청

Parameters

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

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

5. Update - 수정

“임시저장” 상태의 세금계산서를 수정합니다.

def update(corpNum, mgtKeyType, mgtKey, taxinvoice, userID = '')

요청

Parameters

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

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

6. Issue - 발행

“임시저장” 또는 “(역)발행대기” 상태의 세금계산서를 발행(전자서명)하며, “발행완료” 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책

• “발행완료”된 전자세금계산서는 국세청 전송 이전에 [CancelIssue – 발행취소] 함수로 국세청 신고 대상에서 제외할 수 있습니다.

def issue(corpNum, mgtKeyType, mgtKey, forceIssue = false, memo = '', emailSubject = '', userID)

세금계산서 발행을 위해서 공급자의 인증서가 팝빌 인증서버에 사전등록 되어야 합니다.
※ 위수탁의 경우, 수탁자의 인증서 등록이 필요합니다.
세금계산서 발행시 포인트가 과금되며, 공급받는자에게 발행 메일이 발송됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	forceIssue	Boolean	-	N	지연발행 가능여부 true 가능 false 불가능 : 기본값
5	memo	String	200	N	세금계산서 상태 이력을 관리하기 위한 메모
6	emailSubject	String	300	N	세금계산서 발행 안내메일 제목 ※ 기본값 : 팝빌에서 설정한 안내메일 제목 사용
7	userID	String	50	N	팝빌회원 아이디

응답

IssueResponse

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지
3	ntsConfirmNum	String	24	국세청승인번호 → 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당

예외

PopbillException

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

7. CancelIssue - 발행취소

국세청 전송 이전 “발행완료” 상태의 전자세금계산서를 “발행취소”하고 국세청 신고대상에서 제외합니다.

def cancelIssue(corpNum, mgtKeyType, mgtKey, memo = '', userID = '')

[Delete – 삭제] 함수를 호출하여 “발행취소” 상태의 전자세금계산서를 삭제하면, 문서번호 재사용이 가능합니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서번호 유형 (택 1) SELL 매출 BUY 매입 TRUSTEE 위수탁
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	memo	String	200	N	세금계산서 상태 이력을 관리하기 위한 메모
5	userID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

8. RegistRequest - 역발행 즉시 요청

공급받는자가 작성한 세금계산서 데이터를 팝빌에 저장하고 공급자에게 송부하여 발행을 요청합니다.

• 역발행 요청된 세금계산서는 “(역)발행대기” 상태이며, 공급자가 팝빌 사이트 또는 함수를 호출하여 발행한 경우에만 국세청으로 전송됩니다.
• 공급자는 팝빌 사이트의 “매출 발행 대기함”에서 발행대기 상태의 역발행 세금계산서를 확인할 수 있습니다.
  ※ [Register – 임시저장]과 [Request – 역발행 요청]함수 기능을 한 번의 프로세스로 처리합니다.

def registRequest(corpNum, taxinvoice, memo = '', userID = '')

역발행 요청시 공급자에게 역발행 요청 메일이 발송됩니다.
공급자가 역발행 세금계산서 발행시 포인트가 과금되며, 객체 Taxinvoice 의 변수 ‘chargeDirection’ 값에 따라 과금 주체를 변경할 수 있습니다.
※ 정과금 : 공급자 과금, 역과금 : 공급받는자 과금

요청

Parameters

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

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

9. Request - 역발행 요청

공급받는자가 저장된 역발행 세금계산서를 공급자에게 송부하여 발행 요청합니다.

• 역발행 요청된 세금계산서는 “(역)발행대기” 상태이며, 공급자가 팝빌 사이트 또는 함수를 호출하여 발행한 경우에만 국세청으로 전송됩니다.
• 공급자는 팝빌 사이트의 “매출 발행 대기함”에서 발행대기 상태의 역발행 세금계산서를 확인할 수 있습니다.

def request(corpNum, mgtKeyType, mgtKey, memo = '', userID = '')

역발행 요청시 공급자에게 역발행 요청 메일이 발송됩니다.
공급자가 역발행 세금계산서 발행시 포인트가 과금됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서 번호 유형 → BUY(매입) 입력
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	memo	String	200	N	세금계산서 상태 이력을 관리하기 위한 메모
5	userID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

10. CancelRequest - 역발행 요청취소

공급자가 요청받은 역발행 세금계산서를 발행하기 전, 공급받는자가 역발행요청을 취소합니다.

• 함수 호출시 “취소” 상태로 변경되고, 해당 역발행 세금계산서는 공급자에 의해 발행 될 수 없습니다.

def cancelRequest(corpNum, mgtKeyType, mgtKey, memo = '', userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서 번호 유형 → BUY(매입) 입력
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	memo	String	200	N	세금계산서 상태 이력을 관리하기 위한 메모
5	userID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

11. Refuse - 역발행 요청거부

공급자가 공급받는자에게 역발행 요청 받은 세금계산서의 발행을 거부합니다.

def refuse(corpNum, mgtKeyType, mgtKey, memo = '', userID = '')

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	mgtKeyType	MgtKeyType	-	Y	문서 번호 유형 → SELL(매출) 입력
3	mgtKey	String	24	Y	파트너가 할당한 문서번호
4	memo	String	200	N	세금계산서 상태 이력을 관리하기 위한 메모
5	userID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

12. Delete - 삭제

삭제 가능한 상태의 세금계산서를 삭제합니다.
※ 삭제 가능한 상태: “임시저장”, “발행취소”, “역발행거부”, “역발행취소”, “전송실패”

def delete(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	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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

13. SendToNTS - 국세청 즉시 전송

“발행완료” 상태의 전자세금계산서를 국세청에 즉시 전송하며, 함수 호출 후 최대 30분 이내에 전송 처리가 완료됩니다.

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

함수 [GetInfo – 상태확인] 또는 Webhook을 통해 국세청 전송 결과를 확인 합니다.

요청

Parameters

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

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

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