POPBill Developers
API Reference

1. 전자명세서 발행

1.1. RegistIssue - 즉시 발행

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

IssueResponse

Throws

PopbillException

1.2. Register - 임시저장

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

Response

Throws

PopbillException

1.3. Update - 수정

  • "임시저장" 상태의 전자명세서를 수정합니다.
statementService.update(CorpNum, ItemCode, MgtKey, Statement, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
ItemCode number 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
Statement Statement - Y 전자명세서 객체정보
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

Response

Throws

PopbillException

1.4. Issue - 발행

  • "임시저장" 상태의 전자명세서를 발행하여, "발행완료" 상태로 처리합니다.
  • 팝빌 사이트 [전자명세서] > [환경설정] > [전자명세서 관리] 메뉴의 발행시 자동승인 옵션 설정을 통해 전자명세서를 "발행완료" 상태가 아닌 "승인대기" 상태로 발행 처리 할 수 있습니다.
statementService.issue(CorpNum, ItemCode, MgtKey, Memo, EmailSubject, UserID, success, error)
  • 전자명세서 발행 함수 호출시 포인트가 과금되며, 수신자에게 발행 안내 메일이 발송됩니다.
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
ItemCode number 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 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

Response

Throws

PopbillException

1.5. Cancel - 발행취소

  • 발신자가 발행한 전자명세서를 발행취소합니다.
  • "발행취소" 상태의 전자명세서를 삭제하면, 전자명세서 관리를 위해 할당했던 문서번호를 재사용 할 수 있습니다.
statementService.cancel(CorpNum, ItemCode, MgtKey, Memo, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
ItemCode number 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
Memo string 200 N 전자명세서 상태 이력을 관리하기 위한 메모
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

Response

Throws

PopbillException

1.6. Delete - 삭제

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

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

statementService.delete(CorpNum, ItemCode, MgtKey, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
ItemCode number 3 Y 전자명세서 문서유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

Response

Throws

PopbillException