발행

1. RegistIssue - 즉시 발행

작성된 전자명세서 데이터를 팝빌에 저장과 동시에 발행하여, “발행완료” 상태로 처리합니다.

• 팝빌 사이트 [ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다.

def registIssue(CorpNum, statement, Memo=None, UserID=None, EmailSubject=None)

전자명세서 즉시 발행 API 호출 시 포인트가 차감되며, 수신자에게 발행 안내 메일이 발송됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	statement	Statement	-	Y	전자명세서 정보
Statement 순번 변수명 타입 길이 필수 설명 1 itemCode int 3 Y 전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증 2 mgtKey str 24 Y 문서번호 → 전자명세서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 3 formCode str 8 N 맞춤양식 코드 ※ 기본값 : 팝빌에서 설정한 기본양식 사용 4 writeDate str 8 Y 작성일자 → 형식 : yyyyMMdd 5 taxType str 2 조건부 과세형태 (택 1) 과세 영세 면세 ✓ {itemCode}=121 경우 필수 6 purposeType str - Y 영수/청구 (택 1) 영수 청구 없음 7 serialNum str 30 N 일련번호 8 taxTotal str 18 Y 세액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 supplyCostTotal str 18 Y 공급가액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 10 totalAmount str 18 N 합계금액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 11 remark1 str 150 N 비고 1 12 remark2 str 150 N 비고 2 13 remark3 str 150 N 비고 3 14 senderCorpNum str 10 Y 발신자 사업자번호 ('-' 제외) 15 senderTaxRegID str 4 N 발신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 16 senderCorpName str 200 N 발신자 상호 17 senderCEOName str 100 N 발신자 대표자성명 18 senderAddr str 300 N 발신자 주소 19 senderBizType str 100 N 발신자 업태 20 senderBizClass str 100 N 발신자 종목 21 senderContactName str 100 N 발신자 성명 22 senderDeptName str 40 N 발신자 부서명 23 senderTEL str 20 N 발신자 연락처 24 senderHP str 20 N 발신자 휴대전화 25 senderEmail str 100 N 발신자 메일주소 26 senderFAX str 20 N 발신자 팩스번호 27 receiverCorpNum str 10 N 수신자 사업자번호 ('-' 제외) 28 receiverTaxRegID str 4 N 수신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 29 receiverCorpName str 200 Y 수신자 상호 30 receiverCEOName str 100 N 수신자 대표자성명 31 receiverAddr str 300 N 수신자 주소 32 receiverBizType str 100 N 수신자 업태 33 receiverBizClass str 100 N 수신자 종목 34 receiverContactName str 100 N 수신자 성명 35 receiverDeptName str 40 N 수신자 부서명 36 receiverTEL str 20 N 수신자 연락처 37 receiverHP str 20 N 수신자 휴대전화 38 receiverEmail str 100 N 수신자 메일주소 39 receiverFAX str 20 N 수신자 팩스번호 40 businessLicenseYN bool - N 팝빌에 등록된 사업자등록증 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 41 bankBookYN bool - N 팝빌에 등록된 통장사본 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 42 smssendYN bool - N 알림문자 전송 여부 True 전송 False 미전송 : 기본값 → 수신자 : 수신자 휴대폰번호 {receiverHP} 문자 전송 포인트가 차감(단, 전송실패 건은 환불) 43 propertyBag dict - N 추가속성 → 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성 44 detailList StatementDetail[] - N 거래 물품 상세정보 → 길이 제한 없음 StatementDetail[] 순번 변수명 타입 길이 필수 설명 1 serialNum int - Y 일련번호 → 1부터 순차적으로 입력 2 purchaseDT str 8 N 거래일자 → 형식 : yyyyMMdd 3 itemName str 100 N 품명 4 spec str 60 N 규격 5 qty str 12 N 수량 → 소수점 아래 2번째 자리까지 입력 가능 6 unitCost str 18 N 단가 → 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능 7 supplyCost str 18 N 공급가액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 8 tax str 18 N 세액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 remark str 100 N 비고 10 spare1 str 100 N 여분1 11 spare2 str 100 N 여분2 12 spare3 str 100 N 여분3 13 spare4 str 100 N 여분4 14 spare5 str 100 N 여분5 15 spare6 str 100 N 여분6 16 spare7 str 100 N 여분7 17 spare8 str 100 N 여분8 18 spare9 str 100 N 여분9 19 spare10 str 100 N 여분10 20 spare11 str 100 N 여분11 21 spare12 str 100 N 여분12 22 spare13 str 100 N 여분13 23 spare14 str 100 N 여분14 24 spare15 str 100 N 여분15 25 spare16 str 100 N 여분16 26 spare17 str 100 N 여분17 27 spare18 str 100 N 여분18 28 spare19 str 100 N 여분19 29 spare20 str 100 N 여분20
3	memo	str	200	N	전자명세서 상태 이력을 관리하기 위한 메모
4	UserID	str	50	N	팝빌회원 아이디
5	EmailSubject	str	300	N	전자명세서 발행 안내메일 제목 ※ 기본값 : 팝빌에서 설정한 안내메일 제목 사용

응답

IssueResponse

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지
3	invoiceNum	str	24	팝빌 승인번호 → 전자명세서 발행 시점에 팝빌에서 자동으로 할당

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지

2. Register - 임시저장

작성된 전자명세서 데이터를 팝빌에 저장합니다.

• “임시저장” 상태의 전자명세서는 [Issue - 발행] 함수를 호출하여 “발행완료” 처리한 경우에만 수신자에게 발행 안내 메일이 발송됩니다.

def register(CorpNum, statement, UserID=None)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	statement	Statement	-	Y	전자명세서 정보
Statement 순번 변수명 타입 길이 필수 설명 1 itemCode int 3 Y 전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증 2 mgtKey str 24 Y 문서번호 → 전자명세서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 3 formCode str 8 N 맞춤양식 코드 ※ 기본값 : 팝빌에서 설정한 기본양식 사용 4 writeDate str 8 Y 작성일자 → 형식 : yyyyMMdd 5 taxType str 2 조건부 과세형태 (택 1) 과세 영세 면세 ✓ {itemCode}=121 경우 필수 6 purposeType str - Y 영수/청구 (택 1) 영수 청구 없음 7 serialNum str 30 N 일련번호 8 taxTotal str 18 Y 세액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 supplyCostTotal str 18 Y 공급가액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 10 totalAmount str 18 N 합계금액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 11 remark1 str 150 N 비고 1 12 remark2 str 150 N 비고 2 13 remark3 str 150 N 비고 3 14 senderCorpNum str 10 Y 발신자 사업자번호 ('-' 제외) 15 senderTaxRegID str 4 N 발신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 16 senderCorpName str 200 N 발신자 상호 17 senderCEOName str 100 N 발신자 대표자성명 18 senderAddr str 300 N 발신자 주소 19 senderBizType str 100 N 발신자 업태 20 senderBizClass str 100 N 발신자 종목 21 senderContactName str 100 N 발신자 성명 22 senderDeptName str 40 N 발신자 부서명 23 senderTEL str 20 N 발신자 연락처 24 senderHP str 20 N 발신자 휴대전화 25 senderEmail str 100 N 발신자 메일주소 26 senderFAX str 20 N 발신자 팩스번호 27 receiverCorpNum str 10 N 수신자 사업자번호 ('-' 제외) 28 receiverTaxRegID str 4 N 수신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 29 receiverCorpName str 200 Y 수신자 상호 30 receiverCEOName str 100 N 수신자 대표자성명 31 receiverAddr str 300 N 수신자 주소 32 receiverBizType str 100 N 수신자 업태 33 receiverBizClass str 100 N 수신자 종목 34 receiverContactName str 100 N 수신자 성명 35 receiverDeptName str 40 N 수신자 부서명 36 receiverTEL str 20 N 수신자 연락처 37 receiverHP str 20 N 수신자 휴대전화 38 receiverEmail str 100 N 수신자 메일주소 39 receiverFAX str 20 N 수신자 팩스번호 40 businessLicenseYN bool - N 팝빌에 등록된 사업자등록증 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 41 bankBookYN bool - N 팝빌에 등록된 통장사본 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 42 smssendYN bool - N 알림문자 전송 여부 True 전송 False 미전송 : 기본값 → 수신자 : 수신자 휴대폰번호 {receiverHP} 문자 전송 포인트가 차감(단, 전송실패 건은 환불) 43 propertyBag dict - N 추가속성 → 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성 44 detailList StatementDetail[] - N 거래 물품 상세정보 → 길이 제한 없음 StatementDetail[] 순번 변수명 타입 길이 필수 설명 1 serialNum int - Y 일련번호 → 1부터 순차적으로 입력 2 purchaseDT str 8 N 거래일자 → 형식 : yyyyMMdd 3 itemName str 100 N 품명 4 spec str 60 N 규격 5 qty str 12 N 수량 → 소수점 아래 2번째 자리까지 입력 가능 6 unitCost str 18 N 단가 → 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능 7 supplyCost str 18 N 공급가액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 8 tax str 18 N 세액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 remark str 100 N 비고 10 spare1 str 100 N 여분1 11 spare2 str 100 N 여분2 12 spare3 str 100 N 여분3 13 spare4 str 100 N 여분4 14 spare5 str 100 N 여분5 15 spare6 str 100 N 여분6 16 spare7 str 100 N 여분7 17 spare8 str 100 N 여분8 18 spare9 str 100 N 여분9 19 spare10 str 100 N 여분10 20 spare11 str 100 N 여분11 21 spare12 str 100 N 여분12 22 spare13 str 100 N 여분13 23 spare14 str 100 N 여분14 24 spare15 str 100 N 여분15 25 spare16 str 100 N 여분16 26 spare17 str 100 N 여분17 27 spare18 str 100 N 여분18 28 spare19 str 100 N 여분19 29 spare20 str 100 N 여분20
3	UserID	str	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지

3. Update - 수정

“임시저장” 상태의 전자명세서를 수정합니다.

def update(CorpNum, ItemCode, MgtKey, Statement, UserID=None)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ItemCode	int	3	Y	전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증
3	MgtKey	str	24	Y	파트너가 할당한 문서번호
4	Statement	Statement	-	Y	전자명세서 정보
Statement 순번 변수명 타입 길이 필수 설명 1 itemCode int 3 Y 전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증 2 mgtKey str 24 Y 문서번호 → 전자명세서 관리를 위해 파트너가 할당하는 식별번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 3 formCode str 8 N 맞춤양식 코드 ※ 기본값 : 팝빌에서 설정한 기본양식 사용 4 writeDate str 8 Y 작성일자 → 형식 : yyyyMMdd 5 taxType str 2 조건부 과세형태 (택 1) 과세 영세 면세 ✓ {itemCode}=121 경우 필수 6 purposeType str - Y 영수/청구 (택 1) 영수 청구 없음 7 serialNum str 30 N 일련번호 8 taxTotal str 18 Y 세액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 supplyCostTotal str 18 Y 공급가액 합계 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 10 totalAmount str 18 N 합계금액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 11 remark1 str 150 N 비고 1 12 remark2 str 150 N 비고 2 13 remark3 str 150 N 비고 3 14 senderCorpNum str 10 Y 발신자 사업자번호 ('-' 제외) 15 senderTaxRegID str 4 N 발신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 16 senderCorpName str 200 N 발신자 상호 17 senderCEOName str 100 N 발신자 대표자성명 18 senderAddr str 300 N 발신자 주소 19 senderBizType str 100 N 발신자 업태 20 senderBizClass str 100 N 발신자 종목 21 senderContactName str 100 N 발신자 성명 22 senderDeptName str 40 N 발신자 부서명 23 senderTEL str 20 N 발신자 연락처 24 senderHP str 20 N 발신자 휴대전화 25 senderEmail str 100 N 발신자 메일주소 26 senderFAX str 20 N 발신자 팩스번호 27 receiverCorpNum str 10 N 수신자 사업자번호 ('-' 제외) 28 receiverTaxRegID str 4 N 수신자 종사업장 식별번호 → 종사업장 식별번호는 4자리 숫자로만 구성 29 receiverCorpName str 200 Y 수신자 상호 30 receiverCEOName str 100 N 수신자 대표자성명 31 receiverAddr str 300 N 수신자 주소 32 receiverBizType str 100 N 수신자 업태 33 receiverBizClass str 100 N 수신자 종목 34 receiverContactName str 100 N 수신자 성명 35 receiverDeptName str 40 N 수신자 부서명 36 receiverTEL str 20 N 수신자 연락처 37 receiverHP str 20 N 수신자 휴대전화 38 receiverEmail str 100 N 수신자 메일주소 39 receiverFAX str 20 N 수신자 팩스번호 40 businessLicenseYN bool - N 팝빌에 등록된 사업자등록증 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 41 bankBookYN bool - N 팝빌에 등록된 통장사본 첨부 여부 True 첨부 False 미첨부 : 기본값 → 팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록 42 smssendYN bool - N 알림문자 전송 여부 True 전송 False 미전송 : 기본값 → 수신자 : 수신자 휴대폰번호 {receiverHP} 문자 전송 포인트가 차감(단, 전송실패 건은 환불) 43 propertyBag dict - N 추가속성 → 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성 44 detailList StatementDetail[] - N 거래 물품 상세정보 → 길이 제한 없음 StatementDetail[] 순번 변수명 타입 길이 필수 설명 1 serialNum int - Y 일련번호 → 1부터 순차적으로 입력 2 purchaseDT str 8 N 거래일자 → 형식 : yyyyMMdd 3 itemName str 100 N 품명 4 spec str 60 N 규격 5 qty str 12 N 수량 → 소수점 아래 2번째 자리까지 입력 가능 6 unitCost str 18 N 단가 → 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능 7 supplyCost str 18 N 공급가액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 8 tax str 18 N 세액 → 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사 9 remark str 100 N 비고 10 spare1 str 100 N 여분1 11 spare2 str 100 N 여분2 12 spare3 str 100 N 여분3 13 spare4 str 100 N 여분4 14 spare5 str 100 N 여분5 15 spare6 str 100 N 여분6 16 spare7 str 100 N 여분7 17 spare8 str 100 N 여분8 18 spare9 str 100 N 여분9 19 spare10 str 100 N 여분10 20 spare11 str 100 N 여분11 21 spare12 str 100 N 여분12 22 spare13 str 100 N 여분13 23 spare14 str 100 N 여분14 24 spare15 str 100 N 여분15 25 spare16 str 100 N 여분16 26 spare17 str 100 N 여분17 27 spare18 str 100 N 여분18 28 spare19 str 100 N 여분19 29 spare20 str 100 N 여분20
5	UserID	str	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지

4. Issue - 발행

“임시저장” 상태의 전자명세서를 발행하여, “발행완료” 상태로 처리합니다.

• 팝빌 사이트 [ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다.

def issue(CorpNum, ItemCode, MgtKey, Memo=None, EmailSubject=None, UserID=None)

전자명세서 발행 API 호출 시 포인트가 차감되며, 수신자에게 발행 안내 메일이 발송됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ItemCode	int	3	Y	전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증
3	MgtKey	str	24	Y	파트너가 할당한 문서번호
4	Memo	str	200	N	전자명세서 상태 이력을 관리하기 위한 메모
5	EmailSubject	str	300	N	전자명세서 발행 안내메일 제목 ※ 기본값 : 팝빌에서 설정한 안내메일 제목 사용
6	UserID	str	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지

5. Cancel - 발행취소

발신자가 발행한 전자명세서를 발행취소합니다.

• “발행취소” 상태의 전자명세서를 삭제하면, 전자명세서 관리를 위해 할당했던 문서번호를 재사용 할 수 있습니다.

def cancel(CorpNum, ItemCode, MgtKey, Memo=None, UserID=None)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ItemCode	int	3	Y	전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증
3	MgtKey	str	24	Y	파트너가 할당한 문서번호
4	Memo	str	200	N	전자명세서 상태 이력을 관리하기 위한 메모
5	UserID	str	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지

6. Delete - 삭제

삭제 가능한 상태의 전자명세서를 삭제합니다.
※ 삭제 가능한 상태: “임시저장”, “취소”, “승인거부”, “발행취소”

def delete(CorpNum, ItemCode, MgtKey, UserID=None)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ItemCode	int	3	Y	전자명세서 문서 유형 (택 1) 121 거래명세서 122 청구서 123 견적서 124 발주서 125 입금표 126 영수증
3	MgtKey	str	24	Y	파트너가 할당한 문서번호
4	UserID	str	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	int	-	API 처리에 대한 응답코드 1 성공
2	message	str	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	int	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	str	-	API 처리 실패에 대한 오류메시지