튜토리얼
Node.js 개발환경에서 팝빌 SDK를 추가하여 전자명세서 즉시 발행 (RegistIssue) 함수를 구현하는 예시입니다.
1. POPBiLL SDK 추가
팝빌 Node.js SDK를 추가하기 위해 Express 프로젝트 "package.json" 파일에 팝빌 Node.js SDK 정보를 추가하고 npm install 또는 npm update를 진행합니다.
{
"name": "Popbill TEST",
"version": "0.0.0",
"private": true,
"scripts": {
"start": "node ./bin/www"
},
"dependencies": {
"cookie-parser": "~1.4.3",
"debug": "~2.6.9",
"ejs": "~2.5.7",
"express": "~4.16.0",
"http-errors": "~1.6.2",
"morgan": "~1.9.0",
"popbill": "^1.60.4"
}
}2. POPBiLL SDK 설정
프로젝트 routes 폴더 하위의 index.js 파일에 연동신청시 발급받은 API Key 를 변수로 선언하고 아래의 코드를 참조하여 전자명세서 서비스 객체를 생성 합니다.
// 생략..
var popbill = require('popbill');
popbill.config( {
// 링크아이디
LinkID :'TESTER',
// 비밀키
SecretKey : 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3T=',
// 연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
IsTest : true,
// 통신 IP 고정, true-사용, false-미사용, (기본값:true)
IPRestrictOnOff: true,
// 팝빌 API 서비스 고정 IP 사용여부, 기본값(false)
UseStaticIP: false,
// 로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:true)
UseLocalTimeYN: true,
defaultErrorHandler: function (Error) {
console.log('Error Occur : [' + Error.code + '] ' + Error.message);
}
});
// 전자명세서 서비스 객체 초기화
var statementService = popbill.StatementService();
// 생략..
3. RegistIssue 기능 구현
index.js 파일에 전자명세서 즉시 발행 (RegistIssue) 함수 호출 코드를 추가합니다.
router.get('/registIssue', function (req, res, next) {
// 팝빌회원 사업자번호, '-' 제외 10자리
var testCorpNum = '1234567890';
// 명세서 코드 - 121(거래명세서), 122(청구서), 123(견적서), 124(발주서), 125(입금표), 126(영수증)
var ItemCode = 121;
// 문서번호, 1~24자리 영문, 숫자, '-', '_' 조합으로 구성, 사업자별로 중복되지 않도록 생성
var MgtKey = '20220101-031';
// 전자명세서 정보
var statement = {
// [필수] 기재상 작성일자, 날짜형식(yyyyMMdd)
writeDate: '20220101',
// [필수] 영수, 청구, 없음 중 기재
purposeType: '영수',
// [필수] 과세형태, 과세, 영세, 면세 중 기재
taxType: '과세',
// 맞춤양식코드, 미기재시 기본양식으로 작성
formCode: '',
// [필수] 명세서 코드
itemCode: ItemCode,
// [필수] 문서번호
mgtKey: MgtKey,
/*************************************************************************
* 발신자 정보
**************************************************************************/
// 발신자 사업자번호
senderCorpNum: testCorpNum,
// 발신자 상호
senderCorpName: '발신자 상호',
// 발신자 주소
senderAddr: '발신자 주소',
// 발신자 대표자 성명
senderCEOName: '발신자 대표자 성명',
// 종사업장 식별번호, 필요시기재, 형식은 숫자 4자리
senderTaxRegID: '',
// 발신자 종목
senderBizClass: '종목',
// 발신자 업태
senderBizType: '업태',
// 발신자 담당자명
senderContactName: '담당자명',
// 발신자 메일주소
senderEmail: 'test@test.com',
// 발신자 연락처
senderTEL: '070-4304-2991',
// 발신자 휴대폰번호
senderHP: '000-111-222',
/*************************************************************************
* 수신자 정보
**************************************************************************/
// 수신자 사업자번호
receiverCorpNum: '8888888888',
// 수신자 상호
receiverCorpName: '수신자상호',
// 수신자 대표자 성명
receiverCEOName: '수신자 대표자 성명',
// 수신자 주소
receiverAddr: '수신자 주소',
// 수신자 종사업장 식별번호, 필요시 기재
recieverTaxRegID: '',
// 수신자 종목
receiverBizClass: '종목',
// 수신자 업태
receiverBizType: '업태',
// 수신자 담당자명
receiverContactName: '수신자 담당자 성명',
// 수신자 메일주소
// 팝빌 개발환경에서 테스트하는 경우에도 안내 메일이 전송되므로,
// 실제 거래처의 메일주소가 기재되지 않도록 주의
receiverEmail: 'test@test.com',
// 수신자 연락처
receiverTEL: '070-1111-2222',
// 수신자 휴대폰 번호
receiverHP: '000111222',
/*************************************************************************
* 전자명세서 기재정보
**************************************************************************/
// [필수] 공급가액 합계
supplyCostTotal: '20000',
// [필수] 세액 합계
taxTotal: '2000',
// [필수] 합계금액 (공급가액 합계+ 세액 합계)
totalAmount: '22000',
// 기재 상 '일련번호' 항목
serialNum: '1',
// 기재 상 '비고' 항목
remark1: '비고1',
remark2: '비고2',
remark3: '비고3',
// 사업자등록증 이미지 첨부 여부
businessLicenseYN: false,
// 통장사본 이미지 첨부 여부
bankBookYN: false,
/*************************************************************************
* 상세9항목(품목) 정보
**************************************************************************/
detailList: [
{
serialNum: 1, // 품목 일련번호 1부터 순차기재
itemName: '품명',
purchaseDT: '20220101', // 구매일자
qty: '1', // 수량
unitCost: '10000', // 단가
spec: '규격', // 규격
supplyCost: '10000', // 공급가액
tax: '1000', // 세액
remark: '비고'
},
{
serialNum: 2, // 품목 일련번호 1부터 순차기재
itemName: '품명2',
purchaseDT: '20220101', // 구매일자
qty: '1', // 수량
unitCost: '10000', // 단가
spec: '규격', // 규격
supplyCost: '10000', // 공급가액
tax: '1000', // 세액
remark: '비고'
}
],
/*************************************************************************
* 전자명세서 추가속성
**************************************************************************/
propertyBag: {
Balance: '2000', // 전잔액
Deposit: '500', // 입금액
CBalance: '2500' // 현잔액
}
};
statementService.registIssue(testCorpNum, statement,
function (result) {
res.render('response', {path: req.path, code: result.code, message: result.message});
}, function (Error) {
res.render('response', {path: req.path, code: Error.code, message: Error.message});
});
});함수 호출결과 코드와 메시지를 출력하는 "/views/response.ejs" 파일을 추가합니다.
<!DOCTYPE html>
<!DOCTYPE html>
<html>
<head>
<title>Popbill Statement</title>
</head>
<body>
<div>
<p>Response</p>
<br/>
<fieldset>
<ul>
<li>응답코드 (Response.code) : <%= code %></li>
<li>응답메시지 (Response.message) : <%= message %></li>
</ul>
</fieldset>
</div>
</body>
</html>4. 결과 확인
함수 호출 반환 결과는 아래와 같습니다.
- 성공 : Response code 로 숫자 1 반환
- 실패 : PopbillException 으로 음의 정수 8자리 숫자값 오류코드와 오류메시지 반환 [오류코드]