발행

1. RegistIssue - 즉시 발행

테스트(Sandbox) 운영(Production)

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

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

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

Request

요청 헤더

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

요청 본문

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

요청 예시

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

응답 본문

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

응답 예시

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

2. Register - 임시저장

테스트(Sandbox) 운영(Production)

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

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

Request

요청 헤더

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

요청 본문

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

응답 본문

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

응답 예시

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

3. Update - 수정

테스트(Sandbox) 운영(Production)

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

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

Request

요청 헤더

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

Path 파라미터

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

요청 본문

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

응답 본문

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

응답 예시

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

4. Issue - 발행

테스트(Sandbox) 운영(Production)

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

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

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

Request

요청 헤더

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

Path 파라미터

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

요청 본문

순번	변수명	타입	길이	필수	설명
1	memo	string	200	N	전자명세서 상태 이력을 관리하기 위한 메모
2	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

응답 본문

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

응답 예시

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

5. Cancel - 발행취소

테스트(Sandbox) 운영(Production)

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

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

Request

요청 헤더

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

Path 파라미터

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

요청 본문

순번	변수명	타입	길이	필수	설명
1	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

응답 본문

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

응답 예시

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

6. Delete - 삭제

테스트(Sandbox) 운영(Production)

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

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

Request

요청 헤더

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

Path 파라미터

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

요청 예시

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

Response

응답 본문

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

응답 예시

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