발행

1. RegistIssue - 즉시 발행

POST https://popbill-test.linkhub.co.kr/Statement

POST https://popbill.linkhub.co.kr/Statement

작성된 전자명세서 데이터를 팝빌에 저장과 동시에 발행하여, "발행완료" 상태로 처리합니다.
팝빌 사이트 [ 전자명세서 > 관리 > 환경설정 ] 메뉴의 "발행시 자동승인" 옵션 설정을 통해 전자명세서를 "발행완료" 상태가 아닌 "승인대기" 상태로 발행 처리 할 수 있습니다.

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-HTTP-Method-Override	Y	요청 메서드 재정의 ISSUE
X-PB-UserID	N	팝빌회원 아이디

요청 본문

순번 변수명 타입 길이 필수 설명

itemCode

number

전자명세서 문서 유형 (택 1)

121거래명세서
122청구서
123견적서
124발주서
125입금표
126영수증

mgtKey

string

문서번호

전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

formCode

string

맞춤양식 코드

기본값 : 팝빌에서 설정한 기본양식 사용

writeDate

string

작성일자

형식 : yyyyMMdd

taxType

string

조건부

과세형태 (택 1)

과세

영세

면세

{itemCode}=121 경우 필수

purposeType

string

영수/청구 (택 1)

영수

청구

없음

serialNum string 30 N 일련번호

taxTotal

string

세액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

supplyCostTotal

string

공급가액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

totalAmount

string

합계금액

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

remark1 string 150 N 비고1

remark2 string 150 N 비고2

remark3 string 150 N 비고3

senderCorpNum string 10 Y 발신자 사업자번호 ('-' 제외)

senderTaxRegID

string

발신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

senderCorpName string 200 N 발신자 상호

senderCEOName string 100 N 발신자 대표자성명

senderAddr string 300 N 발신자 주소

senderBizType string 100 N 발신자 업태

senderBizClass string 100 N 발신자 종목

senderContactName string 100 N 발신자 성명

senderDeptName string 40 N 발신자 부서명

senderTEL string 20 N 발신자 연락처

senderHP string 20 N 발신자 휴대전화

senderEmail string 100 N 발신자 메일주소

senderFAX string 20 N 발신자 팩스번호

receiverCorpNum string 10 N 수신자 사업자번호 ('-' 제외)

receiverTaxRegID

string

수신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

receiverCorpName string 200 N 수신자 상호

receiverCEOName string 100 N 수신자 대표자성명

receiverAddr string 300 N 수신자 주소

receiverBizType string 100 N 수신자 업태

receiverBizClass string 100 N 수신자 종목

receiverContactName string 100 N 수신자 성명

receiverDeptName string 40 N 수신자 부서명

receiverTEL string 20 N 수신자 연락처

receiverHP string 20 N 수신자 휴대전화

receiverEmail string 100 N 수신자 메일주소

receiverFAX string 20 N 수신자 팩스번호

businessLicenseYN

boolean

팝빌에 등록된 사업자등록증 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

bankBookYN

boolean

팝빌에 등록된 통장사본 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

smssendYN

boolean

알림문자 전송 여부

true전송

false미전송 : 기본값

수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)

propertyBag

object

추가속성

전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성

detailList

array

거래 물품 상세정보

길이 제한 없음

변수명	타입	길이	필수	설명
serialNum	number	-	Y	일련번호 1부터 순차적으로 입력
purchaseDT	string	8	N	거래일자 형식 : yyyyMMdd
itemName	string	100	N	품명
spec	string	60	N	규격
qty	string	12	N	수량 소수점 아래 2번째 자리까지 입력 가능
unitCost	string	18	N	단가 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능
supplyCost	string	18	N	공급가액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
tax	string	18	N	세액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
remark	string	100	N	비고
spare1	string	100	N	여분1
spare2	string	100	N	여분2
spare3	string	100	N	여분3
spare4	string	100	N	여분4
spare5	string	100	N	여분5
spare6	string	100	N	여분6
spare7	string	100	N	여분7
spare8	string	100	N	여분8
spare9	string	100	N	여분9
spare10	string	100	N	여분10
spare11	string	100	N	여분11
spare12	string	100	N	여분12
spare13	string	100	N	여분13
spare14	string	100	N	여분14
spare15	string	100	N	여분15
spare16	string	100	N	여분16
spare17	string	100	N	여분17
spare18	string	100	N	여분18
spare19	string	100	N	여분19
spare20	string	100	N	여분20

memo string 200 N 전자명세서 상태 이력을 관리하기 위한 메모

emailSubject

string

300

전자명세서 발행 안내메일 제목

기본값 : 팝빌에서 설정한 안내메일 제목 사용

요청 예시

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	number	-	API 처리에 대한 응답코드 1성공
message	string	-	API 처리에 대한 응답메시지
invoiceNum	string	24	팝빌 승인번호 전자명세서 발행 시점에 팝빌에서 자동으로 할당
issueDT	string	14	발행일시 형식 : yyyyMMdd

응답 예시

{
    "code": 1,
    "message": "발행 완료",
    "invoiceNum": "123456789020251026000001",
    "issueDT": "20251026113220"
}

2. Register - 임시저장

POST https://popbill-test.linkhub.co.kr/Statement

POST https://popbill.linkhub.co.kr/Statement

작성된 전자명세서 데이터를 팝빌에 저장합니다.
"임시저장" 상태의 전자명세서는 [Issue - 발행] API를 호출하여 "발행완료" 처리한 경우에만 수신자에게 발행 안내 메일이 발송됩니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

순번 변수명 타입 길이 필수 설명

itemCode

number

전자명세서 문서 유형 (택 1)

121거래명세서
122청구서
123견적서
124발주서
125입금표
126영수증

mgtKey

string

문서번호

전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

formCode

string

맞춤양식 코드

기본값 : 팝빌에서 설정한 기본양식 사용

writeDate

string

작성일자

형식 : yyyyMMdd

taxType

string

조건부

과세형태 (택 1)

과세

영세

면세

{itemCode}=121 경우 필수

purposeType

string

영수/청구 (택 1)

영수

청구

없음

serialNum string 30 N 일련번호

taxTotal

string

세액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

supplyCostTotal

string

공급가액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

totalAmount

string

합계금액

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

remark1 string 150 N 비고1

remark2 string 150 N 비고2

remark3 string 150 N 비고3

senderCorpNum string 10 Y 발신자 사업자번호 ('-' 제외)

senderTaxRegID

string

발신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

senderCorpName string 200 N 발신자 상호

senderCEOName string 100 N 발신자 대표자성명

senderAddr string 300 N 발신자 주소

senderBizType string 100 N 발신자 업태

senderBizClass string 100 N 발신자 종목

senderContactName string 100 N 발신자 성명

senderDeptName string 40 N 발신자 부서명

senderTEL string 20 N 발신자 연락처

senderHP string 20 N 발신자 휴대전화

senderEmail string 100 N 발신자 메일주소

senderFAX string 20 N 발신자 팩스번호

receiverCorpNum string 10 N 수신자 사업자번호 ('-' 제외)

receiverTaxRegID

string

수신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

receiverCorpName string 200 N 수신자 상호

receiverCEOName string 100 N 수신자 대표자성명

receiverAddr string 300 N 수신자 주소

receiverBizType string 100 N 수신자 업태

receiverBizClass string 100 N 수신자 종목

receiverContactName string 100 N 수신자 성명

receiverDeptName string 40 N 수신자 부서명

receiverTEL string 20 N 수신자 연락처

receiverHP string 20 N 수신자 휴대전화

receiverEmail string 100 N 수신자 메일주소

receiverFAX string 20 N 수신자 팩스번호

businessLicenseYN

boolean

팝빌에 등록된 사업자등록증 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

bankBookYN

boolean

팝빌에 등록된 통장사본 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

smssendYN

boolean

알림문자 전송 여부

true전송

false미전송 : 기본값

수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)

propertyBag

object

추가속성

전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성

detailList

array

거래 물품 상세정보

길이 제한 없음

변수명	타입	길이	필수	설명
serialNum	number	-	Y	일련번호 1부터 순차적으로 입력
purchaseDT	string	8	N	거래일자 형식 : yyyyMMdd
itemName	string	100	N	품명
spec	string	60	N	규격
qty	string	12	N	수량 소수점 아래 2번째 자리까지 입력 가능
unitCost	string	18	N	단가 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능
supplyCost	string	18	N	공급가액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
tax	string	18	N	세액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
remark	string	100	N	비고
spare1	string	100	N	여분1
spare2	string	100	N	여분2
spare3	string	100	N	여분3
spare4	string	100	N	여분4
spare5	string	100	N	여분5
spare6	string	100	N	여분6
spare7	string	100	N	여분7
spare8	string	100	N	여분8
spare9	string	100	N	여분9
spare10	string	100	N	여분10
spare11	string	100	N	여분11
spare12	string	100	N	여분12
spare13	string	100	N	여분13
spare14	string	100	N	여분14
spare15	string	100	N	여분15
spare16	string	100	N	여분16
spare17	string	100	N	여분17
spare18	string	100	N	여분18
spare19	string	100	N	여분19
spare20	string	100	N	여분20

요청 예시

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	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "임시저장 완료"
}

3. Update - 수정

POST https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

POST https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-HTTP-Method-Override	Y	요청 메서드 재정의 PATCH
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	ItemCode	number	-	Y	전자명세서 문서 유형 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 본문

순번 변수명 타입 길이 필수 설명

itemCode

number

전자명세서 문서 유형 (택 1)

121거래명세서
122청구서
123견적서
124발주서
125입금표
126영수증

mgtKey

string

문서번호

전자명세서 관리를 위해 파트너가 할당하는 식별번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

formCode

string

맞춤양식 코드

기본값 : 팝빌에서 설정한 기본양식 사용

writeDate

string

작성일자

형식 : yyyyMMdd

taxType

string

조건부

과세형태 (택 1)

과세

영세

면세

{itemCode}=121 경우 필수

purposeType

string

영수/청구 (택 1)

영수

청구

없음

serialNum string 30 N 일련번호

taxTotal

string

세액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

supplyCostTotal

string

공급가액 합계

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

totalAmount

string

합계금액

정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사

remark1 string 150 N 비고1

remark2 string 150 N 비고2

remark3 string 150 N 비고3

senderCorpNum string 10 Y 발신자 사업자번호 ('-' 제외)

senderTaxRegID

string

발신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

senderCorpName string 200 N 발신자 상호

senderCEOName string 100 N 발신자 대표자성명

senderAddr string 300 N 발신자 주소

senderBizType string 100 N 발신자 업태

senderBizClass string 100 N 발신자 종목

senderContactName string 100 N 발신자 성명

senderDeptName string 40 N 발신자 부서명

senderTEL string 20 N 발신자 연락처

senderHP string 20 N 발신자 휴대전화

senderEmail string 100 N 발신자 메일주소

senderFAX string 20 N 발신자 팩스번호

receiverCorpNum string 10 N 수신자 사업자번호 ('-' 제외)

receiverTaxRegID

string

수신자 종사업장 식별번호

종사업장 식별번호는 4자리 숫자로만 구성

receiverCorpName string 200 N 수신자 상호

receiverCEOName string 100 N 수신자 대표자성명

receiverAddr string 300 N 수신자 주소

receiverBizType string 100 N 수신자 업태

receiverBizClass string 100 N 수신자 종목

receiverContactName string 100 N 수신자 성명

receiverDeptName string 40 N 수신자 부서명

receiverTEL string 20 N 수신자 연락처

receiverHP string 20 N 수신자 휴대전화

receiverEmail string 100 N 수신자 메일주소

receiverFAX string 20 N 수신자 팩스번호

businessLicenseYN

boolean

팝빌에 등록된 사업자등록증 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

bankBookYN

boolean

팝빌에 등록된 통장사본 첨부 여부

true첨부

false미첨부 : 기본값

팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록

smssendYN

boolean

알림문자 전송 여부

true전송

false미전송 : 기본값

수신자 : 수신자 휴대폰번호 {receiverHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)

propertyBag

object

추가속성

전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [참고] 기본양식 추가속성

detailList

array

거래 물품 상세정보

길이 제한 없음

변수명	타입	길이	필수	설명
serialNum	number	-	Y	일련번호 1부터 순차적으로 입력
purchaseDT	string	8	N	거래일자 형식 : yyyyMMdd
itemName	string	100	N	품명
spec	string	60	N	규격
qty	string	12	N	수량 소수점 아래 2번째 자리까지 입력 가능
unitCost	string	18	N	단가 소수점 아래 2번째 자리까지 입력 가능 마이너스 금액 입력 가능
supplyCost	string	18	N	공급가액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
tax	string	18	N	세액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
remark	string	100	N	비고
spare1	string	100	N	여분1
spare2	string	100	N	여분2
spare3	string	100	N	여분3
spare4	string	100	N	여분4
spare5	string	100	N	여분5
spare6	string	100	N	여분6
spare7	string	100	N	여분7
spare8	string	100	N	여분8
spare9	string	100	N	여분9
spare10	string	100	N	여분10
spare11	string	100	N	여분11
spare12	string	100	N	여분12
spare13	string	100	N	여분13
spare14	string	100	N	여분14
spare15	string	100	N	여분15
spare16	string	100	N	여분16
spare17	string	100	N	여분17
spare18	string	100	N	여분18
spare19	string	100	N	여분19
spare20	string	100	N	여분20

요청 예시

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	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "수정 완료"
}

4. Issue - 발행

POST https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

POST https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

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

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-HTTP-Method-Override	Y	요청 메서드 재정의 ISSUE
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	ItemCode	number	-	Y	전자명세서 문서 유형 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 본문

순번	변수명	타입	길이	필수	설명
	memo	string	200	N	세금계산서 상태 이력을 관리하기 위한 메모
	emailSubject	string	300	N	세금계산서 발행 안내메일 제목 기본값 : 팝빌에서 설정한 안내메일 제목

요청 예시

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	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "발행 완료"
}

5. Cancel - 발행취소

POST https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

POST https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-HTTP-Method-Override	Y	요청 메서드 재정의 CANCEL
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	ItemCode	number	-	Y	전자명세서 문서 유형 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 본문

순번	변수명	타입	길이	필수	설명
	memo	string	200	N	세금계산서 상태 이력을 관리하기 위한 메모

요청 예시

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	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "취소 완료"
}

6. Delete - 삭제

POST https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

POST https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}

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

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-HTTP-Method-Override	Y	요청 메서드 재정의 DELETE
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	ItemCode	number	-	Y	전자명세서 문서 유형 (택 1) 121거래명세서 122청구서 123견적서 124발주서 125입금표 126영수증
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 예시

curl --request POST \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \
  --header 'Authorization: Bearer {token}' \
  --header 'X-HTTP-Method-Override: DELETE'

Response

응답 본문

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

응답 예시

{
    "code": 1,
    "message": "삭제 완료"
}