API Reference 전자명세서 Node.js 전자명세서 발행
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