Index

1. 현금영수증 발행

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

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

ㆍ 문서번호란 현금영수증 발행시 중복방지/문서식별을 위해 파트너가 할당하는 기본키(Primary Key) 역할을 하는 필드입니다.

ㆍ 사용중인 문서번호는 새로운 현금영수증 발행시 부여할 수 없습니다.

boolean checkMgtKeyInUse(String CorpNum, String MgtKey) throws PopbillException

Parameters

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

Return

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

Throws

PopbillException

1.2. RegistIssue - 즉시 발행

ㆍ 현금영수증을 즉시 발행 처리합니다. 함수 호출 후 현금영수증은 '발행완료' 상태로 처리됩니다.

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

Response registIssue(String CorpNum, Cashbill cashbill, String memo, String UserID) throws PopbillException

개발환경 테스트 유의사항
ㆍ 구매자 메일주소로 발행 안내 메일이 전송됩니다. 실제 구매자의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 팝빌 개발환경에서 발행한 현금영수증은 실제로 국세청에 전송되지 않고 가상으로 전송처리됩니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 cashbill Cashbill - O 현금영수증 객체정보
3 memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
4 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.3. Register - 임시저장

ㆍ 현금영수증을 임시저장 처리합니다. '임시저장' 상태의 현금영수증은 국세청에 전송되지 않으며, 반드시 발행(Issue API) 함수를 호출해야 국세청에 전송됩니다.

ㆍ 임시저장(Regist API) 과 발행(Issue API) 처리를 한 번의 함수 호출로 처리하는 즉시 발행(RegistIssue API) 함수 사용을 권장합니다.

Response register(String CorpNum, Cashbill cashbill, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

1.4. Update - 수정

ㆍ 현금영수증 기재정보를 수정합니다. '임시저장' 상태에서만 수정이 가능합니다.

Response update(String CorpNum, String MgtKey, Cashbill cashbill, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

1.5. Issue - 발행

'임시저장' 상태의 현금영수증을 발행 처리합니다. 함수 호출 후 현금영수증은 '발행완료' 상태로 처리됩니다.

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

Response issue(String CorpNum, String MgtKey, String Memo, String UserID) throws PopbillException

개발환경 테스트 유의사항
ㆍ 구매자 메일주소로 발행 안내 메일이 전송됩니다. 실제 구매자의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 팝빌 개발환경에서 발행한 현금영수증은 실제로 국세청에 전송되지 않고 가상으로 전송처리됩니다.

Parameters

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

Return

Response

Throws

PopbillException

1.6. CancelIssue - 발행취소

ㆍ 국세청 전송을 대기중인 '발행완료' 상태의 현금영수증을 '발행취소' 처리합니다.

'발행취소' 상태의 현금영수증은 국세청에 전송되지 않습니다.

'발행취소' 상태의 현금영수증을 삭제 (Delete API) 처리하면, 현금영수증 관리를 위해 부여한 문서번호(mgtKey)를 재사용 할 수 있습니다.

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

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

Response cancelIssue(String CorpNum, String MgtKey, String Memo, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

1.7. Delete - 삭제

ㆍ 삭제 가능한 상태의 현금영수증을 삭제 처리합니다. 삭제처리된 현금영수증에 사용된 문서번호(mgtKey)는 재사용 할 수 있습니다.

Response delete(String CorpNum, String MgtKey, String UserID) throws PopbillException

삭제가능 상태 : '임시저장', '발행취소', '전송실패'

Parameters

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

Return

Response

Throws

PopbillException

1.8. RevokeRegistIssue - 취소 현금영수증 즉시발행

ㆍ 취소 현금영수증을 즉시 발행 처리합니다. 함수 호출 후 현금영수증은 '발행완료' 상태로 처리됩니다.

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

Response revokeRegistIssue(String CorpNum, String mgtKey, String orgConfirmNum, String orgTradeDate, Boolean smssendYN, String memo, Boolean isPartCancel, Integer cancelType, String supplyCost, String tax, String serviceFee, String totalAmount, String userID) throws PopbillException

개발환경 테스트 유의사항
ㆍ 구매자 메일주소로 발행 안내 메일이 전송됩니다. 실제 구매자의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 팝빌 개발환경에서 발행한 현금영수증은 실제로 국세청에 전송되지 않고 가상으로 전송처리됩니다.

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 API) stateMemo(상태메모) 확인 가능
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 - [취소] 거래금액 (공급가액+세액+봉사료)
13 userID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

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

ㆍ 취소 현금영수증을 임시저장 처리합니다. '임시저장' 상태의 현금영수증은 국세청에 전송되지 않으며, 반드시 발행(Issue API) 함수를 호출해야 국세청에 전송됩니다.

ㆍ 취소 현금영수증 임시저장(RevokeRegist API) 과 발행(Issue API)을 한 번의 함수 호출로 처리하는 취소 현금영수증 즉시발행(RevokeRegistIssue API) 함수 사용을 권장합니다.

Response revokeRegister(String CorpNum, String mgtKey, String orgConfirmNum, String orgTradeDate, Boolean smssendYN, Boolean isPartCancel, Integer cancelType, String supplyCost, String tax, String serviceFee, String totalAmount, String UserID) throws PopbillException

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 isPartCancel Boolean - - 취소유형 [ true-부분 취소, false-전체 취소 중 택1 ]
7 cancelType Integer 1 - 취소사유 [ 1-거래취소, 2-오류발급취소, 3-기타 중 택1 ]
8 supplyCost String 9 - [취소] 공급가액, 취소유형이 부분취소일 경우 취소할 금액 입력
9 tax String 9 - [취소] 부가세, 취소유형이 부분취소일 경우 취소할 금액 입력
10 serviceFee String 9 - [취소] 봉사료, 취소유형이 부분취소일 경우 취소할 금액 입력
11 totalAmount String 9 - [취소] 거래금액 (공급가액+세액+봉사료)
12 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

2. 현금영수증 정보확인

2.1. GetInfo - 상태 확인

ㆍ 현금영수증 1건의 상태 및 요약정보 확인합니다.

CashbillInfo getInfo(String CorpNum, String MgtKey) throws PopbillException

Parameters

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

Return

CashbillInfo

Throws

PopbillException

2.2. GetInfos - 상태 대량 확인

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

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

CashbillInfo[] getInfos(String CorpNum, String[] MgtKeyList) throws PopbillException

Parameters

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

Return

CashbillInfo[]

Throws

PopbillException

2.3. GetDetailInfo - 상세정보 확인

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

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

Cashbill getDetailInfo(String CorpNum, String MgtKey) throws PopbillException

Parameters

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

Return

Cashbill

Throws

PopbillException

2.4. Search - 목록 조회

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

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

CBSearchResult search(String CorpNum, String DType, String SDate, String EDate, String[] State, String[] TradeType, String[] TradeUsage, String[] TradeOpt, String[] TaxationType, String QString, int Page, int PerPage, String Order) throws PopbillException

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 String[] - - [배열] 상태코드, 상태코드 2,3번째 자리에 와일드카드(*) 사용가능, 예) "1**", "3**"
[부록] "현금영수증 상태코드"
6 TradeType String[] - - [배열] 문서형태 [ N-일반 현금영수증 / C-취소 현금영수증 ]
7 TradeUsage String[] - - [배열] 거래구분 [ P–소득공제용 / C-지출증빙용 ]
8 TradeOpt String[] - - [배열] 거래유형 [ N–일반 / B–도서공연 / T-대중교통 ]
9 TaxationType String[] - - [배열] 과세형태 [ T–과세 / N–비과세 ]
10 QString String - - 거래처 상호 또는 사업자번호 검색 조회, 공백처리시 전체조회
11 Page int - O 페이지번호, 기본값 '1'
12 PerPage int - O 페이지당 검색개수, 기본값 500, 최대 1000
13 Order String 1 - 정렬 방향, 기본값 'D' [ D-내림차순, A-오름차순 중 택1 ]

Return

CBSearchResult

Throws

PopbillException

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

ㆍ 현금영수증 상태 변경이력을 확인합니다.

ㆍ 현금영수증 상태, 요청일시, 요청 IP, 처리담당자 등의 정보를 이력정보 배열을 통해 확인 할 수 있습니다.

CashbillLog[] getLogs(String CorpNum, String MgtKey) throws PopbillException

Parameters

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

Return

CashbillLog[]

Throws

PopbillException

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

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getURL(String CorpNum, String UserID, String TOGO) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

ㆍ 팝빌 사이트의 현금영수증 1건의 보기 팝업 URL을 반환합니다.

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getPopUpURL(String CorpNum, String MgtKey, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getPrintURL(String CorpNum, String MgtKey, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getMassPrintURL(String CorpNum, String[] MgtKeyList, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

String getMailURL(String CorpNum, String MgtKey, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

4. 부가기능

4.1. GetAccessURL - 팝빌 로그인 URL

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getAccessURL(String CorpNum, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

4.2. SendEmail - 메일 전송

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

Response sendEmail(String CorpNum, String MgtKey, String Receiver, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

4.3. SendSMS - 문자 전송

ㆍ SMS(단문) 문자를 전송합니다.

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

ㆍ 문자 전송시 포인트가 차감됩니다. (전송실패시 환불처리)

ㆍ 팝빌 사이트의 [문자 팩스] > [문자] > [전송내역] 페이지에서 전송결과 확인

Response sendSMS(String CorpNum, String MgtKey, String Sender, String Receiver, String Contents, String UserID) throws PopbillException

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

Response

Throws

PopbillException

4.4. SendFAX - 팩스 전송

ㆍ 현금영수증을 팩스 전송합니다.

ㆍ 팩스 전송시 포인트가 차감됩니다. (전송실패시 환불처리)

ㆍ 팝빌 사이트 > [문자 팩스] > [팩스] > [전송내역] 메뉴에서 전송결과 확인

Response sendFAX(String CorpNum, String MgtKey, String Sender, String Receiver, String UserID) throws PopbillException

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

Response

Throws

PopbillException

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

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

EmailSendConfig[] listEmailConfig(String CorpNum, String UserID) throws PopbillException

Parameters

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

Return

EmailSendConfig[]

Throws

PopbillException

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

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

Response updateEmailConfig(String CorpNum, String EmailType, Boolean SendYN, String UserID) throws PopbillException

Parameters

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

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

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

Return

Response

Throws

PopbillException

5. 포인트 관리

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

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

double getBalance(String CorpNum) throws PopbillException

Parameters

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

Return

double - 연동회원 잔여포인트

Throws

PopbillException

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

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getChargeURL(String CorpNum, String UserID) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

double getPartnerBalance(String CorpNum) throws PopbillException

Parameters

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

Return

double - 파트너 잔여포인트

Throws

PopbillException

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

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

ㆍ 반환되는 URL은 보안정책상 30초의 유효시간을 갖으며, 유효시간 이후 호출시 정상적으로 페이지가 호출되지 않습니다.

String getPartnerURL(String CorpNum, String TOGO) throws PopbillException

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

5.5. GetUnitCost - 발행 단가 확인

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

float getUnitCost(String CorpNum) throws PopbillException

Parameters

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

Return

float - 현금영수증 발행단가

Throws

PopbillException

5.6. GetChargeInfo - 과금정보 확인

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

ChargeInfo getChargeInfo(String CorpNum) throws PopbillException

Parameters

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

Return

ChargeInfo

Throws

PopbillException

6. 회원정보

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

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

Response checkIsMember(String CorpNum, String LinkID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

6.2. CheckID - 아이디 중복 확인

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

Response checkID(String CheckID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

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

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

Response joinMember(JoinForm joinInfo) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

6.4. GetCorpInfo - 회사정보 확인

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

CorpInfo getCorpInfo(String CorpNum, String UserID) throws PopbillException

Parameters

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

Return

CorpInfo

Throws

PopbillException

6.5. UpdateCorpInfo - 회사정보 수정

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

Response updateCorpInfo(String CorpNum, CorpInfo corpInfo, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

6.6. RegistContact - 담당자 등록

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

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

Response registContact(String CorpNum, ContactInfo contactInfo, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

6.7. ListContact - 담당자 목록 확인

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

ContactInfo[] listContact(String CorpNum, String UserID) throws PopbillException

Parameters

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

Return

ContactInfo[]

Throws

PopbillException

6.8. UpdateContact - 담당자 정보 수정

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

Response updateContact(String CorpNum, ContactInfo contactInfo, String UserID) throws PopbillException

Parameters

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

Return

Response

Throws

PopbillException

A. 객체정보

A.1. Response

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

A.2. PopbillException

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

A.3. Cashbill

순번 변수명 항목명 타입 길이 필수 비고
1 mgtKey 문서번호 String 24 O 파트너가 부여한 현금영수증 문서번호 기재
2 confirmNum 국세청승인번호 String 9 - 미기재, 국세청이 부여한 현금영수증 승인번호
3 orgConfirmNum 원본 현금영수증 국세청승인번호 String 9 - 문서형태 "취소거래" 경우 필수 기재
4 orgTradeDate 원본 현금영수증 거래일자 String 8 - 문서형태 "취소거래" 경우 필수 기재
5 tradeDate 거래일자 String 8 - 미기재, 팝빌에서 자동으로 부여 예) 20190413
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 O
17 franchiseAddr 가맹점 주소 String 400 O
18 franchiseTEL 가맹점 전화번호 String 20 -
19 identityNum 식별번호 String 19 - 거래유형이 '지출증빙용' - [휴대폰/카드/주민등록/사업자] 번호 입력
거래유형이 '소득공제용' - [휴대폰/카드/주민등록] 번호 입력
자진발급 "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. CBSearchResult

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

A.5. CashbillInfo

순번 변수명 항목명 타입 길이 비고
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 상태코드 int 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. CashbillLog

순번 변수명 항목명 타입 길이 비고
1 docLogType 로그타입 Integer 3
2 log 이력정보 String 2000
3 procType 처리형태 String 3
4 procMemo 처리메모 String 200
5 regDT 등록일시 String 14
6 ip 아이피 String 39

A.7. EmailSendConfig

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

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

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

A.8. ChargeInfo

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

A.9. JoinForm

순번 변수명 항목명 타입 길이 필수 비고
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 100 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. CorpInfo

순번 변수명 항목명 타입 길이 필수 비고
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. ContactInfo

순번 변수명 항목명 타입 길이 필수 비고
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 regDT 등록일시 String 14 -
9 searchAllAllowYN 담당자 조회권한 설정 Boolean - O

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

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

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