# 발행 ## 1. RegistIssue - 즉시 발행 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ---------------------------------------------- | ----------------------------------------- | | POST | | | - 작성된 전자명세서 데이터를 팝빌에 저장과 동시에 발행하여, “발행완료” 상태로 처리합니다. - 팝빌 사이트 \[ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다. > 전자명세서 즉시 발행 API 호출 시 포인트가 차감되며, 수신자에게 발행 안내 메일이 발송됩니다. ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Content-Type `required: Y` `description: 요청 본문 형식` - `application/json` - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-HTTP-Method-Override `required: Y` `description: 요청 메서드 재정의` - `ISSUE` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **요청 본문** - itemCode `type: number` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - mgtKey `type: string` `length: 24` `required: Y` `description: 문서번호` - 전자명세서 관리를 위해 파트너가 할당하는 식별번호 - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능 - formCode `type: string` `length: 8` `required: N` `description: 맞춤양식 코드` - 기본값 : 팝빌에서 설정한 기본양식 사용 - writeDate `type: string` `length: 8` `required: Y` `description: 작성일자` - 형식 : yyyyMMdd - taxType `type: string` `length: 2` `required: 조건부` `description: 과세형태 (택 1)` - `과세` - `영세` - `면세` - {itemCode}=121 경우 필수 - purposeType `type: string` `length: 2` `required: Y` `description: 영수/청구 (택 1)` - `영수` - `청구` - `없음` - serialNum `type: string` `length: 30` `required: N` `description: 일련번호` - taxTotal `type: string` `length: 18` `required: Y` `description: 세액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - supplyCostTotal `type: string` `length: 18` `required: Y` `description: 공급가액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - totalAmount `type: string` `length: 18` `required: N` `description: 합계금액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark1 `type: string` `length: 150` `required: N` `description: 비고1` - remark2 `type: string` `length: 150` `required: N` `description: 비고2` - remark3 `type: string` `length: 150` `required: N` `description: 비고3` - senderCorpNum `type: string` `length: 10` `required: Y` `description: 발신자 사업자번호 ('-' 제외)` - senderTaxRegID `type: string` `length: 4` `required: N` `description: 발신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - senderCorpName `type: string` `length: 200` `required: N` `description: 발신자 상호` - senderCEOName `type: string` `length: 100` `required: N` `description: 발신자 대표자성명` - senderAddr `type: string` `length: 300` `required: N` `description: 발신자 주소` - senderBizType `type: string` `length: 100` `required: N` `description: 발신자 업태` - senderBizClass `type: string` `length: 100` `required: N` `description: 발신자 종목` - senderContactName `type: string` `length: 100` `required: N` `description: 발신자 성명` - senderDeptName `type: string` `length: 40` `required: N` `description: 발신자 부서명` - senderTEL `type: string` `length: 20` `required: N` `description: 발신자 연락처` - senderHP `type: string` `length: 20` `required: N` `description: 발신자 휴대전화` - senderEmail `type: string` `length: 100` `required: N` `description: 발신자 메일주소` - senderFAX `type: string` `length: 20` `required: N` `description: 발신자 팩스번호` - receiverCorpNum `type: string` `length: 10` `required: N` `description: 수신자 사업자번호 ('-' 제외)` - receiverTaxRegID `type: string` `length: 4` `required: N` `description: 수신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - receiverCorpName `type: string` `length: 200` `required: N` `description: 수신자 상호` - receiverCEOName `type: string` `length: 100` `required: N` `description: 수신자 대표자성명` - receiverAddr `type: string` `length: 300` `required: N` `description: 수신자 주소` - receiverBizType `type: string` `length: 100` `required: N` `description: 수신자 업태` - receiverBizClass `type: string` `length: 100` `required: N` `description: 수신자 종목` - receiverContactName `type: string` `length: 100` `required: N` `description: 수신자 성명` - receiverDeptName `type: string` `length: 40` `required: N` `description: 수신자 부서명` - receiverTEL `type: string` `length: 20` `required: N` `description: 수신자 연락처` - receiverHP `type: string` `length: 20` `required: N` `description: 수신자 휴대전화` - receiverEmail `type: string` `length: 100` `required: N` `description: 수신자 메일주소` - receiverFAX `type: string` `length: 20` `required: N` `description: 수신자 팩스번호` - businessLicenseYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 사업자등록증 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - bankBookYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 통장사본 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - smssendYN `type: boolean` `length: -` `required: N` `description: 알림문자 전송 여부` - `true`: 전송 - `false`: 미전송 : 기본값 - 수신자 : 수신자 휴대폰번호 {receiverHP} - 문자 전송 포인트가 차감(단, 전송실패 건은 환불) - propertyBag `type: object` `length: -` `required: N` `description: 추가속성` - 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [\[참고\] 기본양식 추가속성](https://developers.popbill.com/guide/statement/introduction/statement-form#propertybag-table) - detailList `type: array` `length: -` `required: N` `description: 거래 물품 상세정보` - 길이 제한 없음 - serialNum `type: number` `length: -` `required: Y` `description: 일련번호` - 1부터 순차적으로 입력 - purchaseDT `type: string` `length: 8` `required: N` `description: 거래일자` - 형식 : yyyyMMdd - itemName `type: string` `length: 100` `required: N` `description: 품명` - spec `type: string` `length: 60` `required: N` `description: 규격` - qty `type: string` `length: 12` `required: N` `description: 수량` - 소수점 아래 2번째 자리까지 입력 가능 - unitCost `type: string` `length: 18` `required: N` `description: 단가` - 소수점 아래 2번째 자리까지 입력 가능 - 마이너스 금액 입력 가능 - supplyCost `type: string` `length: 18` `required: N` `description: 공급가액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - tax `type: string` `length: 18` `required: N` `description: 세액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark `type: string` `length: 100` `required: N` `description: 비고` - spare1 `type: string` `length: 100` `required: N` `description: 여분1` - spare2 `type: string` `length: 100` `required: N` `description: 여분2` - spare3 `type: string` `length: 100` `required: N` `description: 여분3` - spare4 `type: string` `length: 100` `required: N` `description: 여분4` - spare5 `type: string` `length: 100` `required: N` `description: 여분5` - spare6 `type: string` `length: 100` `required: N` `description: 여분6` - spare7 `type: string` `length: 100` `required: N` `description: 여분7` - spare8 `type: string` `length: 100` `required: N` `description: 여분8` - spare9 `type: string` `length: 100` `required: N` `description: 여분9` - spare10 `type: string` `length: 100` `required: N` `description: 여분10` - spare11 `type: string` `length: 100` `required: N` `description: 여분11` - spare12 `type: string` `length: 100` `required: N` `description: 여분12` - spare13 `type: string` `length: 100` `required: N` `description: 여분13` - spare14 `type: string` `length: 100` `required: N` `description: 여분14` - spare15 `type: string` `length: 100` `required: N` `description: 여분15` - spare16 `type: string` `length: 100` `required: N` `description: 여분16` - spare17 `type: string` `length: 100` `required: N` `description: 여분17` - spare18 `type: string` `length: 100` `required: N` `description: 여분18` - spare19 `type: string` `length: 100` `required: N` `description: 여분19` - spare20 `type: string` `length: 100` `required: N` `description: 여분20` - memo `type: string` `length: 200` `required: N` `description: 전자명세서 상태 이력을 관리하기 위한 메모` - emailSubject `type: string` `length: 300` `required: N` `description: 전자명세서 발행 안내메일 제목` - 기본값 : 팝빌에서 설정한 안내메일 제목 사용 **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement' \ --header 'Authorization: Bearer {token}' \ --header 'X-HTTP-Method-Override: ISSUE' \ --header 'Content-Type: application/json' \ --data '{ "itemCode": 121, "mgtKey": "TEST202510261130", "writeDate": "20251026", "taxType": "과세", "purposeType": "청구", "senderCorpNum": "1234567890", "receiverCorpName": "수신자 상호", "supplyCostTotal": "10000", "taxTotal": "1000", "detailList": [ { "serialNum": 1, "purchaseDT": "20251117", "itemName": "품명", "spec": "규격", "qty": "1", "unitCost": "10000", "supplyCost": "10000", "tax": "1000", "remark": "비고", "spare1": "여분1" } ] }' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` - invoiceNum `type: string` `length: 24` `description: 팝빌 승인번호` - 전자명세서 발행 시점에 팝빌에서 자동으로 할당 - issueDT `type: string` `length: 14` `description: 발행일시` - 형식 : yyyyMMddHHmmss **응답 예시** ```json { "code": 1, "message": "발행 완료", "invoiceNum": "123456789020251026000001", "issueDT": "20251026113220" } ``` ## 2. Register - 임시저장 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ---------------------------------------------- | ----------------------------------------- | | POST | | | - 작성된 전자명세서 데이터를 팝빌에 저장합니다. - “임시저장” 상태의 전자명세서는 [\[Issue - 발행\]](https://developers.popbill.com/api-reference/statement/api/issue#Issue) API를 호출하여 “발행완료” 처리한 경우에만 수신자에게 발행 안내 메일이 발송됩니다. ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Content-Type `required: Y` `description: 요청 본문 형식` - `application/json` - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **요청 본문** - itemCode `type: number` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - mgtKey `type: string` `length: 24` `required: Y` `description: 문서번호` - 전자명세서 관리를 위해 파트너가 할당하는 식별번호 - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능 - formCode `type: string` `length: 8` `required: N` `description: 맞춤양식 코드` - 기본값 : 팝빌에서 설정한 기본양식 사용 - writeDate `type: string` `length: 8` `required: Y` `description: 작성일자` - 형식 : yyyyMMdd - taxType `type: string` `length: 2` `required: 조건부` `description: 과세형태 (택 1)` - `과세` - `영세` - `면세` - {itemCode}=121 경우 필수 - purposeType `type: string` `length: 2` `required: Y` `description: 영수/청구 (택 1)` - `영수` - `청구` - `없음` - serialNum `type: string` `length: 30` `required: N` `description: 일련번호` - taxTotal `type: string` `length: 18` `required: Y` `description: 세액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - supplyCostTotal `type: string` `length: 18` `required: Y` `description: 공급가액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - totalAmount `type: string` `length: 18` `required: N` `description: 합계금액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark1 `type: string` `length: 150` `required: N` `description: 비고1` - remark2 `type: string` `length: 150` `required: N` `description: 비고2` - remark3 `type: string` `length: 150` `required: N` `description: 비고3` - senderCorpNum `type: string` `length: 10` `required: Y` `description: 발신자 사업자번호 ('-' 제외)` - senderTaxRegID `type: string` `length: 4` `required: N` `description: 발신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - senderCorpName `type: string` `length: 200` `required: N` `description: 발신자 상호` - senderCEOName `type: string` `length: 100` `required: N` `description: 발신자 대표자성명` - senderAddr `type: string` `length: 300` `required: N` `description: 발신자 주소` - senderBizType `type: string` `length: 100` `required: N` `description: 발신자 업태` - senderBizClass `type: string` `length: 100` `required: N` `description: 발신자 종목` - senderContactName `type: string` `length: 100` `required: N` `description: 발신자 성명` - senderDeptName `type: string` `length: 40` `required: N` `description: 발신자 부서명` - senderTEL `type: string` `length: 20` `required: N` `description: 발신자 연락처` - senderHP `type: string` `length: 20` `required: N` `description: 발신자 휴대전화` - senderEmail `type: string` `length: 100` `required: N` `description: 발신자 메일주소` - senderFAX `type: string` `length: 20` `required: N` `description: 발신자 팩스번호` - receiverCorpNum `type: string` `length: 10` `required: N` `description: 수신자 사업자번호 ('-' 제외)` - receiverTaxRegID `type: string` `length: 4` `required: N` `description: 수신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - receiverCorpName `type: string` `length: 200` `required: N` `description: 수신자 상호` - receiverCEOName `type: string` `length: 100` `required: N` `description: 수신자 대표자성명` - receiverAddr `type: string` `length: 300` `required: N` `description: 수신자 주소` - receiverBizType `type: string` `length: 100` `required: N` `description: 수신자 업태` - receiverBizClass `type: string` `length: 100` `required: N` `description: 수신자 종목` - receiverContactName `type: string` `length: 100` `required: N` `description: 수신자 성명` - receiverDeptName `type: string` `length: 40` `required: N` `description: 수신자 부서명` - receiverTEL `type: string` `length: 20` `required: N` `description: 수신자 연락처` - receiverHP `type: string` `length: 20` `required: N` `description: 수신자 휴대전화` - receiverEmail `type: string` `length: 100` `required: N` `description: 수신자 메일주소` - receiverFAX `type: string` `length: 20` `required: N` `description: 수신자 팩스번호` - businessLicenseYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 사업자등록증 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - bankBookYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 통장사본 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - smssendYN `type: boolean` `length: -` `required: N` `description: 알림문자 전송 여부` - `true`: 전송 - `false`: 미전송 : 기본값 - 수신자 : 수신자 휴대폰번호 {receiverHP} - 문자 전송 포인트가 차감(단, 전송실패 건은 환불) - propertyBag `type: object` `length: -` `required: N` `description: 추가속성` - 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [\[참고\] 기본양식 추가속성](https://developers.popbill.com/guide/statement/introduction/statement-form#propertybag-table) - detailList `type: array` `length: -` `required: N` `description: 거래 물품 상세정보` - 길이 제한 없음 - serialNum `type: number` `length: -` `required: Y` `description: 일련번호` - 1부터 순차적으로 입력 - purchaseDT `type: string` `length: 8` `required: N` `description: 거래일자` - 형식 : yyyyMMdd - itemName `type: string` `length: 100` `required: N` `description: 품명` - spec `type: string` `length: 60` `required: N` `description: 규격` - qty `type: string` `length: 12` `required: N` `description: 수량` - 소수점 아래 2번째 자리까지 입력 가능 - unitCost `type: string` `length: 18` `required: N` `description: 단가` - 소수점 아래 2번째 자리까지 입력 가능 - 마이너스 금액 입력 가능 - supplyCost `type: string` `length: 18` `required: N` `description: 공급가액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - tax `type: string` `length: 18` `required: N` `description: 세액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark `type: string` `length: 100` `required: N` `description: 비고` - spare1 `type: string` `length: 100` `required: N` `description: 여분1` - spare2 `type: string` `length: 100` `required: N` `description: 여분2` - spare3 `type: string` `length: 100` `required: N` `description: 여분3` - spare4 `type: string` `length: 100` `required: N` `description: 여분4` - spare5 `type: string` `length: 100` `required: N` `description: 여분5` - spare6 `type: string` `length: 100` `required: N` `description: 여분6` - spare7 `type: string` `length: 100` `required: N` `description: 여분7` - spare8 `type: string` `length: 100` `required: N` `description: 여분8` - spare9 `type: string` `length: 100` `required: N` `description: 여분9` - spare10 `type: string` `length: 100` `required: N` `description: 여분10` - spare11 `type: string` `length: 100` `required: N` `description: 여분11` - spare12 `type: string` `length: 100` `required: N` `description: 여분12` - spare13 `type: string` `length: 100` `required: N` `description: 여분13` - spare14 `type: string` `length: 100` `required: N` `description: 여분14` - spare15 `type: string` `length: 100` `required: N` `description: 여분15` - spare16 `type: string` `length: 100` `required: N` `description: 여분16` - spare17 `type: string` `length: 100` `required: N` `description: 여분17` - spare18 `type: string` `length: 100` `required: N` `description: 여분18` - spare19 `type: string` `length: 100` `required: N` `description: 여분19` - spare20 `type: string` `length: 100` `required: N` `description: 여분20` **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement' \ --header 'Authorization: Bearer {token}' \ --header 'Content-Type: application/json' \ --data '{ "itemCode": 121, "mgtKey": "TEST202510261130", "writeDate": "20251026", "taxType": "과세", "purposeType": "청구", "senderCorpNum": "1234567890", "receiverCorpName": "수신자 상호", "supplyCostTotal": "10000", "taxTotal": "1000", "detailList": [ { "serialNum": 1, "purchaseDT": "20251117", "itemName": "품명", "spec": "규격", "qty": "1", "unitCost": "10000", "supplyCost": "10000", "tax": "1000", "remark": "비고", "spare1": "여분1" } ] }' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` **응답 예시** ```json { "code": 1, "message": "임시저장 완료" } ``` ## 3. Update - 수정 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------- | | POST | | | - “임시저장” 상태의 전자명세서를 수정합니다. ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Content-Type `required: Y` `description: 요청 본문 형식` - `application/json` - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-HTTP-Method-Override `required: Y` `description: 요청 메서드 재정의` - `PATCH` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **Path 파라미터** - ItemCode `type: number` `length: -` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호` **요청 본문** - itemCode `type: number` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - mgtKey `type: string` `length: 24` `required: Y` `description: 문서번호` - 전자명세서 관리를 위해 파트너가 할당하는 식별번호 - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능 - formCode `type: string` `length: 8` `required: N` `description: 맞춤양식 코드` - 기본값 : 팝빌에서 설정한 기본양식 사용 - writeDate `type: string` `length: 8` `required: Y` `description: 작성일자` - 형식 : yyyyMMdd - taxType `type: string` `length: 2` `required: 조건부` `description: 과세형태 (택 1)` - `과세` - `영세` - `면세` - {itemCode}=121 경우 필수 - purposeType `type: string` `length: 2` `required: Y` `description: 영수/청구 (택 1)` - `영수` - `청구` - `없음` - serialNum `type: string` `length: 30` `required: N` `description: 일련번호` - taxTotal `type: string` `length: 18` `required: Y` `description: 세액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - supplyCostTotal `type: string` `length: 18` `required: Y` `description: 공급가액 합계` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - totalAmount `type: string` `length: 18` `required: N` `description: 합계금액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark1 `type: string` `length: 150` `required: N` `description: 비고1` - remark2 `type: string` `length: 150` `required: N` `description: 비고2` - remark3 `type: string` `length: 150` `required: N` `description: 비고3` - senderCorpNum `type: string` `length: 10` `required: Y` `description: 발신자 사업자번호 ('-' 제외)` - senderTaxRegID `type: string` `length: 4` `required: N` `description: 발신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - senderCorpName `type: string` `length: 200` `required: N` `description: 발신자 상호` - senderCEOName `type: string` `length: 100` `required: N` `description: 발신자 대표자성명` - senderAddr `type: string` `length: 300` `required: N` `description: 발신자 주소` - senderBizType `type: string` `length: 100` `required: N` `description: 발신자 업태` - senderBizClass `type: string` `length: 100` `required: N` `description: 발신자 종목` - senderContactName `type: string` `length: 100` `required: N` `description: 발신자 성명` - senderDeptName `type: string` `length: 40` `required: N` `description: 발신자 부서명` - senderTEL `type: string` `length: 20` `required: N` `description: 발신자 연락처` - senderHP `type: string` `length: 20` `required: N` `description: 발신자 휴대전화` - senderEmail `type: string` `length: 100` `required: N` `description: 발신자 메일주소` - senderFAX `type: string` `length: 20` `required: N` `description: 발신자 팩스번호` - receiverCorpNum `type: string` `length: 10` `required: N` `description: 수신자 사업자번호 ('-' 제외)` - receiverTaxRegID `type: string` `length: 4` `required: N` `description: 수신자 종사업장 식별번호` - 종사업장 식별번호는 4자리 숫자로만 구성 - receiverCorpName `type: string` `length: 200` `required: N` `description: 수신자 상호` - receiverCEOName `type: string` `length: 100` `required: N` `description: 수신자 대표자성명` - receiverAddr `type: string` `length: 300` `required: N` `description: 수신자 주소` - receiverBizType `type: string` `length: 100` `required: N` `description: 수신자 업태` - receiverBizClass `type: string` `length: 100` `required: N` `description: 수신자 종목` - receiverContactName `type: string` `length: 100` `required: N` `description: 수신자 성명` - receiverDeptName `type: string` `length: 40` `required: N` `description: 수신자 부서명` - receiverTEL `type: string` `length: 20` `required: N` `description: 수신자 연락처` - receiverHP `type: string` `length: 20` `required: N` `description: 수신자 휴대전화` - receiverEmail `type: string` `length: 100` `required: N` `description: 수신자 메일주소` - receiverFAX `type: string` `length: 20` `required: N` `description: 수신자 팩스번호` - businessLicenseYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 사업자등록증 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - bankBookYN `type: boolean` `length: -` `required: N` `description: 팝빌에 등록된 통장사본 첨부 여부` - `true`: 첨부 - `false`: 미첨부 : 기본값 - 팝빌 사이트 또는 [\[GetSealURL - 인감 및 첨부문서 등록 팝업 URL\]](https://developers.popbill.com/api-reference/statement/api/etc#GetSealURL)을 이용하여 등록 - smssendYN `type: boolean` `length: -` `required: N` `description: 알림문자 전송 여부` - `true`: 전송 - `false`: 미전송 : 기본값 - 수신자 : 수신자 휴대폰번호 {receiverHP} - 문자 전송 포인트가 차감(단, 전송실패 건은 환불) - propertyBag `type: object` `length: -` `required: N` `description: 추가속성` - 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [\[참고\] 기본양식 추가속성](https://developers.popbill.com/guide/statement/introduction/statement-form#propertybag-table) - detailList `type: array` `length: -` `required: N` `description: 거래 물품 상세정보` - 길이 제한 없음 - serialNum `type: number` `length: -` `required: Y` `description: 일련번호` - 1부터 순차적으로 입력 - purchaseDT `type: string` `length: 8` `required: N` `description: 거래일자` - 형식 : yyyyMMdd - itemName `type: string` `length: 100` `required: N` `description: 품명` - spec `type: string` `length: 60` `required: N` `description: 규격` - qty `type: string` `length: 12` `required: N` `description: 수량` - 소수점 아래 2번째 자리까지 입력 가능 - unitCost `type: string` `length: 18` `required: N` `description: 단가` - 소수점 아래 2번째 자리까지 입력 가능 - 마이너스 금액 입력 가능 - supplyCost `type: string` `length: 18` `required: N` `description: 공급가액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - tax `type: string` `length: 18` `required: N` `description: 세액` - 정수만 입력 가능 - 마이너스 금액 입력 가능, 소수점 아래 자동 절사 - remark `type: string` `length: 100` `required: N` `description: 비고` - spare1 `type: string` `length: 100` `required: N` `description: 여분1` - spare2 `type: string` `length: 100` `required: N` `description: 여분2` - spare3 `type: string` `length: 100` `required: N` `description: 여분3` - spare4 `type: string` `length: 100` `required: N` `description: 여분4` - spare5 `type: string` `length: 100` `required: N` `description: 여분5` - spare6 `type: string` `length: 100` `required: N` `description: 여분6` - spare7 `type: string` `length: 100` `required: N` `description: 여분7` - spare8 `type: string` `length: 100` `required: N` `description: 여분8` - spare9 `type: string` `length: 100` `required: N` `description: 여분9` - spare10 `type: string` `length: 100` `required: N` `description: 여분10` - spare11 `type: string` `length: 100` `required: N` `description: 여분11` - spare12 `type: string` `length: 100` `required: N` `description: 여분12` - spare13 `type: string` `length: 100` `required: N` `description: 여분13` - spare14 `type: string` `length: 100` `required: N` `description: 여분14` - spare15 `type: string` `length: 100` `required: N` `description: 여분15` - spare16 `type: string` `length: 100` `required: N` `description: 여분16` - spare17 `type: string` `length: 100` `required: N` `description: 여분17` - spare18 `type: string` `length: 100` `required: N` `description: 여분18` - spare19 `type: string` `length: 100` `required: N` `description: 여분19` - spare20 `type: string` `length: 100` `required: N` `description: 여분20` **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \ --header 'Authorization: Bearer {token}' \ --header 'Content-Type: application/json' \ --header 'X-HTTP-Method-Override: PATCH' \ --data '{ "itemCode": 121, "mgtKey": "TEST202510261130", "writeDate": "20251026", "taxType": "과세", "purposeType": "청구", "senderCorpNum": "1234567890", "receiverCorpName": "수신자 상호", "supplyCostTotal": "10000", "taxTotal": "1000", "detailList": [ { "serialNum": 1, "purchaseDT": "20251117", "itemName": "품명", "spec": "규격", "qty": "1", "unitCost": "10000", "supplyCost": "10000", "tax": "1000", "remark": "비고", "spare1": "여분1" } ] }' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` **응답 예시** ```json { "code": 1, "message": "수정 완료" } ``` ## 4. Issue - 발행 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------- | | POST | | | - “임시저장” 상태의 전자명세서를 발행하여, “발행완료” 상태로 처리합니다. - 팝빌 사이트 \[ 전자명세서 > 관리 > 환경설정 ] 메뉴의 “발행시 자동승인” 옵션 설정을 통해 전자명세서를 “발행완료” 상태가 아닌 “승인대기” 상태로 발행 처리 할 수 있습니다. > 전자명세서 발행 API 호출 시 포인트가 차감되며, 수신자에게 발행 안내 메일이 발송됩니다. ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Content-Type `required: Y` `description: 요청 본문 형식` - `application/json` - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-HTTP-Method-Override `required: Y` `description: 요청 메서드 재정의` - `ISSUE` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **Path 파라미터** - ItemCode `type: number` `length: -` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호` **요청 본문** - memo `type: string` `length: 200` `required: N` `description: 전자명세서 상태 이력을 관리하기 위한 메모` - emailSubject `type: string` `length: 300` `required: N` `description: 전자명세서 발행 안내메일 제목` - 기본값 : 팝빌에서 설정한 안내메일 제목 **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \ --header 'Authorization: Bearer {token}' \ --header 'X-HTTP-Method-Override: ISSUE' \ --header 'Content-Type: application/json' \ --data '{ "memo": "메모", "emailSubject": "발행 안내메일 제목" }' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` **응답 예시** ```json { "code": 1, "message": "발행 완료" } ``` ## 5. Cancel - 발행취소 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------- | | POST | | | - 발신자가 발행한 전자명세서를 발행취소합니다. - “발행취소” 상태의 전자명세서를 삭제하면, 전자명세서 관리를 위해 할당했던 문서번호를 재사용 할 수 있습니다. ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Content-Type `required: Y` `description: 요청 본문 형식` - `application/json` - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-HTTP-Method-Override `required: Y` `description: 요청 메서드 재정의` - `CANCEL` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **Path 파라미터** - ItemCode `type: number` `length: -` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호` **요청 본문** - memo `type: string` `length: 200` `required: N` `description: 전자명세서 상태 이력을 관리하기 위한 메모` **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \ --header 'Authorization: Bearer {token}' \ --header 'X-HTTP-Method-Override: CANCEL' \ --header 'Content-Type: application/json' \ --data '{ "memo": "메모" }' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` **응답 예시** ```json { "code": 1, "message": "취소 완료" } ``` ## 6. Delete - 삭제 | HTTP Method | 테스트(Sandbox) | 운영(Production) | | ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------- | | POST | | | - 삭제 가능한 상태의 전자명세서를 삭제합니다.\ ※ 삭제 가능한 상태: “임시저장”, “취소”, “승인거부”, “발행취소” ### Request **요청 헤더** - Authorization `required: Y` `description: 인증 토큰` - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/statement/getting-started/authorization) - Accept-Language `required: N` `description: 응답 언어 설정` - `ko-KR`: 기본값 - `en-US` - Accept-Encoding `required: N` `description: 응답 압축 방식` - `gzip` - X-HTTP-Method-Override `required: Y` `description: 요청 메서드 재정의` - `DELETE` - X-PB-UserID `required: N` `description: 팝빌회원 아이디` **Path 파라미터** - ItemCode `type: number` `length: -` `required: Y` `description: 전자명세서 문서 유형 (택 1)` - `121`: 거래명세서 - `122`: 청구서 - `123`: 견적서 - `124`: 발주서 - `125`: 입금표 - `126`: 영수증 - MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호` **요청 예시** ```bash curl --request POST \ --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \ --header 'Authorization: Bearer {token}' \ --header 'X-HTTP-Method-Override: DELETE' ``` ### Response **응답 본문** - code `type: number` `length: -` `description: API 처리에 대한 응답코드` - `1`: 성공 - message `type: string` `length: -` `description: API 처리에 대한 응답메시지` **응답 예시** ```json { "code": 1, "message": "삭제 완료" } ```