정보확인
1. GetInfo - 상태 확인
GET
https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET
https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
- 전자명세서의 1건의 상태 및 요약정보를 확인합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Path 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| ItemCode | number | - | Y |
전자명세서 문서 유형 (택 1)
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 |
요청 예시
curl --request GET \
--url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| itemCode | number | 3 |
전자명세서 문서 유형
|
|
| itemKey | string | 18 |
팝빌번호
팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
|
|
| invoiceNum | string | 24 |
팝빌 승인번호
전자명세서 발행 시점에 팝빌에서 자동으로 할당
|
|
| mgtKey | string | 24 | 파트너가 할당한 문서번호 | |
| taxType | string | 2 |
과세형태
과세
영세
면세
|
|
| writeDate | string | 8 |
작성일자
형식 : yyyyMMdd
|
|
| regDT | string | 14 |
임시저장일시
형식 : yyyyMMddHHmmss
|
|
| senderCorpName | string | 200 | 발신자 상호 | |
| senderCorpNum | string | 10 | 발신자 사업자번호 | |
| senderPrintYN | boolean | - |
발신자 인쇄여부
true인쇄
false미인쇄
|
|
| receiverCorpName | string | 200 | 수신자 상호 | |
| receiverCorpNum | string | 10 | 수신자 사업자번호 | |
| receiverPrintYN | boolean | - |
수신자 인쇄여부
true인쇄
false미인쇄
|
|
| supplyCostTotal | string | 18 |
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| taxTotal | string | 18 |
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| purposeType | string | 2 |
영수/청구
영수
청구
없음
|
|
| issueDT | string | 14 |
발행일시
형식 : yyyyMMddHHmmss
|
|
| stateCode | number | 3 | 상태코드 | |
| stateDT | string | 14 |
상태 변경일시
형식 : yyyyMMddHHmmss
|
|
| stateMemo | string | 200 | 상태메모 | |
| openYN | boolean | - |
개봉여부
true개봉
false미개봉
|
|
| openDT | string | 14 |
개봉 일시
형식 : yyyyMMddHHmmss
|
응답 예시
{
"itemCode": 121,
"itemKey": "025102118531000001",
"invoiceNum": "123456789020251021000003",
"mgtKey": "20251021_004",
"taxType": "과세",
"writeDate": "20251021",
"regDT": "20251021185310",
"senderCorpName": "테스트 상호",
"senderCorpNum": "1234567890",
"senderPrnumberYN": false,
"receiverCorpName": "공급받는자 상호",
"receiverCorpNum": "8888888888",
"receiverPrnumberYN": false,
"supplyCostTotal": "200000",
"taxTotal": "20000",
"purposeType": "영수",
"issueDT": "20251021185310",
"stateCode": 200,
"stateDT": "20251021185310",
"openYN": false,
"stateMemo": ""
}
2. GetInfos - 다수건 상태 확인
POST
https://popbill-test.linkhub.co.kr/Statement/{ItemCode}
POST
https://popbill.linkhub.co.kr/Statement/{ItemCode}
- 다수건의 전자명세서 상태 및 요약정보를 확인합니다. (1회 호출에 최대 1,000건 확인 가능)
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Path 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| ItemCode | number | - | Y |
전자명세서 문서 유형 (택 1)
|
요청 본문
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| - | array | - | Y |
문서번호 목록
최대 : 1,000건
|
요청 예시
curl --request POST \
--url 'https://{domain}/Statement/{ItemCode}' \
--header 'Authorization: Bearer {token}' \
--data '["TEST0001", "TEST0002"]'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| itemCode | number | 3 |
전자명세서 문서 유형
|
|
| itemKey | string | 18 |
팝빌번호
팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
|
|
| invoiceNum | string | 24 |
팝빌 승인번호
전자명세서 발행 시점에 팝빌에서 자동으로 할당
|
|
| mgtKey | string | 24 | 파트너가 할당한 문서번호 | |
| taxType | string | 2 |
과세형태
과세
영세
면세
|
|
| writeDate | string | 8 |
작성일자
형식 : yyyyMMdd
|
|
| regDT | string | 14 |
임시저장일시
형식 : yyyyMMddHHmmss
|
|
| senderCorpName | string | 200 | 발신자 상호 | |
| senderCorpNum | string | 10 | 발신자 사업자번호 | |
| senderPrintYN | boolean | - |
발신자 인쇄여부
true인쇄
false미인쇄
|
|
| receiverCorpName | string | 200 | 수신자 상호 | |
| receiverCorpNum | string | 10 | 수신자 사업자번호 | |
| receiverPrintYN | boolean | - |
수신자 인쇄여부
true인쇄
false미인쇄
|
|
| supplyCostTotal | string | 18 |
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| taxTotal | string | 18 |
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| purposeType | string | 2 |
영수/청구
영수
청구
없음
|
|
| issueDT | string | 14 |
발행일시
형식 : yyyyMMddHHmmss
|
|
| stateCode | number | 3 | 상태코드 | |
| stateDT | string | 14 |
상태 변경일시
형식 : yyyyMMddHHmmss
|
|
| stateMemo | string | 200 | 상태메모 | |
| openYN | boolean | - |
개봉여부
true개봉
false미개봉
|
|
| openDT | string | 14 |
개봉 일시
형식 : yyyyMMddHHmmss
|
응답 예시
[
{
"itemCode": 121,
"itemKey": "025102118531000001",
"invoiceNum": "123456789020251021000003",
"mgtKey": "20251021_004",
"taxType": "과세",
"writeDate": "20251021",
"regDT": "20251021185310",
"senderCorpName": "테스트 상호",
"senderCorpNum": "1234567890",
"senderPrnumberYN": false,
"receiverCorpName": "공급받는자 상호",
"receiverCorpNum": "8888888888",
"receiverPrnumberYN": false,
"supplyCostTotal": "200000",
"taxTotal": "20000",
"purposeType": "영수",
"issueDT": "20251021185310",
"stateCode": 200,
"stateDT": "20251021185310",
"openYN": false,
"stateMemo": ""
}
]
3. GetDetailInfo - 상세정보 확인
GET
https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET
https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
- 전자명세서 1건의 상세정보를 확인합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Path 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| ItemCode | number | - | Y |
전자명세서 문서 유형 (택 1)
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 |
Query 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| Detail | - | - | Y |
상세 정보
빈값으로 입력
|
요청 예시
curl --request GET \
--url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?Detail' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| itemCode | number | 3 |
전자명세서 문서 유형
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| mgtKey | string | 24 |
문서번호
전자명세서 관리를 위해 파트너가 할당하는 식별번호
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| invoiceNum | string | 24 |
팝빌 승인번호
전자명세서 발행 시점에 팝빌에서 자동으로 할당
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| formCode | string | 8 | 맞춤양식 코드 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| writeDate | string | 8 |
작성일자
형식 : yyyyMMdd
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| taxType | string | 2 |
과세형태
과세
영세
면세
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| purposeType | string | - |
영수/청구
영수
청구
없음
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| serialNum | string | 30 | 일련번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| supplyCostTotal | string | 18 | 공급가액 합계 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| taxTotal | string | 18 | 세액 합계 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalAmount | string | 18 | 합계금액 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| remark1 | string | 150 | 비고1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| remark2 | string | 150 | 비고2 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| remark3 | string | 150 | 비고3 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderCorpNum | string | 10 | 발신자 사업자번호 ('-' 제외) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderTaxRegID | string | 4 |
발신자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderCorpName | string | 200 | 발신자 상호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderCEOName | string | 100 | 발신자 대표자성명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderAddr | string | 300 | 발신자 주소 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderBizType | string | 100 | 발신자 업태 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderBizClass | string | 100 | 발신자 종목 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderContactName | string | 100 | 발신자 성명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderDeptName | string | 40 | 발신자 부서명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderTEL | string | 20 | 발신자 연락처 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderHP | string | 20 | 발신자 휴대전화 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderEmail | string | 100 | 발신자 메일주소 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| senderFAX | string | 20 | 발신자 팩스번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverCorpNum | string | 10 | 수신자 사업자번호 ('-' 제외) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverTaxRegID | string | 4 | 수신자 종사업장 식별번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverCorpName | string | 200 | 수신자 상호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverCEOName | string | 100 | 수신자 대표자성명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverAddr | string | 300 | 수신자 주소 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverBizType | string | 100 | 수신자 업태 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverBizClass | string | 100 | 수신자 종목 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverContactName | string | 100 | 수신자 성명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverDeptName | string | 40 | 수신자 부서명 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverTEL | string | 20 | 수신자 연락처 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverHP | string | 20 | 수신자 휴대전화 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverEmail | string | 100 | 수신자 메일주소 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| receiverFAX | string | 20 | 수신자 팩스번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| businessLicenseYN | boolean | - |
팝빌에 등록된 사업자등록증 첨부 여부
true첨부
false미첨부
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| bankBookYN | boolean | - |
팝빌에 등록된 통장사본 첨부 여부
true첨부
false미첨부
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| smssendYN | boolean | - |
알림문자 전송 여부
true전송
false미전송
수신자 : 수신자 휴대폰번호 {receiverHP}
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| propertyBag | object | - | 추가속성 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| detailList | array | - |
거래 물품 상세정보
길이 제한 없음
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
응답 예시
{
"itemCode": 121,
"mgtKey": "20251021_004",
"invoiceNum": "123456789020251021000003",
"writeDate": "20251021",
"taxType": "과세",
"senderCorpNum": "1234567890",
"senderCorpName": "테스트 상호",
"senderCEOName": "테스트 대표",
"senderTaxRegID": "",
"senderAddr": "테스트 주소",
"senderBizClass": "테스트 종목",
"senderBizType": "테스트 업태",
"senderContactName": "테스트 담당자 성명",
"senderDeptName": "테스트 부서명",
"senderTEL": "070-111-222",
"senderHP": "010-000-222",
"senderEmail": "test@test.com",
"receiverCorpNum": "8888888888",
"receiverCorpName": "공급받는자 상호",
"receiverCEOName": "공급받는자 대표자 성명",
"receiverTaxRegID": "",
"receiverAddr": "공급받는자 주소",
"receiverBizClass": "공급받는자 업종",
"receiverContactName": "공급받는자 담당자명",
"receiverTEL": "010-0000-1111",
"receiverHP": "010-1111-2222",
"receiverEmail": "test@test.com",
"supplyCostTotal": "200000",
"serialNum": "123",
"taxTotal": "20000",
"totalAmount": "220000",
"purposeType": "영수",
"remark1": "비고1",
"remark2": "비고2",
"remark3": "비고3",
"faxsendYN": false,
"businessLicenseYN": false,
"bankBookYN": false,
"autoAcceptYN": false,
"smssendYN": false,
"detailList": [
{
"serialNum": 1,
"purchaseDT": "20201006",
"itemName": "Item Name 01",
"spec": "spec",
"qty": "1",
"unitCost": "110000",
"supplyCost": "100000",
"tax": "10000",
"remark": "Item reamrk"
},
],
"propertyBag": {}
}
4. CheckMgtKeyInUse - 문서번호 사용 여부 확인
GET
https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET
https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
- 파트너가 전자명세서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
- 응답 본문의 itemKey 필드에 값이 존재하면 사용 중인 문서번호이며, 값이 존재하지 않으면 사용 가능한 문서번호 입니다.
- 이미 사용 중인 문서번호는 중복 사용이 불가하고, 전자명세서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Path 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| ItemCode | number | - | Y |
전자명세서 문서 유형 (택 1)
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 |
요청 예시
curl --request GET \
--url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| itemCode | number | 3 |
전자명세서 문서 유형
|
|
| itemKey | string | 18 |
팝빌번호
팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
|
|
| invoiceNum | string | 24 |
팝빌 승인번호
전자명세서 발행 시점에 팝빌에서 자동으로 할당
|
|
| mgtKey | string | 24 | 파트너가 할당한 문서번호 | |
| taxType | string | 2 |
과세형태
과세
영세
면세
|
|
| writeDate | string | 8 |
작성일자
형식 : yyyyMMdd
|
|
| regDT | string | 14 |
임시저장일시
형식 : yyyyMMddHHmmss
|
|
| senderCorpName | string | 200 | 발신자 상호 | |
| senderCorpNum | string | 10 | 발신자 사업자번호 | |
| senderPrintYN | boolean | - |
발신자 인쇄여부
true인쇄
false미인쇄
|
|
| receiverCorpName | string | 200 | 수신자 상호 | |
| receiverCorpNum | string | 10 | 수신자 사업자번호 | |
| receiverPrintYN | boolean | - |
수신자 인쇄여부
true인쇄
false미인쇄
|
|
| supplyCostTotal | string | 18 |
공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| taxTotal | string | 18 |
세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사 |
|
| purposeType | string | 2 |
영수/청구
영수
청구
없음
|
|
| issueDT | string | 14 |
발행일시
형식 : yyyyMMddHHmmss
|
|
| stateCode | number | 3 | 상태코드 | |
| stateDT | string | 14 |
상태 변경일시
형식 : yyyyMMddHHmmss
|
|
| stateMemo | string | 200 | 상태메모 | |
| openYN | boolean | - |
개봉여부
true개봉
false미개봉
|
|
| openDT | string | 14 |
개봉 일시
형식 : yyyyMMddHHmmss
|
응답 예시
{
"itemKey": "025102118531000001",
}
5. Search - 목록 조회
GET
https://popbill-test.linkhub.co.kr/Statement/Search
GET
https://popbill.linkhub.co.kr/Statement/Search
- 검색조건에 해당하는 전자명세서를 조회합니다. (최대 조회기간 : 6개월)
- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Query 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| DType | string | 1 | Y |
검색일자 유형 (택 1)
R등록일자
W작성일자
I발행일자
|
|
| SDate | string | 8 | Y |
검색 시작일자
형식 : yyyyMMdd
|
|
| EDate | string | 8 | Y |
검색 종료일자
형식 : yyyyMMdd
|
|
| State | string | - | N |
전자명세서 상태코드
2, 3번째 자리에 와일드카드(*) 사용가능. 예) 1**,3**
[참고] 팝빌 상태코드
기본값 : 전체조회
|
|
| ItemCode | number | - | N |
전자명세서 문서 유형 (다중 선택 가능)
다중 선택시 콤마(',')로 구분. 예) 121,122
기본값 : 전체조회
|
|
| QString | string | - | N |
조회 검색어(거래처 상호/사업자번호)
기본값 : 전체조회
|
|
| Page | number | - | Y |
목록 페이지번호
기본값 : 1
|
|
| PerPage | number | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
| Order | string | 1 | N |
조회 기준일자 유형을 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
요청 예시
curl --request GET \
--url 'https://{domain}/Statement/Search?DType={DType}&SDate={SDate}&EDate={EDate}' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | number | - |
API 처리에 대한 응답코드
1성공
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| message | string | - | API 처리에 대한 응답메시지 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| total | string | - | 총 검색결과 건수 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| perPage | string | - | 페이지당 목록 건수 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pageNum | string | - | 페이지 번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pageCount | string | - | 페이지 개수 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| list | array | - |
전자명세서 상태/요약정보
[GetInfo – 상태 확인] API의 리턴값 구성과 동일
최대 : 1,000건 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
응답 예시
{
"code": 1,
"total": 14,
"perPage": 500,
"pageNum": 1,
"pageCount": 1,
"list": [
{
"invoicerPrintYN": false,
"invoiceeCorpName": "공급받는자 상호",
"invoiceePrintYN": false,
"trusteePrintYN": false,
"taxTotal": "10000",
"supplyCostTotal": "100000",
"lateIssueYN": false,
"stateCode": 100,
"taxType": "과세",
"purposeType": "영수",
"itemKey": "025102220380000001",
"interOPYN": true,
"writeDate": "20251022",
"issueType": "정발행",
"openYN": false,
"invoicerCorpNum": "1234567890",
"invoicerMgtKey": "20251022-10",
"invoicerCorpName": "공급자 상호",
"invoiceeCorpNum": "8888888888",
"regDT": "20251022203801",
"stateDT": "20251022203801"
},
]
"message": "검색 완료"
}
6. GetLogs - 상태 변경이력 확인
GET
https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}/Logs
GET
https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}/Logs
- 전자명세서의 상태에 대한 변경이력을 확인합니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Path 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| ItemCode | number | - | Y |
전자명세서 문서 유형 (택 1)
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 |
요청 예시
curl --request GET \
--url 'https://{domain}/Statement/{ItemCode}/{MgtKey}/Logs' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| docLogType | number | 3 |
로그타입
|
|
| log | string | 2000 | 이력정보 | |
| procType | string | 3 |
처리형태
연동API를 통해 처리함
일반팝빌 사이트를 통해 처리함
시스템팝빌이 처리함
|
|
| procCorpName | string | 70 | 처리회사명 | |
| procContactName | string | 30 | 처리담당자 | |
| procMemo | string | 200 | 처리메모 | |
| regDT | string | 14 |
등록일시
형식 : yyyyMMddHHmmss
|
|
| ip | string | 39 | 아이피 |
응답 예시
[
{
"ip": "112.***.**.27",
"docLogType": 310,
"procType": "연동",
"procMemo": "담당자 이메일 : test@test.com",
"log": "발행 되었습니다.",
"procCorpName": "처리회사명",
"procContactName": "처리담당자",
"regDT": "20251021185310"
}
]
7. GetURL - 문서함 팝업 URL
GET
https://popbill-test.linkhub.co.kr/Statement
GET
https://popbill.linkhub.co.kr/Statement
- 전자명세서 문서함의 팝업 URL을 반환합니다.
- 권장 사이즈 : width = 1,280px (최소 1,000px) / height = 800px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL은 팝빌회원의 로그인 세션을 포함하고 있으니 사용에 유의하여 주시기 바랍니다.
Request
요청 헤더
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | 인증 토큰 | |
| Accept-Language | N |
응답 언어 설정
ko-KR: 기본값
en-US
|
|
| Accept-Encoding | N | 응답 압축 방식 gzip |
|
| X-PB-UserID | N | 팝빌회원 아이디 |
Query 파라미터
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| TG | string | - | Y |
접근 메뉴 (택 1)
|
요청 예시
curl --request GET \
--url 'https://{domain}/Statement?TG={TG}' \
--header 'Authorization: Bearer {token}'
Response
응답 본문
| 순번 | 변수명 | 타입 | 길이 | 설명 |
|---|---|---|---|---|
| url | string | - | 전자명세서 문서함 팝업 URL |
응답 예시
{
"url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}
