콘텐츠로 이동

발행

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

  • 팝빌 사이트 [ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다.
STMIssueResponse RegistIssue(string CorpNum, Statement statement, string Memo = null, string UserID = null, string EmailSubject = null)

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

Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2statement-Y
전자명세서 정보
Statement
순번변수명타입길이필수설명
1itemCodeint?3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
2mgtKeystring24Y
문서번호
전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
3formCodestring8N
맞춤양식 코드
기본값 : 팝빌에서 설정한 기본양식 사용
4writeDatestring8Y
작성일자
형식 : yyyyMMdd
5taxTypestring2조건부
과세형태 (택 1)
  • 과세
  • 영세
  • 면세
{itemCode}=121 경우 필수
6purposeTypestring2Y
영수/청구 (택 1)
  • 영수
  • 청구
  • 없음
7serialNumstring30N
일련번호
8taxTotalstring18Y
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9supplyCostTotalstring18Y
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
10totalAmountstring18N
합계금액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
11remark1string150N
비고 1
12remark2string150N
비고 2
13remark3string150N
비고 3
14senderCorpNumstring10Y
발신자 사업자번호 ('-' 제외)
15senderTaxRegIDstring4N
발신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
16senderCorpNamestring200N
발신자 상호
17senderCEONamestring100N
발신자 대표자성명
18senderAddrstring300N
발신자 주소
19senderBizTypestring100N
발신자 업태
20senderBizClassstring100N
발신자 종목
21senderContactNamestring100N
발신자 성명
22senderDeptNamestring40N
발신자 부서명
23senderTELstring20N
발신자 연락처
24senderHPstring20N
발신자 휴대전화
25senderEmailstring100N
발신자 메일주소
26senderFAXstring20N
발신자 팩스번호
27receiverCorpNumstring10N
수신자 사업자번호 ('-' 제외)
28receiverTaxRegIDstring4N
수신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
29receiverCorpNamestring200Y
수신자 상호
30receiverCEONamestring100N
수신자 대표자성명
31receiverAddrstring300N
수신자 주소
32receiverBizTypestring100N
수신자 업태
33receiverBizClassstring100N
수신자 종목
34receiverContactNamestring100N
수신자 성명
35receiverDeptNamestring40N
수신자 부서명
36receiverTELstring20N
수신자 연락처
37receiverHPstring20N
수신자 휴대전화
38receiverEmailstring100N
수신자 메일주소
39receiverFAXstring20N
수신자 팩스번호
40businessLicenseYNbool-N
팝빌에 등록된 사업자등록증 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
41bankBookYNbool-N
팝빌에 등록된 통장사본 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
42smssendYNbool?-N
알림문자 전송 여부
  • true 전송
  • false 미전송 : 기본값
수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
43propertyBagpropertyBag-N
추가속성
전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성
44detailList-N
거래 물품 상세정보
길이 제한 없음
List<StatementDetail>
순번변수명타입길이필수설명
1serialNumint?-Y
일련번호
1부터 순차적으로 입력
2purchaseDTstring8N
거래일자
형식 : yyyyMMdd
3itemNamestring100N
품명
4specstring60N
규격
5qtystring12N
수량
소수점 아래 2번째 자리까지 입력 가능
6unitCoststring18N
단가
소수점 아래 2번째 자리까지 입력 가능
마이너스 금액 입력 가능
7supplyCoststring18N
공급가액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
8taxstring18N
세액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9remarkstring100N
비고
10spare1string100N
여분1
11spare2string100N
여분2
12spare3string100N
여분3
13spare4string100N
여분4
14spare5string100N
여분5
15spare6string100N
여분6
16spare7string100N
여분7
17spare8string100N
여분8
18spare9string100N
여분9
19spare10string100N
여분10
20spare11string100N
여분11
21spare12string100N
여분12
22spare13string100N
여분13
23spare14string100N
여분14
24spare15string100N
여분15
25spare16string100N
여분16
26spare17string100N
여분17
27spare18string100N
여분18
28spare19string100N
여분19
29spare20string100N
여분20
3Memostring200N
전자명세서 상태 이력을 관리하기 위한 메모
4UserIDstring50N
팝빌회원 아이디
5EmailSubjectstring300N
전자명세서 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
STMIssueResponse
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
3invoiceNumstring24
팝빌 승인번호
전자명세서 발행 시점에 팝빌에서 자동으로 할당
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지

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

  • “임시저장” 상태의 전자명세서는 [Issue - 발행] 함수를 호출하여 “발행완료” 처리한 경우에만 수신자에게 발행 안내 메일이 발송됩니다.
Response Register(string CorpNum, Statement statement, string UserID = null)
Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2statement-Y
전자명세서 정보
Statement
순번변수명타입길이필수설명
1itemCodeint?3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
2mgtKeystring24Y
문서번호
전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
3formCodestring8N
맞춤양식 코드
기본값 : 팝빌에서 설정한 기본양식 사용
4writeDatestring8Y
작성일자
형식 : yyyyMMdd
5taxTypestring2조건부
과세형태 (택 1)
  • 과세
  • 영세
  • 면세
{itemCode}=121 경우 필수
6purposeTypestring2Y
영수/청구 (택 1)
  • 영수
  • 청구
  • 없음
7serialNumstring30N
일련번호
8taxTotalstring18Y
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9supplyCostTotalstring18Y
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
10totalAmountstring18N
합계금액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
11remark1string150N
비고 1
12remark2string150N
비고 2
13remark3string150N
비고 3
14senderCorpNumstring10Y
발신자 사업자번호 ('-' 제외)
15senderTaxRegIDstring4N
발신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
16senderCorpNamestring200N
발신자 상호
17senderCEONamestring100N
발신자 대표자성명
18senderAddrstring300N
발신자 주소
19senderBizTypestring100N
발신자 업태
20senderBizClassstring100N
발신자 종목
21senderContactNamestring100N
발신자 성명
22senderDeptNamestring40N
발신자 부서명
23senderTELstring20N
발신자 연락처
24senderHPstring20N
발신자 휴대전화
25senderEmailstring100N
발신자 메일주소
26senderFAXstring20N
발신자 팩스번호
27receiverCorpNumstring10N
수신자 사업자번호 ('-' 제외)
28receiverTaxRegIDstring4N
수신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
29receiverCorpNamestring200Y
수신자 상호
30receiverCEONamestring100N
수신자 대표자성명
31receiverAddrstring300N
수신자 주소
32receiverBizTypestring100N
수신자 업태
33receiverBizClassstring100N
수신자 종목
34receiverContactNamestring100N
수신자 성명
35receiverDeptNamestring40N
수신자 부서명
36receiverTELstring20N
수신자 연락처
37receiverHPstring20N
수신자 휴대전화
38receiverEmailstring100N
수신자 메일주소
39receiverFAXstring20N
수신자 팩스번호
40businessLicenseYNbool-N
팝빌에 등록된 사업자등록증 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
41bankBookYNbool-N
팝빌에 등록된 통장사본 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
42smssendYNbool?-N
알림문자 전송 여부
  • true 전송
  • false 미전송 : 기본값
수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
43propertyBagpropertyBag-N
추가속성
전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성
44detailList-N
거래 물품 상세정보
길이 제한 없음
List<StatementDetail>
순번변수명타입길이필수설명
1serialNumint?-Y
일련번호
1부터 순차적으로 입력
2purchaseDTstring8N
거래일자
형식 : yyyyMMdd
3itemNamestring100N
품명
4specstring60N
규격
5qtystring12N
수량
소수점 아래 2번째 자리까지 입력 가능
6unitCoststring18N
단가
소수점 아래 2번째 자리까지 입력 가능
마이너스 금액 입력 가능
7supplyCoststring18N
공급가액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
8taxstring18N
세액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9remarkstring100N
비고
10spare1string100N
여분1
11spare2string100N
여분2
12spare3string100N
여분3
13spare4string100N
여분4
14spare5string100N
여분5
15spare6string100N
여분6
16spare7string100N
여분7
17spare8string100N
여분8
18spare9string100N
여분9
19spare10string100N
여분10
20spare11string100N
여분11
21spare12string100N
여분12
22spare13string100N
여분13
23spare14string100N
여분14
24spare15string100N
여분15
25spare16string100N
여분16
26spare17string100N
여분17
27spare18string100N
여분18
28spare19string100N
여분19
29spare20string100N
여분20
3UserIDstring50N
팝빌회원 아이디
Response
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지

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

Response Update(string CorpNum, int itemCode, string mgtKey, Statement statement, string UserID = null)
Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2itemCodeint3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
3mgtKeystring24Y
파트너가 할당한 문서번호
4statement-Y
전자명세서 정보
Statement
순번변수명타입길이필수설명
1itemCodeint?3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
2mgtKeystring24Y
문서번호
전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
3formCodestring8N
맞춤양식 코드
기본값 : 팝빌에서 설정한 기본양식 사용
4writeDatestring8Y
작성일자
형식 : yyyyMMdd
5taxTypestring2조건부
과세형태 (택 1)
  • 과세
  • 영세
  • 면세
{itemCode}=121 경우 필수
6purposeTypestring2Y
영수/청구 (택 1)
  • 영수
  • 청구
  • 없음
7serialNumstring30N
일련번호
8taxTotalstring18Y
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9supplyCostTotalstring18Y
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
10totalAmountstring18N
합계금액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
11remark1string150N
비고 1
12remark2string150N
비고 2
13remark3string150N
비고 3
14senderCorpNumstring10Y
발신자 사업자번호 ('-' 제외)
15senderTaxRegIDstring4N
발신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
16senderCorpNamestring200N
발신자 상호
17senderCEONamestring100N
발신자 대표자성명
18senderAddrstring300N
발신자 주소
19senderBizTypestring100N
발신자 업태
20senderBizClassstring100N
발신자 종목
21senderContactNamestring100N
발신자 성명
22senderDeptNamestring40N
발신자 부서명
23senderTELstring20N
발신자 연락처
24senderHPstring20N
발신자 휴대전화
25senderEmailstring100N
발신자 메일주소
26senderFAXstring20N
발신자 팩스번호
27receiverCorpNumstring10N
수신자 사업자번호 ('-' 제외)
28receiverTaxRegIDstring4N
수신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
29receiverCorpNamestring200Y
수신자 상호
30receiverCEONamestring100N
수신자 대표자성명
31receiverAddrstring300N
수신자 주소
32receiverBizTypestring100N
수신자 업태
33receiverBizClassstring100N
수신자 종목
34receiverContactNamestring100N
수신자 성명
35receiverDeptNamestring40N
수신자 부서명
36receiverTELstring20N
수신자 연락처
37receiverHPstring20N
수신자 휴대전화
38receiverEmailstring100N
수신자 메일주소
39receiverFAXstring20N
수신자 팩스번호
40businessLicenseYNbool-N
팝빌에 등록된 사업자등록증 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
41bankBookYNbool-N
팝빌에 등록된 통장사본 첨부 여부
  • true 첨부
  • false 미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
42smssendYNbool?-N
알림문자 전송 여부
  • true 전송
  • false 미전송 : 기본값
수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
43propertyBagpropertyBag-N
추가속성
전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성
44detailList-N
거래 물품 상세정보
길이 제한 없음
List<StatementDetail>
순번변수명타입길이필수설명
1serialNumint?-Y
일련번호
1부터 순차적으로 입력
2purchaseDTstring8N
거래일자
형식 : yyyyMMdd
3itemNamestring100N
품명
4specstring60N
규격
5qtystring12N
수량
소수점 아래 2번째 자리까지 입력 가능
6unitCoststring18N
단가
소수점 아래 2번째 자리까지 입력 가능
마이너스 금액 입력 가능
7supplyCoststring18N
공급가액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
8taxstring18N
세액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
9remarkstring100N
비고
10spare1string100N
여분1
11spare2string100N
여분2
12spare3string100N
여분3
13spare4string100N
여분4
14spare5string100N
여분5
15spare6string100N
여분6
16spare7string100N
여분7
17spare8string100N
여분8
18spare9string100N
여분9
19spare10string100N
여분10
20spare11string100N
여분11
21spare12string100N
여분12
22spare13string100N
여분13
23spare14string100N
여분14
24spare15string100N
여분15
25spare16string100N
여분16
26spare17string100N
여분17
27spare18string100N
여분18
28spare19string100N
여분19
29spare20string100N
여분20
5UserIDstring50N
팝빌회원 아이디
Response
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지

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

  • 팝빌 사이트 [ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다.
Response Issue(string CorpNum, int itemCode, string mgtKey, string Memo = null, string UserID = null, string EmailSubject = null)

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

Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2itemCodeint3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
3mgtKeystring24Y
파트너가 할당한 문서번호
4Memostring200N
전자명세서 상태 이력을 관리하기 위한 메모
5UserIDstring50N
팝빌회원 아이디
6EmailSubjectstring300N
전자명세서 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목 사용
Response
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지

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

  • “발행취소” 상태의 전자명세서를 삭제하면, 전자명세서 관리를 위해 할당했던 문서번호를 재사용 할 수 있습니다.
Response Cancel(string CorpNum, int itemCode, string mgtKey, string Memo = null, string UserID = null)
Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2itemCodeint3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
3mgtKeystring24Y
파트너가 할당한 문서번호
4Memostring200N
전자명세서 상태 이력을 관리하기 위한 메모
5UserIDstring50N
팝빌회원 아이디
Response
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지

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

Response Delete(string CorpNum, int itemCode, string mgtKey, string UserID = null)
Parameters
순번 변수명 타입 길이 필수 설명
1CorpNumstring10Y
팝빌회원 사업자번호 ('-' 제외)
2itemCodeint3Y
전자명세서 문서 유형 (택 1)
  • 121 거래명세서
  • 122 청구서
  • 123 견적서
  • 124 발주서
  • 125 입금표
  • 126 영수증
3mgtKeystring24Y
파트너가 할당한 문서번호
4UserIDstring50N
팝빌회원 아이디
Response
순번 변수명 타입 길이 설명
1codelong-
API 처리에 대한 응답코드
  • 1 성공
2messagestring-
API 처리에 대한 응답메시지
PopbillException
순번 변수명 타입 길이 설명
1codelong-
API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
2Messagestring-
API 처리 실패에 대한 오류메시지