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