POPBill Developers
연동신청
  • 가이드 0
  • 레퍼런스 0
  • 오류코드 0
전자명세서
  • 전자세금계산서
  • 현금영수증
  • 전자명세서
  • 홈택스수집(세금)
  • 홈택스수집(현금)
  • 사업자등록상태조회
  • 기업정보조회
  • 계좌조회
  • 예금주조회
  • 카카오톡
  • 문자
  • 팩스
API 레퍼런스

정보확인

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)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
itemCode number 3 전자명세서 문서 유형
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
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)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
요청 본문
순번 변수명 타입 길이 필수 설명
- array - Y 문서번호 목록
최대 : 1,000건
요청 예시
curl --request POST \
  --url 'https://{domain}/Statement/{ItemCode}' \
  --header 'Authorization: Bearer {token}' \
  --data '["TEST0001", "TEST0002"]'
Response
응답 본문
순번 변수명 타입 길이 설명
itemCode number 3 전자명세서 문서 유형
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
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)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
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 전자명세서 문서 유형
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
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 - 거래 물품 상세정보
길이 제한 없음
순번 변수명 타입 길이 설명
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
응답 예시
{
    "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)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
itemCode number 3 전자명세서 문서 유형
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
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",
}

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)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}/Logs' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
docLogType number 3 로그타입
  • 100임시저장
  • 101수정
  • 102개봉
  • 103수신확인
  • 111메일 재전송
  • 112문자 재전송
  • 113팩스 재전송
  • 122문자 전송결과
  • 123팩스 전송결과
  • 310발행
  • 312자동승인
  • 340발행취소
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
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 접근 메뉴 (택 1)
  • TBOX임시 문서함
  • SWBOX발행 문서함
요청 예시
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="
}