POPBill Developers
API Reference

1. 전자명세서 발행

1.1. RegistIssue - 즉시 발행

  • 작성된 전자명세서 데이터를 팝빌에 저장과 동시에 발행하여, "발행완료" 상태로 처리합니다.
  • 팝빌 사이트 [전자명세서] > [환경설정] > [전자명세서 관리] 메뉴의 발행시 자동승인 옵션 설정을 통해 전자명세서를 "발행완료" 상태가 아닌 "승인대기" 상태로 발행 처리 할 수 있습니다.
def registIssue(corpNum, statement, memo = '', userID ='', emailSubject = '')
  • 전자명세서 즉시 발행 함수 호출시 포인트가 과금되며, 수신자에게 발행 안내 메일이 발송됩니다.
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
statement Statement - Y 전자명세서 객체정보
memo String 200 N 전자명세서 상태 이력을 관리하기 위한 메모
userID String 50 N 팝빌회원 아이디
emailSubject String 300 N 전자명세서 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
Return

IssueResponse

Throws

PopbillException

1.2. Register - 임시저장

  • 작성된 전자명세서 데이터를 팝빌에 저장합니다.
  • "임시저장" 상태의 전자명세서는 [Issue - 발행] 함수를 호출하여 "발행완료" 처리한 경우에만 수신자에게 발행 안내 메일이 발송됩니다.
def register(corpNum, statement, userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
statement Statement - Y 전자명세서 객체정보
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

1.3. Update - 수정

  • "임시저장" 상태의 전자명세서를 수정합니다.
def update(corpNum, itemCode, mgtKey, statement, userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
itemCode Integer 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
mgtKey String 24 Y 파트너가 할당한 문서번호
statement Statement - Y 전자명세서 객체정보
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

1.4. Issue - 발행

  • "임시저장" 상태의 전자명세서를 발행하여, "발행완료" 상태로 처리합니다.
  • 팝빌 사이트 [전자명세서] > [환경설정] > [전자명세서 관리] 메뉴의 발행시 자동승인 옵션 설정을 통해 전자명세서를 "발행완료" 상태가 아닌 "승인대기" 상태로 발행 처리 할 수 있습니다.
def issue(corpNum, itemCode, mgtKey, memo ='', emailSubject = '', userID ='')
  • 전자명세서 발행 함수 호출시 포인트가 과금되며, 수신자에게 발행 안내 메일이 발송됩니다.
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
itemCode Integer 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
mgtKey String 24 Y 파트너가 할당한 문서번호
memo String 200 N 전자명세서 상태 이력을 관리하기 위한 메모
emailSubject String 300 N 전자명세서 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

1.5. Cancel - 발행취소

  • 발신자가 발행한 전자명세서를 발행취소합니다.
  • "발행취소" 상태의 전자명세서를 삭제하면, 전자명세서 관리를 위해 할당했던 문서번호를 재사용 할 수 있습니다.
def cancel(corpNum, itemCode, mgtKey, memo = '', userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
itemCode Integer 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
mgtKey String 24 Y 파트너가 할당한 문서번호
memo String 200 N 전자명세서 상태 이력을 관리하기 위한 메모
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

1.6. Delete - 삭제

  • 삭제 가능한 상태의 전자명세서를 삭제합니다.

    ※ 삭제 가능한 상태: "임시저장", "취소", "승인거부", "발행취소"

def delete(corpNum, itemCode, mgtKey, userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
itemCode Integer 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
mgtKey String 24 Y 파트너가 할당한 문서번호
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException