1. 현금영수증 발행
1.1. RegistIssue - 즉시 발행
- 작성된 현금영수증 데이터를 팝빌에 저장과 동시에 발행하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
Function RegistIssue(CorpNum, ByRef Cashbill, Memo, UserID, EmailSubject)- 현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
- 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| Cashbill | Cashbill | - | Y | 현금영수증 객체정보 | |
| Memo | String | 200 | N | 현금영수증 상태 이력을 관리하기 위한 메모 | |
| UserID | String | 50 | N | 팝빌회원 아이디 | |
| EmailSubject | String | 300 | N |
현금영수증 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
|
Return
Throws
1.2. BulkSubmit - 초대량 발행 접수
- 최대 100건의 현금영수증 발행을 한번의 요청으로 접수합니다.
Function BulkSubmit(CorpNum, SubmitID, cashbillList, UserID)- 현금영수증 자진발급분은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
- 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| SubmitID | String | 36 | Y |
제출아이디
영문, 숫자, '-' 조합으로 구성
|
|
| cashbillList | Cashbill( ) | Y |
현금영수증 객체정보 목록
최대 : 100건
|
||
| UserID | String | 50 | N | 팝빌회원 아이디 | |
Return
Throws
1.3. GetBulkResult - 초대량 접수결과 확인
- 접수시 기재한 SubmitID를 사용하여 현금영수증 접수결과를 확인합니다.
- 개별 현금영수증 처리상태는 접수상태(txState)가 완료(2) 시 반환됩니다.
Function GetBulkResult(CorpNum, SubmitID, UserID)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| SubmitID | String | 36 | Y | 초대량 발행 접수시 기재한 제출아이디 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
1.4. Delete - 삭제
-
삭제 가능한 상태의 현금영수증을 삭제합니다.
※ 삭제 가능한 상태: "전송실패"
Function Delete(CorpNum, mgtKey, UserID)- 삭제처리된 현금영수증의 문서번호는 재사용이 가능합니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| mgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
1.5. RevokeRegistIssue - 전체취소 현금영수증 즉시 발행
- 당초 승인 현금영수증의 취소거래 발행 API 입니다.
- 작성된 취소 현금영수증 데이터를 팝빌에 저장과 동시에 발행하여 "발행완료" 상태로 처리합니다. [참고] 팝빌 국세청 전송 정책
- 부분 취소 현금영수증을 발행하는 경우 'IsPartCancel' 값을 true 로 설정하여 주시기 바랍니다.
- 당초 승인 현금영수증의 국세청승인번호와 거래일자는 [GetInfo – 상태확인]함수를 통해 확인 가능합니다.
Function RevokeRegistIssue(CorpNum, mgtKey, orgConfirmNum, orgTradeDate, smssendYN, memo, userID, emailSubject, tradeDT)
유의사항
- 당초 승인 현금영수증의 거래일시보다 과거의 거래일시를 입력할 수 없습니다.
- 취소 현금영수증의 거래금액의 합은 당초 승인 현금영수증의 거래금액을 넘을 수 없습니다.
- 취소 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| mgtKey | String | 24 | Y |
파트너가 할당한 문서번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
|
|
| orgConfirmNum | String | 9 | Y |
당초 승인 현금영수증의 국세청승인번호
CashbillInfo의 {confirmNum} 통해 내용 확인 가능
|
|
| orgTradeDate | String | 8 | Y |
당초 승인 현금영수증의 거래일자
CashbillInfo의 변수 'tradeDate'를 통해 내용 확인 가능
형식 : yyyyMMdd |
|
| smssendYN | boolean | - | Y |
현금영수증 발행시 알림문자 전송여부
True전송
False미전송 : 기본값
당초 승인 현금영수증의 구매자(고객)의 휴대폰번호 문자 전송
|
|
| memo | String | 200 | Y | 현금영수증 상태 이력을 관리하기 위한 메모 | |
| userID | String | 50 | N | 팝빌회원 아이디 | |
| emailSubject | String | 300 | N |
현금영수증 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
|
|
| tradeDT | String | 14 | N |
거래일시
전날부터 당일까지 입력 가능
형식 : yyyyMMddHHmmss 기본값 : 발행일시 사용
|
Return
Throws
1.6. RevokeRegistIssue_Part - 부분취소 현금영수증 즉시 발행
-
부분취소 현금영수증을 발행하며 취소 현금영수증의 금액은 당초 승인 현금영수증의 금액을 초과할 수 없습니다. [참고] 팝빌 국세청 전송 정책
※ 발행된 취소 현금영수증의 상태는 "발행완료" 입니다.
- 공급가액, 부가세, 봉사료, 거래금액은 취소할 금액을 넣습니다.
Function RevokeRegistIssue_Part(CorpNum, mgtKey, orgConfirmNum, orgTradeDate, smssendYN, memo, userID, isPartCancel, cancelType, supplyCost, tax, serviceFee, totalAmount, emailSubject, tradeDT)- 당초 승인 현금영수증의 국세청승인번호와 거래일자는 [GetInfo – 상태확인]함수를 통해 확인 가능합니다.
- 취소 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| mgtKey | String | 24 | Y |
파트너가 할당한 문서번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
|
|
| orgConfirmNum | String | 9 | Y |
당초 승인 현금영수증의 국세청승인번호
CashbillInfo의 {confirmNum} 통해 내용 확인 가능
|
|
| orgTradeDate | String | 8 | Y |
당초 승인 현금영수증의 거래일자
CashbillInfo의 변수 'tradeDate'를 통해 내용 확인 가능
형식 : yyyyMMdd |
|
| smssendYN | boolean | - | Y |
현금영수증 발행시 알림문자 전송여부
True전송
False미전송 : 기본값
당초 승인 현금영수증의 구매자(고객)의 휴대폰번호 문자 전송
|
|
| memo | String | 200 | Y | 현금영수증 상태 이력을 관리하기 위한 메모 | |
| userID | String | 50 | N | 팝빌회원 아이디 | |
| isPartCancel | boolean | - | N |
현금영수증 취소유형
True부분 취소
False전체 취소 : 기본값
|
|
| cancelType | Integer | 1 | Y |
현금영수증 취소사유
1거래취소 : 기본값
2오류발급취소
3기타
|
|
| supplyCost | String | 9 | Y | 부분 취소 공급가액 | |
| tax | String | 9 | Y | 부분 취소 부가세 | |
| serviceFee | String | 9 | Y | 부분 취소 봉사료 | |
| totalAmount | String | 9 | Y |
부분 취소 거래금액
거래금액 = 공급가액+부가세+봉사료
|