Index

1. 현금영수증 발행

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

ㆍ현금영수증 문서번호 사용여부를 확인합니다.

ㆍ문서번호란 현금영수증을 고유하게 구별하기 위해 부여하는 값으로 파트너가 할당하는 기본키(Primary Key) 역할을 합니다.

function CheckMgtKeyInUse(CorpNum : String; MgtKey : String) : boolean

개발 유의사항
ㆍ사용중인 문서번호는 새로운 현금영수증 발행(Issue) 또는 임시저장(Register)시 할당이 불가합니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호

Return

boolean - true(사용중) / false(미사용중)

Throws

EPopbillException

1.2. RegistIssue - 즉시 발행

ㆍ현금영수증을 즉시 발행하며 현금영수증의 상태값이 '발행완료'가 됩니다.

'발행완료' 상태의 현금영수증은 국세청 전송 정책에 따라 국세청에 전송됩니다.

function RegistIssue(CorpNum : String; Cashbill : TCashbill; Memo : String; UserID : String = ''; EmailSubject : String = '') : TResponse;

개발 유의사항
ㆍ현금영수증의 거래일자는 즉시 발행(RegistIssue) 함수로 발행한 날짜이며 수정이 불가합니다.
ㆍ현금영수증 자진발급만 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
ㆍ현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
ㆍ팝빌 개발환경에서 발행한 현금영수증은 실제로 국세청에 전송되지 않고 가상으로 전송처리됩니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 Cashbill TCashbill - O 현금영수증 객체정보
3 Memo String 200 - 발행시 남길 수 있는 메모, 상태확인(GetInfo)를 통해 stateMemo(상태메모) 확인 가능
4 UserID String 50 - 팝빌회원 아이디
5 EmailSubject String 300 - 현금영수증 발행시 구매자에게 발송되는 메일 제목, 미기재 시 팝빌에서 지정한 이메일 제목으로 전송

Return

TResponse

Throws

EPopbillException

1.3. Register - 임시저장

ㆍ팝빌에 현금영수증을 임시저장합니다. '임시저장' 상태의 현금영수증은 국세청에 전송되지 않습니다.

function Register(CorpNum : String; Cashbill : TCashbill; UserID : String = '') : TResponse

개발 유의사항
ㆍ현금영수증 자진발급은 소득공제 용도로만 발행 가능합니다. (자진발급 번호 : 010-000-1234)
ㆍ'임시저장' 상태의 현금영수증을 발행(Issue)하면 '발행완료' 상태가 됩니다.
ㆍ'발행완료' 상태의 현금영수증만이 국세청 전송 대상입니다. 국세청 전송 정책 보기
ㆍ임시저장(Register)과 발행(Issue)을 하나의 함수로 처리할 수 있는 즉시 발행(RegistIssue) 함수 사용을 권장합니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 Cashbill TCashbill - O 현금영수증 객체정보
3 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

1.4. Update - 수정

'임시저장' 상태인 현금영수증 기재사항을 수정합니다.

function Update(CorpNum : String; MgtKey : String; Cashbill : TCashbill; UserID : String = '') : TResponse

개발 유의사항
ㆍ'임시저장' 상태가 아닌 현금영수증은 수정(Update)을 사용할 수 없습니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Cashbill TCashbill - O 현금영수증 객체정보
4 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

1.5. Issue - 발행

ㆍ'임시저장' 상태의 현금영수증을 발행하며, 발행된 현금영수증의 상태값이 '발행완료'가 됩니다.

function Issue(CorpNum : String; MgtKey : String; Memo : String; UserID : String = '') : TResponse

개발 유의사항
ㆍ현금영수증의 거래일자는 발행(Issue) 함수로 현금영수증을 발행한 날짜이고 수정이 불가합니다.
ㆍ'임시저장' 상태가 아닌 현금영수증은 발행(Isssue)을 사용할 수 없습니다.
ㆍ'발행완료' 상태의 현금영수증은 국세청 전송 정책에 따라 국세청에 전송됩니다. 국세청 전송 정책 보기

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Memo String 200 - 발행시 남길 수 있는 메모, 상태확인(GetInfo) stateMemo(상태메모) 확인 가능
4 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

1.6. CancelIssue - 발행취소

'발행완료' 상태의 현금영수증을 발행취소하며 국세청 전송 대상에서 제외됩니다.

ㆍ국세청 '전송중', '전송성공' 상태의 현금영수증은 발행취소 할 수 없습니다.

function CancelIssue(CorpNum : String; MgtKey : String; Memo : String; UserID : String = '') : TResponse

'전송성공' 상태의 현금영수증은 취소 현금영수증을 발행하여 취소 할 수 있습니다. [참고] 취소 현금영수증 발행 보기

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Memo String 200 - 메모, 상태확인(GetInfo) stateMemo(상태메모) 확인 가능
4 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

1.7. Delete - 삭제

'임시저장', '발행취소', '전송실패' 상태의 현금영수증을 삭제합니다.

function Delete(CorpNum : String; MgtKey : String; UserID : String = '') : TResponse

ㆍ삭제한 현금영수증에 사용된 문서번호(mgtKey)는 재사용 할 수 있습니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

1.8. 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 = '') : TResponse

개발 유의사항
ㆍ원본 현금영수증의 국세청 승인번호 및 거래일자는 상태확인(GetInfo)함수를 통해 확인 가능합니다.
ㆍ취소 현금영수증 발행시 구매자 메일주소로 발행 안내 메일이 전송되니 유의하시기 바랍니다.
ㆍ팝빌 개발환경에서 발행한 현금영수증은 실제로 국세청에 전송되지 않고 가상으로 전송처리됩니다.
ㆍ'발행완료' 상태의 현금영수증은 국세청 전송 정책에 따라 국세청에 전송됩니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 mgtKey String 24 O 파트너가 부여한 문서번호
3 orgConfirmNum String 9 O 원본 현금영수증 국세청승인번호
4 orgTradeDate String 8 O 원본 현금영수증 거래일자, 날짜형식(yyyyMMdd)
5 smssendYN Boolean - - 발행 안내문자 전송여부
6 memo String 200 - 발행시 남길 수 있는 메모, 상태확인(GetInfo)를 통해 stateMemo(상태메모) 확인 가능
7 UserID String 50 - 팝빌회원 아이디
8 isPartCancel Boolean - - 취소유형 [ true-부분 취소, false-전체 취소 중 택1 ]
9 cancelType Integer 1 - 취소사유 [ 1-거래취소, 2-오류발급취소, 3-기타 중 택1 ]
10 supplyCost String 9 - 공급가액, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
11 tax String 9 - 부가세, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
12 serviceFee String 9 - 봉사료, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
13 totalAmount String 9 - 거래금액 (공급가액+부가세+봉사료) 입력
취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력

Return

TResponse

Throws

EPopbillException

1.9. RevokeRegister - 취소 현금영수증 임시저장

ㆍ취소 현금영수증을 임시저장할 수 있으며, '임시저장' 상태의 현금영수증은 국세청에 전송되지 않습니다.

ㆍ취소 현금영수증의 금액은 원본 금액을 넘을 수 없으며, 부분취소 현금영수증 작성시에는 공급가액, 부가세, 봉사료, 거래금액은 취소할 금액을 넣습니다.

function RevokeRegister(CorpNum : String; mgtKey : String; orgConfirmNum : String; orgTradeDate : String; smssendYN : Boolean = False; UserID : String = ''; isPartCancel : Boolean = False; cancelType : Integer = 0; supplyCost : String = ''; tax : String = ''; serviceFee : String = ''; totalAmount : String = '') : TResponse

개발 유의사항
ㆍ원본 현금영수증의 국세청 승인번호 및 거래일자는 상태확인(GetInfo)함수를 통해 확인 가능합니다.
ㆍ'임시저장' 상태의 현금영수증을 발행(Issue)하면 '발행완료' 상태가 됩니다.
ㆍ'발행완료' 상태의 현금영수증만이 국세청 전송 대상입니다. 국세청 전송 정책 보기

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 mgtKey String 24 O 파트너가 부여한 문서번호
3 orgConfirmNum String 9 O 원본 현금영수증 국세청승인번호
4 orgTradeDate String 8 O 원본 현금영수증 거래일자, 날짜형식(yyyyMMdd)
5 smssendYN Boolean - - 발행 안내문자 전송여부
6 UserID String 50 - 팝빌회원 아이디
7 isPartCancel Boolean - - 취소유형 [ true-부분 취소, false-전체 취소 중 택1 ]
8 cancelType Integer 1 - 취소사유 [ 1-거래취소, 2-오류발급취소, 3-기타 중 택1 ]
9 supplyCost String 9 - 공급가액, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
10 tax String 9 - 봉사료, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
11 serviceFee String 9 - 봉사료, 취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력
12 totalAmount String 9 - 거래금액 (공급가액+부가세+봉사료) 입력
취소유형이 부분취소일 경우 취소할 금액 입력
취소유형이 전체취소일 경우 미입력

Return

TResponse

Throws

EPopbillException

2. 현금영수증 정보확인

2.1. GetInfo - 상태 확인

ㆍ현금영수증 1건의 상태코드(stateCode)와 요약정보 확인합니다.

function GetInfo(CorpNum : string; MgtKey: string) : TCashbillInfo

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호

Return

TCashbillInfo

Throws

EPopbillException

2.2. GetInfos - 상태 대량 확인

ㆍ다수건의 현금영수증 상태코드(stateCode) 및 요약정보 확인합니다. (최대 1,000건)

function GetInfos(CorpNum : string; MgtKeyList: Array Of String) : TCashbillInfoList

ㆍ현금영수증 목록을 구현하는 경우 GetInfos 함수 활용을 권장합니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyList Array Of String 1000 O 문서번호 배열 (최대 1,000건)

Return

TCashbillInfoList = Array of TCashbillInfo

Throws

EPopbillException

2.3. GetDetailInfo - 상세정보 확인

ㆍ현금영수증 1건의 상세정보 확인합니다.

function GetDetailInfo(CorpNum : string; MgtKey: string) : TCashbill

ㆍ현금영수증 정보를 출력하는 화면 구현시 GetDetailInfo 함수 활용을 권장합니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호

Return

TCashbill

Throws

EPopbillException

2.4. Search - 목록 조회

ㆍ검색조건에 해당하는 현금영수증 목록을 조회합니다.

function Search(CorpNum : String; DType : String; SDate : String; EDate : String; State : Array Of String; TradeType : Array Of String; TradeUsage : Array Of String; TaxationType : Array Of String; QString : String; Page : Integer; PerPage : Integer; Order : String; TradeOpt : Array of String) : TCashbillSearchList

ㆍ페이지 관련 항목(Page, PerPage, Order)을 활용하여 현금영수증 목록 페이지 기능을 구현할 수 있습니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 DType String 1 O 일자유형 [ R-등록일자, T-거래일자, I–발행일시 중 택1 ]
3 SDate String 8 O 시작일자, 날짜형식(yyyyMMdd)
4 EDate String 8 O 종료일자, 날짜형식(yyyyMMdd)
5 State Array Of String - O [배열] 상태코드, 상태코드 2,3번째 자리에 와일드카드(*) 사용가능, 예) "1**", "3**"
[부록] "현금영수증 상태코드"
6 TradeType Array Of String - O [배열] 문서형태 [ N-일반 현금영수증 / C-취소 현금영수증 ]
7 TradeUsage Array Of String - O [배열] 거래구분 [ P–소득공제용 / C-지출증빙용 ]
8 TaxationType Array Of String - O [배열] 과세형태 [ T–과세 / N–비과세 ]
9 QString String - O 거래처 상호 또는 사업자번호 검색 조회, 공백처리시 전체조회
10 Page Integer - O 페이지번호, 기본값 '1'
11 PerPage Integer - O 페이지당 검색개수, 기본값 500, 최대 1000
12 Order String 1 O 정렬 방향, 기본값 'D' [ D-내림차순, A-오름차순 중 택1 ]
13 TradeOpt Array Of String - O [배열] 거래유형 [ N–일반 / B–도서공연 / T-대중교통 ]

Return

TCashbillSearchList

Throws

EPopbillException

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

ㆍ현금영수증의 변경 상태, 등록일시, 요청 IP, 처리담당자 등의 정보에 대한 변경이력을 확인합니다.

function GetLogs(CorpNum : string; MgtKey: string) : TCashbillLogList

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호

Return

TCashbillLogList = Array Of TCashbillLog

Throws

EPopbillException

2.6. GetURL - 현금영수증 문서함 관련 URL

ㆍ팝빌 사이트의 현금영수증 문서함 메뉴에 로그인 된 상태로 접근할 수 있는 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 이 시간 초과후에는 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetURL(CorpNum : String; UserID : String; TOGO : String) : String; overload

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디
3 TOGO String - O TBOX-임시문서함 / PBOX-발행문서함 / WRITE-현금영수증 신규작성 중 택1

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

3. 현금영수증 보기/인쇄

3.1. GetPopUpURL - 현금영수증 보기 URL

ㆍ팝빌 사이트의 현금영수증 1건의 상세 화면 페이지의 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 이 시간 초과후에는 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetPopUpURL(CorpNum: string; MgtKey : String; UserID: String = '') : string

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

3.2. GetPrintURL - 현금영수증 인쇄 URL

ㆍ현금영수증 1건의 인쇄를 할 수 있는 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 이 시간 초과후에는 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetPrintURL(CorpNum: string; MgtKey : String; UserID: String = '') : string

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

3.3. GetMassPrintURL - 현금영수증을 대량 인쇄 URL

ㆍ현금영수증을 최대 100건 출력할 수 있는 인쇄를 할 수 있는 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 이 시간 초과후에는 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetMassPrintURL(CorpNum: string; MgtKeyList: Array Of String; UserID: String = '') : string

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyList Array Of String 100 O 문서번호 배열 (최대 100건)
3 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

3.4. GetMailURL - 현금영수증 메일링크 URL

ㆍ구매자가 수신하는 현금영수증 안내 메일의 하단에 버튼 URL 주소를 반환합니다.

function GetMailURL(CorpNum: string; MgtKey : String; UserID: String = '') : string

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

4. 부가기능

4.1. GetAccessURL - 팝빌 로그인 URL

ㆍ팝빌 사이트에 로그인 상태로 접근할 수 있는 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 이 시간 초과후에는 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetAccessURL(CorpNum : String; UserID : String) : String

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

4.2. SendEmail - 메일 전송

ㆍ현금영수증 안내 메일을 재전송 합니다.

function SendEmail(CorpNum : String; MgtKey :String; Receiver:String; UserID : String = '') : TResponse

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Receiver String - O 수신자 이메일주소
4 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

4.3. SendSMS - 문자 전송

ㆍSMS(단문) 문자를 전송하며 포인트가 차감 됩니다. (단, 전송실패시 환불)

ㆍ메시지 길이가 90byte 이상인 경우, 길이를 초과하는 메시지 내용은 자동으로 삭제되어 전송됩니다.

function SendSMS(CorpNum : String; MgtKey :String; Sender:String; Receiver:String; Contents : String; UserID : String = '') : TResponse

ㆍ팝빌 사이트의 [문자 팩스] > [문자] > [전송내역] 페이지에서 전송결과를 확인할 수 있습니다.
ㆍ팝빌 사이트의 [문자 팩스] > [문자] > [문자전송] 페이지에서 SMS 입력란을 통해 메시지 길이를 알 수 있습니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Sender String - O 발신번호
4 Receiver String - O 수신번호
5 Contents String 90 O 문자메시지 내용, 최대 90Byte 초과된 내용은 삭제되어 전송됨
6 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

4.4. SendFAX - 팩스 전송

ㆍ현금영수증을 팩스 전송하며 포인트가 차감됩니다. (단, 전송실패 환불 / 특정 사유 제외)

function SendFAX(CorpNum : String; MgtKey :String; Sender:String; Receiver:String; UserID : String = '') : TResponse

개발 유의사항
ㆍ팝빌 사이트 > [문자 팩스] > [팩스] > [전송내역] 메뉴에서 전송결과를 확인할 수 있습니다.
ㆍ팩스와 수신단말기 간에 통신이 연결된 경우 전송 실패가 되더라도 환불이 불가합니다. (예, 수신자가 수화기를 들거나 수신단말기에서 ARS 음성이 감지된 경우)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKey String 24 O 파트너가 부여한 문서번호
3 Sender String - O 발신번호
4 Receiver String - O 수신번호
5 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

4.5. ListEmailConfig - 현금영수증 알림메일 전송목록 조회

ㆍ현금영수증 관련 메일전송 항목에 대한 전송여부를 목록을 반환합니다.

function ListEmailConfig(CorpNum : String; UserID : String = '') : TEmailConfigList

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디

Return

TEmailConfigList = Array of TEmailConfig

Throws

EPopbillException

4.6. UpdateEmailConfig - 현금영수증 알림메일 전송설정 수정

ㆍ현금영수증 관련 메일전송 항목에 대한 전송여부를 수정합니다.

function UpdateEmailConfig(CorpNum : String; EmailType : String; SendYN : Boolean; UserID : String = '') : TResponse

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 EmailType String - O 메일 전송 유형

CSH_ISSUE : 고객에게 현금영수증이 발행 되었음을 알려주는 메일
CSH_CANCEL : 고객에게 현금영수증이 발행취소 되었음을 알려주는 메일

3 SendYN Boolean - O 전송 여부
4 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

5. 포인트 관리

5.2. GetBalance - 연동회원 잔여포인트 확인

ㆍ연동회원 잔여포인트를 확인합니다.

function GetBalance(CorpNum: string): Double;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)

Return

Double - 연동회원 잔여포인트

Throws

EPopbillException

5.3. GetChargeURL - 연동회원 포인트충전 URL

ㆍ팝빌 연동회원 사업자의 포인트 충전 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 초과하면 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetChargeURL(CorpNum: string; UserID: string): string;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

5.4. GetPartnerBalance - 파트너 잔여포인트 확인

ㆍ파트너 잔여포인트를 확인합니다.

function GetPartnerBalance(CorpNum: string): Double;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)

Return

Double - 파트너 잔여포인트

Throws

EPopbillException

5.4. GetPartnerURL - 파트너 포인트충전 URL

ㆍ파트너 포인트충전 팝업 URL 을 반환합니다.

ㆍ반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 초과하면 URL을 사용해도 정상적인 페이지에 접근할 수 없습니다.

function GetPartnerURL(CorpNum: string; TOGO: string): string;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 TOGO String - O CHRG : 파트너 포인트 충전

Return

String - 요청에 대한 응답 URL

Throws

EPopbillException

5.5. GetUnitCost - 발행 단가 확인

ㆍ현금영수증 발행시 과금되는 포인트 단가를 확인합니다.

function GetUnitCost(CorpNum: string): Single

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)

Return

Single - 현금영수증 발행단가

Throws

EPopbillException

5.6. GetChargeInfo - 과금정보 확인

ㆍ현금영수증 서비스 과금정보를 확인합니다.

function GetChargeInfo(CorpNum: string): TCashbillChargeInfo

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
0 UserID String 50 - 팝빌회원 아이디

Return

TCashbillChargeInfo

Throws

EPopbillException

6. 회원정보

6.1. CheckIsMember - 연동회원 가입여부 확인

ㆍ사업자번호를 조회하여 연동회원 가입여부를 확인합니다.

function CheckIsMember(CorpNum: string; LinkID: string): TResponse;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 LinkID String - O 링크아이디

Return

TResponse

Throws

EPopbillException

6.2. CheckID - 아이디 중복 확인

ㆍ팝빌회원 아이디 중복여부를 확인합니다.

function CheckID(ID: string): TResponse;

Parameters

순번 변수명 타입 길이 필수 설명
1 CheckID String 10 O 중복여부 확인 할 아이디

Return

TResponse

Throws

EPopbillException

6.3. JoinMember - 연동회원 신규가입

ㆍ사업자의 연동회원 가입처리를 요청합니다.

function JoinMember(JoinInfo: TJoinForm): TResponse;

Parameters

순번 변수명 타입 길이 필수 설명
1 JoinInfo TJoinForm - O 연동 회원 정보 객체

Return

TResponse

Throws

EPopbillException

6.4. GetCorpInfo - 회사정보 확인

ㆍ팝빌 연동회원의 회사정보를 확인합니다.

function GetCorpInfo(CorpNum: string; UserID: string): TCorpInfo; overload

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디

Return

TCorpInfo

Throws

EPopbillException

6.5. UpdateCorpInfo - 회사정보 수정

ㆍ팝빌 연동회원의 회사정보를 수정합니다.

function UpdateCorpInfo(CorpNum: string; CorpInfo: TCorpInfo; UserID: string): TResponse; overload

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 CorpInfo TCorpInfo - O 회사정보 객체
3 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

6.6. RegistContact - 담당자 등록

ㆍ팝빌 연동회원 사업자의 담당자 정보(팝빌 로그인 계정)를 추가합니다.

ㆍ하나의 사업자번호에 다수의 담당자 정보(팝빌 로그인 계정)를 추가할 수 있습니다.

function RegistContact(CorpNum: string; JoinInfo: TJoinContact; UserID: string): TResponse; overload

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 JoinInfo TJoinContact - O 담당자 정보 객체
3 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

6.7. ListContact - 담당자 목록 확인

ㆍ팝빌 연동회원 사업자의 담당자 목록을 확인합니다.

function ListContact(CorpNum: string; UserID: string): TContactInfoList; overload

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 UserID String 50 - 팝빌회원 아이디

Return

TContactInfoList = Array Of TContactInfo

Throws

EPopbillException

6.8. UpdateContact - 담당자 정보 수정

ㆍ팝빌 연동회원 사업자의 담당자 정보를 수정합니다.

function UpdateContact(CorpNum: string; CorpInfo: TContactInfo; UserID: string): TResponse;

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 CorpInfo TContactInfo - O 담당자 정보 객체
3 UserID String 50 - 팝빌회원 아이디

Return

TResponse

Throws

EPopbillException

A. 객체정보

A.1. TResponse

순번 변수명 항목명 타입 길이 비고
1 code 코드 LongInt - API 처리에 대한 응답 상태코드
2 message 메시지 string - API 처리에 대한 응답 메시지

A.2. EPopbillException

순번 변수명 항목명 타입 길이 비고
1 code 코드 LongInt - API 처리 실패에 대한 오류코드(-로 시작하는 8자리 숫자값)
2 message 메시지 string - API 처리 실패에 대한 오류메시지

A.3. TCashbill

순번 변수명 항목명 타입 길이 필수 비고
1 mgtKey 문서번호 string 24 O 파트너가 부여한 현금영수증 문서번호 기재
2 confirmNum 국세청승인번호 string 9 - 국세청 전송시 팝빌이 부여하는 현금영수증 국세청승인번호
3 orgConfirmNum 원본 현금영수증 국세청승인번호 string 9 - 문서형태 "취소거래" 경우 필수 기재
4 orgTradeDate 원본 현금영수증 거래일자 string 8 - 문서형태 "취소거래" 경우 필수 기재
5 tradeDate 거래일자 string 8 - 즉시 발행(RegistIssue) 또는 발행(Issue) 함수로 현금영수증을 발행한 날짜
팝빌이 자동으로 부여하는 값 (예 20191211)
6 tradeType 문서형태 string 4 O "승인거래", "취소거래" 중 기재
7 tradeUsage 거래구분 string - O "소득공제용, "지출증빙용" 중 기재
8 tradeOpt 거래유형 string 4 - "일반", "도서공연", "대중교통" 중 기재
9 taxationType 과세형태 string - O "과세", "비과세" 중 기재
10 totalAmount 거래금액 string 9 O 숫자만 가능
11 supplyCost 공급가액 string 9 O 숫자만 가능
12 tax 부가세 string 9 O 숫자만 가능
13 serviceFee 봉사료 string 9 O 숫자만 가능
14 franchiseCorpNum 가맹점 사업자번호 string 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
15 franchiseCorpName 가맹점 상호 string 200 -
16 franchiseCEOName 가맹점 대표자 성명 string 100 -
17 franchiseAddr 가맹점 주소 string 400 -
18 franchiseTEL 가맹점 전화번호 string 20 -
19 identityNum 식별번호 string 19 O

거래유형을 소득공제용으로 기재한 경우
- 주민등록/휴대폰/카드번호(현금영수증 카드)/자진발급용 번호(010-000-1234) 기재

거래유형을 지출증빙용으로 기재한 경우
- 사업자번호/주민등록/휴대폰/카드번호(현금영수증 카드) 기재

20 customerName 주문자명 string 70 -
21 itemName 주문상품명 string 70 -
22 orderNumber 주문번호 string 200 -
23 email 이메일 string 100 -
24 hp 휴대폰 string 20 -
25 smssendYN SMS 전송여부 Boolean - -
26 faxsendYN FAX 전송여부 Boolean - -
27 cancelType 취소사유 Integer 1 - 취소사유 [ 1-거래취소, 2-오류발급취소, 3-기타 중 택1 ]

A.4. TCashbillSearchList

순번 변수명 항목명 타입 길이 비고
1 code 요청에 대한 응답코드 Integer -
2 message 요청에 대한 응답메시지 string -
3 total 총 검색결과 건수 Integer -
4 perPage 페이지당 검색개수 Integer -
5 pageNum 페이지 번호 Integer -
6 pageCount 페이지 개수 Integer -
7 list 현금영수증 상태/요약정보 TCashbillInfoList [배열] 최대 1,000개, 상태 확인(GetInfo) 응답전문의 구성과 동일

A.5. TCashbillInfo

순번 변수명 항목명 타입 길이 비고
1 itemKey 팝빌번호 string 18 팝빌이 부여한 식별번호
2 mgtKey 문서번호 string 24 파트너가 부여한 문서번호
3 tradeDate 거래일자 string 8 날짜형식(yyyyMMdd)
4 tradeType 문서형태 string 4 승인거래, 취소거래 중 반환
5 tradeUsage 거래구분 string 5 소득공제용, 지출증빙용 중 반환
6 tradeOpt 거래유형 string 4 일반, 도서공연, 대중교통 중 반환
7 taxationType 과세형태 string 3 과세, 비과세 중 반환
8 totalAmount 거래금액 string 9
9 issueDT 발행일시 string 14 날짜형식(yyyyMMddHHmmss)
10 regDT 등록일시 string 14 날짜형식(yyyyMMddHHmmss)
11 stateMemo 상태메모 string 200
12 stateCode 상태코드 Integer 3 [부록] "현금영수증 상태코드"
13 stateDT 상태변경일시 string 14 날짜형식(yyyyMMddHHmmss)
14 identityNum 식별번호 string 19

거래유형을 소득공제용으로 기재한 경우
- 주민등록/휴대폰/카드번호(현금영수증 카드)/자진발급용 번호(010-000-1234) 기재

거래유형을 지출증빙용으로 기재한 경우
- 사업자번호/주민등록/휴대폰/카드번호(현금영수증 카드) 기재

15 itemName 주문상품명 string 70
16 customerName 주문자명 string 70
17 confirmNum 국세청승인번호 string 9
18 orgConfirmNum 원본 현금영수증
국세청승인번호
string 9
19 orgTradeDate 원본 현금영수증 거래일자 string 8
20 ntssendDT 국세청 전송일시 string 14 날짜형식(yyyyMMddHHmmss)
21 ntsresultDT 국세청 처리결과 수신일시 string 14 날짜형식(yyyyMMddHHmmss)
22 ntsresultCode 국세청 처리결과 상태코드 string 4 [부록] "국세청 처리결과 상태코드"
23 ntsresultMessage 국세청 처리결과 메시지 string 30
24 printYN 인쇄여부 Boolean -

A.6. TCashbillLog

순번 변수명 항목명 타입 길이 비고
1 docLogType 로그타입 Integer 3 100-임시저장 / 101-수정 / 111-메일 재전송 / 112- 문자 재전송 / 113-팩스 재전송
122-문자 전송결과 / 123-팩스 전송결과
410-발행 / 411-발행취소 / 451-전송 대기전
452-전송 진행중 / 453-국세청 전송 접수
454-전송완료 / 455-전송실패
2 log 이력정보 string 2000
3 procType 처리형태 string 3 연동 - API / 일반 - 팝빌 사이트 / 시스템 - 팝빌 시스템
4 procMemo 처리메모 string 200
5 regDT 등록일시 string 14
6 ip 아이피 string 39

A.7. TEmailConfig

순번 변수명 항목명 타입 길이 비고
1 emailType 메일전송유형 string -

CSH_ISSUE : 고객에게 현금영수증이 발행 되었음을 알려주는 메일
CSH_CANCEL : 고객에게 현금영수증이 발행취소 되었음을 알려주는 메일

2 sendYN 전송여부 Boolean - true-전송 / false-미전송

A.8. TCashbillChargeInfo

순번 변수명 항목명 타입 길이 비고
1 unitCost 발행단가 string - 발행단가 반환
2 chargeMethod 과금유형 string - 일반, 연동, 파트너 중 반환
3 rateSystem 과금제도 string - 종량제 반환

A.9. TJoinForm

순번 변수명 항목명 타입 길이 필수 비고
1 ID 아이디 string 50 O 6자 이상 50자 미만
2 PWD 비밀번호 string 20 O 6자 이상 20자 미만
3 LinkID 파트너 링크아이디 string 20 O 파트너 신청시 메일로 발급받은 링크아이디
4 CorpNum 사업자번호 string 10 O 사업자번호 (하이픈 '-' 제외 10 자리)
5 CEOName 대표자 성명 string 200 O
6 CorpName 상호 string 200 O
7 Addr 사업장 주소 string 300 O
8 BizType 업태 string 100 O
9 BizClass 종목 string 100 O
10 ContactName 담당자 성명 string 100 O
11 ContactEmail 담당자 이메일 string 100 O
12 ContactTEL 담당자 연락처 string 20 O
13 ContactHP 담당자 휴대폰번호 string 20 -
14 ContactFAX 담당자 팩스번호 string 20 -

A.10. TCorpInfo

순번 변수명 항목명 타입 길이 필수 비고
1 ceoname 대표자 성명 string 100 O
2 corpName 상호 string 200 O
3 addr 주소 string 300 O
4 bizType 업태 string 100 O
5 bizClass 종목 string 100 O

A.11. TJoinContact

순번 변수명 항목명 타입 길이 필수 비고
1 id 아이디 string 50 O 6자 이상 50자 미만
2 pwd 비밀번호 string 20 O 6자 이상 20자 미만
3 personName 담당자 성명 string 100 O
4 tel 담당자 연락처 string 20 -
5 hp 담당자 휴대폰번호 string 20 -
6 fax 담당자 팩스번호 string 20 -
7 email 담당자 이메일 string 100 O
8 searchAllAllowYN 담당자 조회권한 설정 Boolean - O

회사조회(true) : 모든 담당자의 전자문서 관리가능

개인조회(false) : 해당 담당자 계정으로 작성한 전자문서 관리가능

9 mgrYN 관리자 여부 Boolean - O true-관리자 / false-사용자

A.12. TContactInfo

순번 변수명 항목명 타입 길이 필수 비고
1 id 아이디 string 50 O 6자 이상 50자 미만
2 personName 담당자 성명 string 100 O
3 tel 담당자 연락처 string 20 -
4 hp 담당자 휴대폰번호 string 20 -
5 fax 담당자 팩스번호 string 20 -
6 email 담당자 이메일 string 100 O
7 regDT 등록일시 string 14 -
8 searchAllAllowYN 담당자 조회권한 설정 Boolean - O

회사조회(true) : 모든 담당자의 전자문서 관리가능

개인조회(false) : 해당 담당자 계정으로 작성한 전자문서 관리가능

9 mgrYN 관리자 여부 Boolean - O true-관리자 / false-사용자
10 state 상태 integer 1 - 0–승인대기 / 1–사용중