Index

1. 세금계산서 발행/전송

1.1. CheckMgtKeyInUse - 문서번호 확인

ㆍ 전자세금계산서 문서번호의 사용여부를 확인합니다.

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

ㆍ 사용중인 문서번호는 새로운 전자세금계산서 발행시 부여할 수 없습니다.

function CheckMgtKeyInUse($CorpNum, $MgtKeyType, $MgtKey)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호

Return

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

Throws

PopbillException

1.2. RegistIssue - 즉시 발행

ㆍ 전자세금계산서를 즉시 발행 처리합니다. 함수 호출 시 포인트가 차감되며, Taxinvoice 객체 클래스의 멤버 변수로 작성된 공급받는자 메일주소(invoiceeEmail1)로 발행 안내 메일이 전송됩니다.

ㆍ 전자세금계산서 발행 후 국세청 전송은 '익일 자동 전송(기본값)' 또는 '발행 즉시 전송' 처리됩니다. [참고] 국세청 전송 정책

function RegistIssue($CorpNum, $Taxinvoice, $UserID = null, $writeSpecification = false, $forceIssue = false, $memo = null, $emailSubject = null, $dealInvoiceMgtKey = null)

개발환경 테스트 유의사항
ㆍ 전자세금계산서 발행 테스트를 위해서는 팝빌 개발환경에 연동회원의 전자세금계산서 발급을 위한 공인인증서가 등록되어야 합니다.
ㆍ 공급받는자 메일주소로 발행 안내 메일이 전송됩니다. 실제 거래처의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 팝빌 개발환경에서 발행한 전자세금계산서는 실제로 국세청에 전송되지 않습니다. 국세청 전송은 가상으로 처리되며 전송 시작 후 5분 뒤에 '전송 성공' 상태로 처리됩니다.
ㆍ 즉시 발행 API를 이용하여 수정세금계산서 / 위수탁 세금계산서 발행 처리도 가능합니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 Taxinvoice Taxinvoice - O 세금계산서 객체정보
3 UserID String 50 - 팝빌회원 아이디
4 writeSpecification Boolean - - 거래명세서 동시작성 여부 [ true-거래명세서 동시작성 / false-거래명세서 미작성 ]
5 forceIssue Boolean - - 지연발행시 강제발행 여부 [ true-지연발행 가능 / false-지연발행 불가능 ]
6 memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
7 emailSubject String 300 - 세금계산서 발행시 공급받는자에게 발송되는 메일 제목, 미기재 시 팝빌에서 지정한 이메일 제목으로 전송됩니다.
8 dealInvoiceMgtKey String 24 - 거래명세서 동시작성시 거래명세서의 문서번호, 미기재시 세금계산서 문서번호로 등록

Return

IssueResponse

Throws

PopbillException

1.3. Register - 임시저장

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

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

function Register($CorpNum, $Taxinvoice, $UserID = null, $writeSpecification = false)

개발환경 테스트 유의사항
ㆍ 전자세금계산서 첨부파일 추가 기능을 구현하는 경우에 임시저장(Register API) → 파일 첨부(AttachFile API) → 발행(Issue API) 순서로 함수를 호출하여 파일 첨부 기능을 구현할 수 있습니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 Taxinvoice Taxinvoice - O 세금계산서 객체정보
3 UserID String 50 - 팝빌회원 아이디
4 writeSpecification Boolean - - 거래명세서 동시작성 여부 [ true-거래명세서 동시작성 / false-거래명세서 미작성 ]

Return

Response

Throws

PopbillException

1.4. Update - 수정

ㆍ 전자세금계산서를 수정 처리합니다. '임시저장' 상태에서만 수정이 가능합니다.

function Update($CorpNum, $MgtKeyType, $MgtKey, $Taxinvoice, $UserID = null, $writeSpecification = false)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Taxinvoice Taxinvoice - O 세금계산서 객체정보
5 UserID String 50 - 팝빌회원 아이디
6 writeSpecification Boolean - - 거래명세서 동시작성 여부 [ true-거래명세서 동시작성 / false-거래명세서 미작성 ]

Return

Response

Throws

PopbillException

1.5. Issue - 발행

'임시저장' 또는 역발행 요청 후 '공급자 발행 대기' 상태의 세금계산서를 발행 처리합니다.

ㆍ 발행 함수 호출 시 포인트가 차감되며, 전자세금계산서 기재 항목 중 공급받는자 메일주소(invoiceeEmail1)에 작성된 메일 주소로 발행 안내 메일이 전송됩니다.

function Issue($CorpNum, $MgtKeyType, $MgtKey, $Memo = '', $EmailSubject = null, $ForceIssue = false, $UserID = null)

개발환경 테스트 유의사항
ㆍ 전자세금계산서 발행 테스트를 위해서는 팝빌 개발환경에 연동회원의 전자세금계산서 발급을 위한 공인인증서가 등록되어야 합니다.
ㆍ 공급받는자 메일주소로 발행 안내 메일이 전송됩니다. 실제 거래처의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 팝빌 개발환경에서 발행한 전자세금계산서는 실제로 국세청에 전송되지 않습니다. 국세청 전송은 가상으로 처리되며 전송 시작 후 5분 뒤에 '전송 성공' 상태로 처리됩니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
5 EmailSubject String 300 - 세금계산서 발행시 공급받는자에게 발송되는 메일 제목, 미기재 시 팝빌에서 지정한 이메일 제목으로 전송됩니다.
6 ForceIssue Boolean - - 지연발행시 강제발행 여부 [ true-지연발행 가능 / false-지연발행 불가능 ]
7 UserID String 50 - 팝빌회원 아이디

Return

IssueResponse

Throws

PopbillException

1.6. CancelIssue - 발행취소

ㆍ 국세청 전송을 대기중인 '발행완료' 상태의 전자세금계산서를 '발행취소' 처리합니다.

'발행취소' 상태의 전자세금계산서는 국세청에 전송되지 않습니다.

'발행취소' 상태의 전자세금계산서를 삭제 (Delete API) 처리하면, 전자세금계산서 관리를 위해 부여했던 문서번호를 재사용 할 수 있습니다.

ㆍ 국세청 '전송중', '전송성공' 상태의 전자세금계산서는 발행취소 할 수 없습니다.

'전송성공' 상태의 전자세금계산서는 수정세금계산서를 발행하여 취소처리 할 수 있습니다. [참고] 수정세금계산서

function CancelIssue($CorpNum, $MgtKeyType, $MgtKey, $Memo = '', $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.7. RegistRequest - [역발행] 즉시 요청

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

ㆍ 즉시 요청 API 성공 처리시 전자세금계산서는 '발행 대기' 상태가 됩니다. 이후 공급자가 발행하는 시점에 포인트가 차감되며 '발행완료' 상태로 처리 됩니다.

'발행 대기' 상태의 전자세금계산서는 국세청에 전송되지 않으며 반드시 공급자가 발행을 해야 국세청에 신고됩니다.

ㆍ 세금계산서 기재항목 중 과금방향(ChargeDirection) 값에 따라 '정과금' 으로 기재시 공급자 포인트가 과금되며, '역과금' 으로 기재시 공급받는자 포인트가 과금됩니다.

ㆍ 공급자는 팝빌 사이트의 '매출 발행 대기함'에서 발행 대기 상태의 역발행 세금계산서를 확인할 수 있습니다.

function RegistRequest($CorpNum, $Taxinvoice, $Memo = '', $UserID = null)

개발환경 테스트 유의사항
ㆍ 역발행을 구현하기 위해서는 공급자와 공급받는자 사업자가 모두 팝빌의 회원이어야 합니다.
ㆍ 공급자 메일주소로 역발행 요청 메일이 전송됩니다. 실제 거래처의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 역발행 요청 이후 처리는 정발행 프로세스와 동일합니다. [참고] 역발행 - 프로세스
ㆍ 팝빌 개발환경에서 발행한 전자세금계산서는 실제로 국세청에 전송되지 않습니다. 국세청 전송은 가상으로 처리되며 전송 시작 후 5분 뒤에 '전송 성공' 상태로 처리됩니다.

Parameters

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

Return

Response

Throws

PopbillException

1.8. Request - 역발행요청

ㆍ 공급받는자가 '임시저장' 상태의 역발행 세금계산서를 공급자에게 발행 요청 처리합니다.

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

function Request($CorpNum, $MgtKeyType, $MgtKey, $Memo = '', $UserID = null)

개발환경 테스트 유의사항
ㆍ 역발행을 구현하기 위해서는 공급자와 공급받는자 사업자가 모두 팝빌의 회원이어야 합니다.
ㆍ 공급자 메일주소로 역발행 요청 메일이 전송됩니다. 실제 거래처의 메일 주소가 기재되지 않도록 주의하시기 바랍니다.
ㆍ 역발행 요청 이후 처리는 정발행 프로세스와 동일합니다. [참고] 역발행 - 프로세스
ㆍ 팝빌 개발환경에서 공급자가 발행한 전자세금계산서는 실제로 국세청에 전송되지 않습니다. 국세청 전송은 가상으로 처리되며 전송 시작 후 5분 뒤에 '전송 성공' 상태로 처리됩니다.

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.9. CancelRequest - 역발행요청 취소

공급받는자가 역발행 세금계산서의 발행요청을 취소합니다.

function CancelRequest($CorpNum, $MgtKeyType, $MgtKey, $Memo = '', $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.10. Refuse - 역발행요청 거부

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

function Refuse($CorpNum, $MgtKeyType, $MgtKey, $Memo = '', $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Memo String 200 - 메모, 상태확인(GetInfo API) stateMemo(상태메모) 확인 가능
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.11. Delete - 삭제

삭제 가능한 상태의 세금계산서를 삭제 처리합니다. 삭제처리된 세금계산서에 사용된 문서번호는 재사용 할 수 있습니다.

function Delete($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

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

Parameters

순번 변수명 타입 길이 필수 예제
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

1.12. SendToNTS - 국세청 즉시 전송

ㆍ 공급자가 국세청 전송 대기중인 발행완료 상태의 전자세금계산서를 국세청에 즉시 전송합니다.

ㆍ 국세청 즉시 전송 함수 호출 후 20~30분 내로 국세청 전송결과를 확인할 수 있습니다.

ㆍ 팝빌 개발환경은 국세청 즉시전송 함수 호출 시 실제로 국세청에 전송되지 않으며, 5분 후 가상으로 전송성공 처리됩니다.

function SendToNTS($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

2. 세금계산서 정보확인

2.1. GetInfo - 상태 확인

ㆍ 전자세금계산서 1건의 상태 및 요약정보 확인합니다.

ㆍ 반환되는 항목에 대한 정보는 리턴타입 TaxinvoiceInfo Class 참조 TaxinvoiceInfo

function GetInfo($CorpNum, $MgtKeyType, $MgtKey)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호

Return

TaxinvoiceInfo

Throws

PopbillException

2.2. GetInfos - 상태 대량 확인

ㆍ 다수건의 전자세금계산서 상태 및 요약정보 확인합니다. (최대 1,000건)

ㆍ 전자세금계산서 목록을 구현하는 경우 GetInfos 함수 활용을 권장합니다.

ㆍ TaxinvoiceInfo Class Object가 배열로 반환되며 Class 항목에 대한 정보는 리턴타입 TaxinvoiceInfo Class 참조 TaxinvoiceInfo

function GetInfos($CorpNum, $MgtKeyType, $MgtKeyList = array())

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKeyList Array 1000 O 문서번호 배열 (최대 1,000건)

Return

TaxinvoiceInfo[]

Throws

PopbillException

2.3. GetDetailInfo - 상세정보 확인

ㆍ 전자세금계산서 1건의 상세정보 확인합니다.

ㆍ 전자세금계산서 품목 리스트 및 공급자/공급받는자 정보를 출력하는 화면 구현시 GetDetailInfo 함수 활용을 권장합니다.

ㆍ 반환되는 리턴타입에 대한 자세한 정보는 Taxinvoice Class 참조 Taxinvoice

function GetDetailInfo($CorpNum, $MgtKeyType, $MgtKey)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호

Return

Taxinvoice

Throws

PopbillException

2.4. Search - 목록 조회

ㆍ 검색조건에 해당하는 전자세금계산서 목록을 조회합니다.

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

ㆍ 반환되는 리턴타입에 대한 자세한 정보는 TISearchResult Class 참조 TISearchResult

function Search($CorpNum, $MgtKeyType, $DType, $SDate, $EDate, $State = array(), $Type = array(), $TaxType = array(), $LateOnly, $Page, $PerPage, $Order, $TaxRegIDType = null, $TaxRegIDYN = null, $TaxRegID = null, $QString = null, $InterOPYN = null, $UserID = null, $IssueType = array())

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 DType String 1 O 일자유형 [ R-등록일시, W-작성일자, I-발행일시 중 택1 ]
4 SDate String 8 O 시작일자, 날짜형식(yyyyMMdd)
5 EDate String 8 O 종료일자, 날짜형식(yyyyMMdd)
6 State Array - - [배열] 상태코드, 상태코드 2,3번째 자리에 와일드카드(*) 사용가능, 예) "3**", "6**"
[부록] "세금계산서 상태코드"
7 Type Array - - [배열] 문서유형 [ N-일반 / M-수정 ]
8 TaxType Array - - [배열] 과세형태 [ T-과세 / N-면세 / Z-영세 ]
9 LateOnly Boolean - - 지연발행 조회 [ null-전체조회, false-정상발행조회, true-지연발행조회 중 택1 ]
10 Page Integer - - 페이지번호, 기본값 '1'
11 PerPage String - - 페이지당 검색개수, 기본값 500, 최대 1000
12 Order String 1 - 정렬 방향, 기본값 'D' [ D-내림차순, A-오름차순 중 택1 ]
13 TaxRegID String - - 종사업장번호, 다수 종사업장번호 검색 조건은 콤마(",")로 구분 ex)1234, 1110
14 TaxRegIDType String 1 - 종사업장번호 사업자유형 [ S–공급자, B-공급받는자, T–수탁자 중 택1 ]
15 TaxRegIDYN String 1 - 종사업장번호 유무 [ 공백–전체조회, 0–종사업장번호 없음, 1–종사업장번호 있음 중 택1 ]
16 QString String - - 거래처 상호 또는 사업자번호 검색 조회, 공백처리시 전체조회
17 InterOPYN String 1 - 연동문서 조회여부 [ 공백-전체조회, 0-일반문서조회, 1-연동문서조회 중 택1 ]
18 UserID String 50 - 팝빌회원 아이디
19 IssueType Array - - [배열] 발행형태 [ N–정발행 / R–역발행 / T–위수탁 ]

Return

TISearchResult

Throws

PopbillException

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

ㆍ 전자세금계산서의 상태 변경이력을 확인합니다.

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

function GetLogs($CorpNum, $MgtKeyType, $MgtKey)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호

Return

TaxinvoiceLog[]

Throws

PopbillException

2.6. GetURL - 세금계산서 문서함 관련 URL

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

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

function GetURL($CorpNum, $UserID, $TOGO)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3. 세금계산서 보기/인쇄

3.1. GetPopUpURL - 세금계산서 보기 URL

ㆍ 팝빌 사이트의 전자세금계산서 1건의 보기 팝업 URL을 반환합니다.

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

function GetPopUpURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.2. GetViewURL - 세금계산서 보기 URL [메뉴/버튼 제외]

ㆍ 전자세금계산서 1건의 보기 팝업 URL을 반환합니다. (팝빌 사이트의 상단, 좌측 메뉴 및 버튼 제외)

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

function GetViewURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.3. GetPrintURL - 세금계산서 인쇄 URL [공급자/공급받는자 용]

ㆍ 전자세금계산서 1건의 인쇄 팝업 URL을 반환합니다.

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

function GetPrintURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.4. GetEPrintURL - 세금계산서 인쇄 URL [공급받는자용]

ㆍ 전자세금계산서 1건의 공급받는자용 인쇄 팝업 URL을 반환합니다.

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

function GetEPrintURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.5. GetMassPrintURL - 세금계산서 대량 인쇄 URL

ㆍ 전자세금계산서를 최대 100건 출력할 수 있는 인쇄 팝업 URL을 반환합니다.

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

function GetMassPrintURL($CorpNum, $MgtKeyType, $MgtKeyList = array(), $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKeyList Array 100 O 문서번호 배열 (최대 100건)
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.6. GetMailURL - 세금계산서 메일링크 URL

ㆍ 공급받는자가 수신하는 안내 메일의 하단 버튼 링크 URL 주소를 반환합니다.

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

function GetMailURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

3.7. GetPDF - 세금계산서 PDF 다운로드

ㆍ전자세금계산서 PDF 파일로 다운 받기 위한 Byte Array를 반환합니다.

function GetPDF($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

BLOB - PDF 파일의 Byte Array

Throws

PopbillException

3.8. GetPDFURL - 세금계산서 PDF 다운로드 URL

ㆍ전자세금계산서 PDF 파일을 다운 받을 수 있는 URL을 반환합니다.

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

function GetPDFURL($CorpNum, $MgtKeyType, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 UserID String 50 - 팝빌회원 아이디

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

4. 부가기능

4.1. GetAccessURL - 팝빌 로그인 URL

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

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

function GetAccessURL($CorpNum, $UserID)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

4.2. GetSealURL - 인감 및 첨부문서 등록 URL

ㆍ 전자세금계산서에 첨부할 수 있는 인감, 사업자등록증, 통장사본을 등록하는 팝업 URL을 반환합니다.

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

function GetSealURL($CorpNum, $UserID)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

4.3. AttachFile - 첨부파일 추가

ㆍ 전자세금계산서에 첨부파일을 추가합니다. (최대 5개 파일 추가 가능)

ㆍ 전자세금계산서의 첨부파일 추가는 '임시저장' 상태만 가능 합니다.

function AttachFile($CorpNum, $MgtKeyType, $MgtKey, $FilePath, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 FilePath String - O 첨부파일 경로
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.4. DeleteFile - 첨부파일 삭제

ㆍ 전자세금계산서에 첨부된 파일을 삭제합니다.

ㆍ 첨부된 파일을 식별하는 FileID는 첨부파일 목록 확인 (GetFiles API) 함수의 반환 항목을 통해 확인합니다.

function DeleteFile($CorpNum, $MgtKeyType, $MgtKey, $FileID, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 FileID String 255 O 파일아이디, GetFiles API 반환값 중 attachedFile 필드 참조
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.5. GetFiles - 첨부파일 목록 확인

ㆍ 전자세금계산서에 첨부된 파일목록을 확인합니다.

function GetFiles($CorpNum, $MgtKeyType, $MgtKey)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호

Return

AttachedFile[]

Throws

PopbillException

4.6. SendEmail - 메일 전송

ㆍ 전자세금계산서 안내 메일을 재전송 합니다.

function SendEmail($CorpNum, $MgtKeyType, $MgtKey, $Receiver, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Receiver String - O 수신자 이메일주소
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.7. SendSMS - 문자 전송

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

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

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

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

function SendSMS($CorpNum, $MgtKeyType, $MgtKey, $Sender, $Receiver, $Contents, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Sender String - O 발신번호
5 Receiver String - O 수신번호
6 Contents String 90 O 문자메시지 내용, 최대 90Byte 초과된 내용은 삭제되어 전송됨
7 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.8. SendFAX - 팩스 전송

ㆍ 세금계산서를 팩스 전송합니다.

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

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

function SendFAX($CorpNum, $MgtKeyType, $MgtKey, $Sender, $Receiver, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 Sender String - O 발신번호
5 Receiver String - O 수신번호
6 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.9. AttachStatement - 전자명세서 첨부

전자세금계산서에 전자명세서를 첨부합니다.

function AttachStatement($CorpNum, $MgtKeyType, $MgtKey, $SubItemCode, $SubMgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 SubItemCode Integer 3 O 첨부할 전자명세서 거래명세서 종류코드
121 : 거래명세서
122 : 청구서
123 : 견적서
124 : 발주서
125 : 입금표
126 : 영수증
5 SubMgtKey String 24 O 첨부할 전자명세서 문서번호
6 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.10. DetachStatement - 전자명세서 첨부해제

전자세금계산서에 첨부된 전자명세서를 해제합니다.

function DetachStatement($CorpNum, $MgtKeyType, $MgtKey, $SubItemCode, $SubMgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 MgtKey String 24 O 파트너가 부여한 문서번호
4 SubItemCode Integer 3 O 첨부해제할 전자명세서 거래명세서 종류코드
121 : 거래명세서
122 : 청구서
123 : 견적서
124 : 발주서
125 : 입금표
126 : 영수증
5 SubMgtKey String 24 O 첨부해제할 전자명세서 문서번호
6 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.11. GetEmailPublicKeys - 유통사업자 메일 목록 확인

전자세금계산서 유통사업자의 메일 목록을 확인합니다.

function GetEmailPublicKeys($CorpNum)

Parameters

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

Return

EmailPublicKey[]

Throws

PopbillException

4.12. AssignMgtKey - 문서번호 할당

ㆍ 파트너 문서번호가 부여되지 않은 전자세금계산서에 문서번호를 할당합니다.

ㆍ 팝빌 사이트에서 작성한 전자세금계산서는 파트너 문서번호가 부여되지 않습니다.

function AssignMgtKey($CorpNum, $MgtKeyType, $itemKey, $MgtKey, $UserID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 MgtKeyType TIENumMgtKeyType - O 세금계산서 유형 [ SELL-매출 / BUY-매입 / TRUSTEE-위수탁 중 택1]
3 itemKey String 18 O 세금계산서 아이템키, 문서 목록조회(Search API)의 반환항목중 ItemKey 참조
4 MgtKey String 24 O 파트너가 부여한 문서번호
5 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

4.13. ListEmailConfig - 세금계산서 알림메일 전송목록 조회

ㆍ 전자세금계산서 관련 메일전송 항목에 대한 전송여부를 목록을 반환합니다.

function ListEmailConfig($CorpNum, $UserID = null)

Parameters

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

Return

TIEmailSendConfig[]

Throws

PopbillException

4.14. UpdateEmailConfig - 세금계산서 알림메일 전송설정 수정

ㆍ 전자세금계산서 관련 메일전송 항목에 대한 전송여부를 수정합니다.

function UpdateEmailConfig($corpNum, $emailType, $sendYN, $userID = null)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 EmailType String - O 메일 전송 유형
  • 정발행
    • ∙TAX_ISSUE : 공급받는자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_CHECK : 공급자에게 전자세금계산서가 수신확인 되었음을 알려주는 메일
    • ∙TAX_CANCEL_ISSUE : 공급받는자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
  • 발행예정
    • ∙TAX_SEND : 공급받는자에게 [발행예정] 세금계산서가 발송 되었음을 알려주는 메일
    • ∙TAX_ACCEPT : 공급자에게 [발행예정] 세금계산서가 승인 되었음을 알려주는 메일
    • ∙TAX_ACCEPT_ISSUE : 공급자에게 [발행예정] 세금계산서가 자동발행 되었음을 알려주는 메일
    • ∙TAX_DENY : 공급자에게 [발행예정] 세금계산서가 거부 되었음을 알려주는 메일
    • ∙TAX_CANCEL_SEND : 공급받는자에게 [발행예정] 세금계산서가 취소 되었음을 알려주는 메일
  • 역발행
    • ∙TAX_REQUEST : 공급자에게 세금계산서를 전자서명 하여 발행을 요청하는 메일
    • ∙TAX_CANCEL_REQUEST : 공급받는자에게 세금계산서가 취소 되었음을 알려주는 메일
    • ∙TAX_REFUSE : 공급받는자에게 세금계산서가 거부 되었음을 알려주는 메일
  • 위수탁 발행
    • ∙TAX_TRUST_ISSUE : 공급받는자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_ISSUE_TRUSTEE : 수탁자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_ISSUE : 공급받는자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
  • 위수탁 발행예정
    • ∙TAX_TRUST_SEND : 공급받는자에게 [발행예정] 세금계산서가 발송 되었음을 알려주는 메일
    • ∙TAX_TRUST_ACCEPT : 수탁자에게 [발행예정] 세금계산서가 승인 되었음을 알려주는 메일
    • ∙TAX_TRUST_ACCEPT_ISSUE : 수탁자에게 [발행예정] 세금계산서가 자동발행되었음을 알려주는 메일
    • ∙TAX_TRUST_DENY : 수탁자에게 [발행예정] 세금계산서가 거부 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_SEND : 공급받는자에게 [발행예정] 세금계산서가 취소되었음을 알려주는 메일
  • 처리결과
    • ∙TAX_CLOSEDOWN : 거래처의 휴폐업 여부를 확인하여 안내하는 메일
    • ∙TAX_NTSFAIL_INVOICER : 전자세금계산서 국세청 전송실패를 안내하는 메일
  • 정기발송
    • ∙TAX_SEND_INFO : 전월 귀속분 [매출 발행 대기] 세금계산서의 발행을 안내하는 메일
    • ∙ETC_CERT_EXPIRATION : 팝빌에서 이용중인 공인인증서의 갱신을 안내하는 메일
3 SendYN Boolean - O 전송 여부
4 UserID String 50 - 팝빌회원 아이디

Return

Response

Throws

PopbillException

5. 공인인증서 관리

5.1. GetTaxCertURL - 공인인증서 등록 URL

ㆍ 팝빌 연동회원 사업자의 전자세금계산서 발급을 위한 공인인증서 등록 팝업 URL을 반환합니다.

ㆍ 사업자의 공인인증서가 재발급/갱신/비밀번호가 변경되는 경우 변경된 인증서를 재등록 해야 전자세금계산서 발행이 가능합니다.

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

function GetTaxCertURL($CorpNum, $UserID)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

5.2. GetCertificateExpireDate - 공인인증서 만료일 확인

ㆍ 팝빌 사이트에 등록된 연동회원 사업자의 공인인증서의 만료일자를 반환합니다.

ㆍ 등록된 공인인증서의 유효성 검사를 위해서는 CheckCertValidation API를 이용하시기 바랍니다.

function GetCertificateExpireDate($CorpNum)

Parameters

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

Return

String - 공인인증서 만료일자

Throws

PopbillException

5.3. CheckCertValidation - 공인인증서 유효성 확인

ㆍ 팝빌 사이트에 등록된 연동회원 사업자의 공인인증서의 유효성을 확인합니다.

function CheckCertValidation($corpNum, $userID = null)

Parameters

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

Return

Response

Throws

PopbillException

6. 포인트 관리

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

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

function GetBalance($CorpNum)

Parameters

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

Return

String - 연동회원 잔여포인트

Throws

PopbillException

6.2. GetChargeURL - 연동회원 포인트 충전 팝업 URL

ㆍ연동회원 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function GetChargeURL($CorpNum, $UserID)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

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

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

function GetPartnerBalance($CorpNum)

Parameters

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

Return

String - 파트너 잔여포인트

Throws

PopbillException

6.4. GetPartnerURL - 파트너 포인트충전 팝업 URL

ㆍ파트너 포인트 충전을 위한 페이지의 팝업 URL을 반환합니다.

ㆍ반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

function GetPartnerURL($CorpNum, $TOGO)

Parameters

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

Return

String - 요청에 대한 응답 URL

Throws

PopbillException

6.5. GetUnitCost - 발행 단가 확인

ㆍ세금계산서 발행시 과금되는 포인트 단가를 확인합니다.

function GetUnitCost($CorpNum)

Parameters

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

Return

String - 세금계산서 발행단가

Throws

PopbillException

6.6. GetChargeInfo - 과금정보 확인

ㆍ팝빌 전자세금계산서 API 서비스 과금정보를 확인합니다.

function GetChargeInfo($CorpNum, $UserID = null)

Parameters

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

Return

ChargeInfo

Throws

PopbillException

7. 회원정보

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

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

function CheckIsMember($CorpNum, $LinkID)

Parameters

순번 변수명 타입 길이 필수 설명
1 CorpNum String 10 O 팝빌회원 사업자번호 (하이픈 '-' 제외 10 자리)
2 LinkID String - O 연동신청시 팝빌에서 발급받은 링크아이디

Return

Response

Throws

PopbillException

7.2. CheckID - 아이디 중복 확인

ㆍ사용하고자 하는 아이디의 중복여부를 확인합니다.

function CheckID($ID)

Parameters

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

Return

Response

Throws

PopbillException

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

ㆍ사용자를 연동회원으로 가입처리합니다.

function JoinMember($JoinForm)

Parameters

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

Return

Response

Throws

PopbillException

7.4. GetCorpInfo - 회사정보 확인

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

function GetCorpInfo($CorpNum, $UserID = null)

Parameters

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

Return

CorpInfo

Throws

PopbillException

7.5. UpdateCorpInfo - 회사정보 수정

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

function UpdateCorpInfo($CorpNum, $CorpInfo, $UserID = null)

Parameters

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

Return

Response

Throws

PopbillException

7.6. RegistContact - 담당자 추가

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정)를 추가합니다.

function RegistContact($CorpNum, $ContactInfo, $UserID = null)

Parameters

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

Return

Response

Throws

PopbillException

7.7. ListContact - 담당자 목록 확인

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 목록을 확인합니다.

function ListContact($CorpNum, $UserID = null)

Parameters

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

Return

ContactInfo[ ]

Throws

PopbillException

7.8. UpdateContact - 담당자 정보 수정

ㆍ연동회원 사업자번호에 등록된 담당자(팝빌 로그인 계정) 정보를 수정합니다.

function UpdateContact($CorpNum, $ContactInfo, $UserID)

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 코드 Integer - API 처리에 대한 응답 상태코드
2 message 메시지 String - API 처리에 대한 응답 메시지

A.2. PopbillException

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

A.3. IssueResponse

순번 변수명 항목명 타입 길이 비고
1 code 코드 Integer - API 처리에 대한 응답 상태코드
2 message 메시지 String - API 처리에 대한 응답 메시지
3 ntsConfirmNum 국세청승인번호 String 24

A.4. TIENumMgtKeyType

순번 변수명 항목명 타입 길이 비고
1 SELL 매출 String -
2 BUY 매입 String -
3 TRUSTEE 수탁 String -

A.5. Taxinvoice

순번 변수명 항목명 타입 길이 필수 비고
1 ntsconfirmNum 국세청승인번호 String 24 - 전자세금계산서의 국세청승인번호 미기재, 팝빌에서 자동으로 부여
2 issueType 발행형태 String 3 O "정발행","역발행","위수탁" 중 기재
3 taxType 과세형태 String 2 O "과세","영세","면세" 중 기재
4 issueTiming 발행시점 String - O "직접발행", "승인시자동발행" 중 기재
5 chargeDirection 과금방향 String 3 O

"정과금" 또는 "역과금" 중 기재

"역과금"은 발행형태가 "역발행"인 경우만 가능 "역과금"의 경우 공급받는자 과금

6 serialNum 일련번호 String 30 - 기재 상 '일련번호' 항목
7 kwon Integer 4 - 기재 상 책번호 '권' 항목
8 ho Integer 4 - 기재 상 책번호 '호' 항목
9 writeDate 작성일자 String 8 O 날짜형식(yyyyMMdd) 예) 20180509
10 purposeType 영수/청구 String 2 O "영수","청구" 중 기재
11 supplyCostTotal 공급가액 합계 String 18 O 숫자만 가능하며, (-) 기재도 가능
12 taxTotal 세액 합계 String 18 O 숫자만 가능하며, (-) 기재도 가능
13 totalAmount 합계금액 String 18 O 숫자만 가능하며, (-) 기재도 가능
14 cash 현금 String 18 - 기재 상 '현금' 항목
15 chkBill 수표 String 18 - 기재 상 '수표' 항목
16 credit 외상 String 18 - 기재 상 '외상' 항목
17 note 어음 String 18 - 기재 상 '어음' 항목
18 remark1 비고1 String 150 -
19 remark2 비고2 String 150 -
20 remark3 비고3 String 150 -
21 invoicerMgtKey 공급자 문서번호 String 24 정발행시 필수 공급자 문서번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
22 invoicerCorpNum 공급자 사업자번호 String 10 O 공급자 사업자번호 (하이픈 '-' 제외 10 자리)
23 invoicerTaxRegID 공급자 종사업장 식별번호 String 4 - 4자리 숫자 기재
24 invoicerCorpName 공급자 상호 String 200 O
25 invoicerCEOName 공급자 대표자 성명 String 100 O
26 invoicerAddr 공급자 주소 String 300 -
27 invoicerBizType 공급자 업태 String 100 -
28 invoicerBizClass 공급자 종목 String 100 -
29 invoicerContactName 공급자 담당자 성명 String 100 -
30 invoicerDeptName 공급자 담당자 부서명 String 100 -
31 invoicerTEL 공급자 담당자 연락처 String 20 -
32 invoicerHP 공급자 담당자 휴대폰 String 20 -
33 invoicerEmail 공급자 담당자 이메일 String 100 -
34 invoicerSMSSendYN 공급자 문자전송 여부 Boolean - -

발행시 알림문자 전송여부 (정발행에서만 사용가능)

공급받는자 주)담당자 휴대폰번호(invoiceeHP1)로 전송

전송시 포인트가 차감되며 전송실패하는 경우 포인트 환불처리

35 invoiceeMgtKey 공급받는자 문서번호 String 24 역발행시 필수 공급받는자 문서번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
36 invoiceeType 공급받는자 구분 String - O "사업자", "개인", "외국인" 중 기재
37 invoiceeCorpNum 공급받는자 사업자번호 String - O

사업자-숫자만 기재 ('-' 제외, 10 자리)

개인-주민등록번호 ('-' 제외, 13 자리)

외국인-"9999999999999" ('-' 제외, 13 자리)

38 invoiceeTaxRegID 공급받는자 종사업장 식별번호 String 4 - 4자리 숫자 기재
39 invoiceeCorpName 공급받는자 상호 String 200 O
40 invoiceeCEOName 공급받는자 대표자 성명 String 100 O
41 invoiceeAddr 공급받는자 주소 String 300 -
42 invoiceeBizType 공급받는자 업태 String 100 -
43 invoiceeBizClass 공급받는자 종목 String 100 -
44 closeDownState 공급받는자 휴폐업상태 Integer 1

null-미확인

0-미등록 / 1-사업중 / 2-폐업 / 3-휴업

45 closeDownStateDate 공급받는자 휴폐업일자 String 8 휴폐업 확정일자, 날짜형식(yyyyMMdd)
46 invoiceeContactName1 공급받는자 주) 담당자 성명 String 100 -
47 invoiceeDeptName1 공급받는자 주) 담당자 부서명 String 100 -
48 invoiceeTEL1 공급받는자 주) 담당자 연락처 String 20 -
49 invoiceeHP1 공급받는자 주) 담당자 휴대폰 String 20 -
50 invoiceeEmail1 공급받는자 주) 담당자 이메일 String 100 -
51 invoiceeContactName2 공급받는자 부) 담당자 성명 String 30 -
52 invoiceeDeptName2 공급받는자 부) 담당자 부서명 String 40 -
53 invoiceeTEL2 공급받는자 부) 담당자 연락처 String 20 -
54 invoiceeHP2 공급받는자 부) 담당자 휴대폰 String 20 -
55 invoiceeEmail2 공급받는자 부) 담당자 이메일 String 70 -

유통사업자 메일주소

미기재, 팝빌에서 자동으로 부여

56 invoiceeSMSSendYN 공급받는자 문자전송 여부 Boolean - -

역발행 요청시 알림문자 전송여부 (역발행에서만 사용가능)

공급자 담당자 휴대폰번호(invoicerHP)로 전송

전송시 포인트가 차감되며 전송실패하는 경우 포인트 환불처리

57 trusteeMgtKey 수탁자 문서번호 String 24 위수탁발행시 필수 위수탁 문서번호 (연동회원 별로 중복없이 번호 할당)
- 영문, 숫자, 하이픈('-'), 언더바('_')를 조합하여 구성
58 trusteeCorpNum 수탁자 사업자번호 String 10 - 수탁자 사업자번호 (하이픈 '-' 제외 10 자리)
59 trusteeTaxRegID 수탁자 종사업장 식별번호 String 4 - 4자리 숫자 기재
60 trusteeCorpName 수탁자 상호 String 200 -
61 trusteeCEOName 수탁자 대표자 성명 String 100 -
62 trusteeAddr 수탁자 주소 String 300 -
63 trusteeBizType 수탁자 업태 String 100 -
64 trusteeBizClass 수탁자 종목 String 100 -
65 trusteeContactName 수탁자 담당자 성명 String 100 -
66 trusteeDeptName 수탁자 담당자 부서명 String 100 -
67 trusteeTEL 수탁자 담당자 연락처 String 20 -
68 trusteeHP 수탁자 담당자 휴대폰 String 20 -
69 trusteeEmail 수탁자 담당자 이메일 String 100 -
70 trusteeSMSSendYN 수탁자 문자전송 여부 Boolean - -

발행시 알림문자 전송여부 (위수탁에서만 사용가능)

공급받는자 주)담당자 휴대폰번호(invoiceeHP1)로 전송

전송시 포인트가 차감되며 전송실패하는 경우 포인트 환불처리

71 modifyCode 수정 사유코드 Integer 1 - 수정세금계산서 작성시 필수
[참고] 수정세금계산서
72 orgNTSConfirmNum 원본 세금계산서
국세청 승인번호
String 24 - 수정세금계산서 작성시 필수
73 businessLicenseYN 사업자등록증 첨부 Boolean - - 사업자등록증이 등록되어 있어야 사용가능
74 bankBookYN 통장사본 첨부 Boolean - - 통장사본이 등록되어 있어야 사용 가능
75 detailList 상세항목 TaxinvoiceDetail[] - 배열로 99개 까지 기재 가능
76 addContactList 추가담당자 TaxinvoiceAddContact[] - 배열로 5개 까지 기재 가능

A.6. TaxinvoiceDetail

순번 변수명 항목명 타입 길이 필수 비고
1 serialNum 일련번호 Integer - O 1부터 순차기재, 99개 까지 가능
2 purchaseDT 거래일자 String 8 - 작성일자 yyyyMMdd ('-' 제외)
3 itemName 품명 String 100 -
4 spec 규격 String 60 -
5 qty 수량 String 12 - 소수점 2 자리까지 기재 가능
6 unitCost 단가 String 18 - 소수점 2 자리까지 기재 가능
7 supplyCost 공급가액 String 18 - 소수점 기재 불가, 원단위 이하는 절사
8 tax 세액 String 18 - 소수점 기재 불가, 원단위 이하는 절사
9 remark 비고 String 100 -

A.7. TaxinvoiceAddContact

순번 변수명 항목명 타입 길이 필수 비고
1 serialNum 일련번호 Integer - O 1부터 순차기재, 5개까지 기재 가능
2 contactName 담당자 성명 String 100 O
3 email 이메일 String 100 O

A.8. TISearchResult

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

A.9. TaxinvoiceInfo

순번 변수명 항목명 타입 길이 비고
1 itemKey 팝빌번호 String 18 팝빌이 부여한 식별번호
2 taxType 과세형태 String 2 과세, 영세, 면세 중 반환
3 writeDate 작성일자 String 8 날짜형식(yyyyMMdd)
4 regDT 임시저장 일자 String 8 날짜형식(yyyyMMdd)
5 issueType 발행형태 String 3 정발행, 역발행, 위수탁 중 반환
6 supplyCostTotal 공급가액 합계 String 18
7 taxTotal 세액 합계 String 18
8 purposeType 영수/청구 String 2 영수, 청구 중 반환
9 issueDT 발행일시 String 14 날짜형식(yyyyMMddHHmmss)
10 lateIssueYN 지연발행 여부 Boolean - true-지연발행 / false-정상발행
11 preIssueDT 발행예정일시 String 14 날짜형식(yyyyMMddHHmmss)
12 openYN 개봉 여부 Boolean - true-개봉 / false-미개봉
13 openDT 개봉일시 String 14 날짜형식(yyyyMMddHHmmss)
14 stateMemo 상태메모 String 200
15 stateCode 상테코드 Integer 3 [부록] "세금계산서 상태코드"
16 stateDT 상태 변경일시 String 14 날짜형식(yyyyMMddHHmmss)
17 ntsconfirmNum 국세청승인번호 String 24 전자세금계산서의 국세청승인번호
18 ntsresult 국세청 전송결과 String 6 [부록] "국세청전송 결과코드"
19 ntssendDT 국세청 전송일시 String 14 날짜형식(yyyyMMddHHmmss)
20 ntsresultDT 국세청 결과 수신일시 String 14 날짜형식(yyyyMMddHHmmss)
21 ntssendErrCode 전송실패 사유코드 String 8
22 modifyCode 수정 사유코드 Integer 1
23 interOPYN 연동문서 여부 Boolean - true-연동문서 / false-일반문서
연동문서 - API를 통해서 발행한 문서
일반문서 - 팝빌 사이트에서 발행한 문서
24 invoicerCorpName 공급자 상호 String 200
25 invoicerCorpNum 공급자 사업자번호 String 10
26 invoicerMgtKey 공급자 문서번호 String 24 파트너가 부여한 문서번호
27 invoicerPrintYN 공급자 인쇄여부 Boolean - true-인쇄 / false-미인쇄
28 invoiceeCorpName 공급받는자 상호 String 200
29 invoiceeCorpNum 공급받는자 사업자번호 String 10
30 invoiceeMgtKey 공급받는자 문서번호 String 24 파트너가 부여한 문서번호
31 invoiceePrintYN 공급받는자 인쇄여부 Boolean - true-인쇄 / false-미인쇄
32 closeDownState 공급받는자 휴폐업상태 Integer 1

null-미확인

0-미등록 / 1-사업중 / 2-폐업 / 3-휴업

33 closeDownStateDate 공급받는자 휴폐업일자 String 8 휴폐업 확정일자, 날짜형식(yyyyMMdd)
34 trusteeCorpName 수탁자 상호 String 200
35 trusteeCorpNum 수탁자 사업자번호 String 10
36 trusteeMgtKey 수탁자 문서번호 String 24 파트너가 부여한 문서번호
37 trusteePrintYN 수탁자 인쇄여부 Boolean - true-인쇄 / false-미인쇄

A.10. TaxinvoiceLog

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

A.11. AttachedFile

순번 변수명 항목명 타입 길이 비고
1 serialNum 첨부파일 일련번호 Integer 1
2 attachedFile 파일아이디 String 255 첨부파일 삭제시 사용
3 displayName 첨부파일명 String 255
4 regDT 첨부일시 String 14

A.12. TIEmailSendConfig

순번 변수명 항목명 타입 길이 비고
1 emailType 메일전송유형 String -
  • 정발행
    • ∙TAX_ISSUE : 공급받는자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_CHECK : 공급자에게 전자세금계산서가 수신확인 되었음을 알려주는 메일
    • ∙TAX_CANCEL_ISSUE : 공급받는자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
  • 발행예정
    • ∙TAX_SEND : 공급받는자에게 [발행예정] 세금계산서가 발송 되었음을 알려주는 메일
    • ∙TAX_ACCEPT : 공급자에게 [발행예정] 세금계산서가 승인 되었음을 알려주는 메일
    • ∙TAX_ACCEPT_ISSUE : 공급자에게 [발행예정] 세금계산서가 자동발행 되었음을 알려주는 메일
    • ∙TAX_DENY : 공급자에게 [발행예정] 세금계산서가 거부 되었음을 알려주는 메일
    • ∙TAX_CANCEL_SEND : 공급받는자에게 [발행예정] 세금계산서가 취소 되었음을 알려주는 메일
  • 역발행
    • ∙TAX_REQUEST : 공급자에게 세금계산서를 전자서명 하여 발행을 요청하는 메일
    • ∙TAX_CANCEL_REQUEST : 공급받는자에게 세금계산서가 취소 되었음을 알려주는 메일
    • ∙TAX_REFUSE : 공급받는자에게 세금계산서가 거부 되었음을 알려주는 메일
  • 위수탁 발행
    • ∙TAX_TRUST_ISSUE : 공급받는자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_ISSUE_TRUSTEE : 수탁자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_ISSUE : 공급받는자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_ISSUE_INVOICER : 공급자에게 전자세금계산서가 발행취소 되었음을 알려주는 메일
  • 위수탁 발행예정
    • ∙TAX_TRUST_SEND : 공급받는자에게 [발행예정] 세금계산서가 발송 되었음을 알려주는 메일
    • ∙TAX_TRUST_ACCEPT : 수탁자에게 [발행예정] 세금계산서가 승인 되었음을 알려주는 메일
    • ∙TAX_TRUST_ACCEPT_ISSUE : 수탁자에게 [발행예정] 세금계산서가 자동발행되었음을 알려주는 메일
    • ∙TAX_TRUST_DENY : 수탁자에게 [발행예정] 세금계산서가 거부 되었음을 알려주는 메일
    • ∙TAX_TRUST_CANCEL_SEND : 공급받는자에게 [발행예정] 세금계산서가 취소되었음을 알려주는 메일
  • 처리결과
    • ∙TAX_CLOSEDOWN : 거래처의 휴폐업 여부를 확인하여 안내하는 메일
    • ∙TAX_NTSFAIL_INVOICER : 전자세금계산서 국세청 전송실패를 안내하는 메일
  • 정기발송
    • ∙TAX_SEND_INFO : 전월 귀속분 [매출 발행 대기] 세금계산서의 발행을 안내하는 메일
    • ∙ETC_CERT_EXPIRATION : 팝빌에서 이용중인 공인인증서의 갱신을 안내하는 메일
2 sendYN 전송여부 Boolean - true-전송 / false-미전송

A.13. ChargeInfo

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

A.14. 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.15. 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.16. 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–사용중

A.17. EmailPublicKey

순번 변수명 항목명 타입 길이 비고
1 confirmNum 유통사업자 승인번호 String 8
2 email 유통사업자 이메일 String 40