정보확인

1. GetInfo - 상태 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

세금계산서 1건의 상태 및 요약정보를 확인합니다.
리턴값 stateCode를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
itemKey	string	18	팝빌에서 할당한 식별번호
taxType	string	2	과세형태 과세 영세 면세
writeDate	string	8	작성일자 형식 : yyyyMMdd
regDT	string	14	임시저장 일시 형식 : yyyyMMddHHmmss
issueType	string	3	발행형태 정발행 역발행 위수탁
supplyCostTotal	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
purposeType	string	2	영수/청구 영수 청구 없음
issueDT	string	14	발행일시 형식 : yyyyMMddHHmmss
lateIssueYN	boolean	-	지연발행 여부 true지연발행 false정상발행
openYN	boolean	-	개봉 여부 true개봉 false미개봉 {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
openDT	string	14	개봉일시 형식 : yyyyMMddHHmmss
stateMemo	string	200	상태메모
stateCode	string	3	상태코드 [참고] 팝빌 상태코드
stateDT	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
ntsconfirmNum	string	18	국세청승인번호 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
ntsresult	string	6	국세청 전송결과
ntssendDT	string	14	국세청 전송일시 형식 : yyyyMMddHHmmss
ntsresultDT	string	14	국세청 결과 수신일시 형식 : yyyyMMddHHmmss
ntssendErrCode	string	6	국세청 결과코드 [참고] 국세청 결과코드
modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 [참고] 수정세금계산서
interOPYN	boolean	-	연동문서 여부 trueAPI를 통해 발행한 연동문서 false팝빌 사이트를 통해 발행한 문서
invoicerCorpName	string	200	공급자 상호
invoicerCorpNum	string	10	공급자 사업자번호
invoicerMgtKey	string	24	공급자 문서번호 파트너가 할당한 문서번호
invoicerPrintYN	boolean	-	공급자 인쇄여부 true인쇄 false미인쇄
invoiceeCorpName	string	200	공급받는자 상호
invoiceeCorpNum	string	13	공급받는자 사업자번호
invoiceeMgtKey	string	24	공급받는자 문서번호 파트너가 할당한 문서번호
invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true인쇄 false미인쇄
closeDownState	number	1	공급받는자 휴폐업상태 null미확인 0미등록 1사업중 2폐업 3휴업 4확인실패
closeDownStateDate	string	8	공급받는자 휴폐업일자 형식 : yyyyMMdd
trusteeCorpName	string	200	수탁자 상호
trusteeCorpNum	string	10	수탁자 사업자번호
trusteeMgtKey	string	24	수탁자 문서번호 파트너가 할당한 문서번호
trusteePrintYN	boolean	-	수탁자 인쇄여부 true인쇄 false미인쇄

응답 예시

{
    "invoiceePrintYN": false,
    "openYN": false,
    "taxType": "과세",
    "invoicerCorpNum": "1234567890",
    "invoicerMgtKey": "MKGTKEY-0002",
    "invoicerCorpName": "공급자 상호",
    "invoicerPrintYN": false,
    "invoiceeCorpName": "공급받는자 상호",
    "trusteePrintYN": false,
    "taxTotal": "1000",
    "supplyCostTotal": "10000",
    "purposeType": "영수",
    "ntsconfirmNum": "202510168888888800000002",
    "closeDownState": 0,
    "lateIssueYN": false,
    "stateCode": 300,
    "interOPYN": true,
    "itemKey": "025102114360700001",
    "issueDT": "20251021143607",
    "stateDT": "20251021143608",
    "regDT": "20251021143608",
    "invoiceeCorpNum": "1234567890",
    "issueType": "정발행",
    "writeDate": "20251016"
}

2. GetInfos - 다수건 상태 확인

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}

POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}

다수건의 세금계산서 상태 및 요약 정보를 확인합니다. (1회 호출에 최대 1,000건 확인 가능)
리턴값의 변수 stateCode를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁

요청 본문

순번	변수명	타입	길이	필수	설명
	-	array	-	Y	문서번호 목록 최대 : 1,000건

요청 예시

curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}' \
  --header 'Authorization: Bearer {token}' \
  --data '["TEST0001", "TEST0002"]'

Response

응답 본문

변수명	타입	길이	설명
itemKey	string	18	팝빌에서 할당한 식별번호
taxType	string	2	과세형태 과세 영세 면세
writeDate	string	8	작성일자 형식 : yyyyMMdd
regDT	string	14	임시저장 일시 형식 : yyyyMMddHHmmss
issueType	string	3	발행형태 정발행 역발행 위수탁
supplyCostTotal	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
purposeType	string	2	영수/청구 영수 청구 없음
issueDT	string	14	발행일시 형식 : yyyyMMddHHmmss
lateIssueYN	boolean	-	지연발행 여부 true지연발행 false정상발행
openYN	boolean	-	개봉 여부 true개봉 false미개봉 {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
openDT	string	14	개봉일시 형식 : yyyyMMddHHmmss
stateMemo	string	200	상태메모
stateCode	string	3	상태코드 [참고] 팝빌 상태코드
stateDT	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
ntsconfirmNum	string	18	국세청승인번호 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
ntsresult	string	6	국세청 전송결과
ntssendDT	string	14	국세청 전송일시 형식 : yyyyMMddHHmmss
ntsresultDT	string	14	국세청 결과 수신일시 형식 : yyyyMMddHHmmss
ntssendErrCode	string	6	국세청 결과코드 [참고] 국세청 결과코드
modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 [참고] 수정세금계산서
interOPYN	boolean	-	연동문서 여부 trueAPI를 통해 발행한 연동문서 false팝빌 사이트를 통해 발행한 문서
invoicerCorpName	string	200	공급자 상호
invoicerCorpNum	string	10	공급자 사업자번호
invoicerMgtKey	string	24	공급자 문서번호 파트너가 할당한 문서번호
invoicerPrintYN	boolean	-	공급자 인쇄여부 true인쇄 false미인쇄
invoiceeCorpName	string	200	공급받는자 상호
invoiceeCorpNum	string	13	공급받는자 사업자번호
invoiceeMgtKey	string	24	공급받는자 문서번호 파트너가 할당한 문서번호
invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true인쇄 false미인쇄
closeDownState	number	1	공급받는자 휴폐업상태 null미확인 0미등록 1사업중 2폐업 3휴업 4확인실패
closeDownStateDate	string	8	공급받는자 휴폐업일자 형식 : yyyyMMdd
trusteeCorpName	string	200	수탁자 상호
trusteeCorpNum	string	10	수탁자 사업자번호
trusteeMgtKey	string	24	수탁자 문서번호 파트너가 할당한 문서번호
trusteePrintYN	boolean	-	수탁자 인쇄여부 true인쇄 false미인쇄

응답 예시

[
    {
        "invoiceePrintYN": false,
        "openYN": false,
        "taxType": "과세",
        "invoicerCorpNum": "1234567890",
        "invoicerMgtKey": "MKGTKEY-0002",
        "invoicerCorpName": "공급자 상호",
        "invoicerPrintYN": false,
        "invoiceeCorpName": "공급받는자 상호",
        "trusteePrintYN": false,
        "taxTotal": "1000",
        "supplyCostTotal": "10000",
        "purposeType": "영수",
        "ntsconfirmNum": "202510168888888800000002",
        "closeDownState": 0,
        "lateIssueYN": false,
        "stateCode": 300,
        "interOPYN": true,
        "itemKey": "025102114360700001",
        "issueDT": "20251021143607",
        "stateDT": "20251021143608",
        "regDT": "20251021143608",
        "invoiceeCorpNum": "1234567890",
        "issueType": "정발행",
        "writeDate": "20251016"
    }
]

3. GetDetailInfo - 상세정보 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

세금계산서 1건의 상세정보를 확인합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	MgtKey	string	24	Y	파트너가 할당한 문서번호

Query 파라미터

순번	변수명	타입	길이	필수	설명
	Detail	-	-	Y	상세 정보 빈값으로 입력

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}?Detail' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번

변수명

타입

길이

설명

ntsconfirmNum

string

국세청승인번호

전자세금계산서 발행 시점에 팝빌에서 자동으로 할당

issueType

string

발행형태

정발행

역발행

위수탁

taxType

string

과세형태

과세

영세

면세

chargeDirection

string

과금방향

정과금 공급자 과금

역과금 공급받는자 과금

serialNum

string

일련번호

kwon

number

책번호 "권" 항목

number

책번호 "호" 항목

writeDate

string

작성일자

형식 : yyyyMMdd

purposeType

string

영수/청구

영수

청구

없음

supplyCostTotal

string

공급가액 합계

taxTotal

string

세액 합계

totalAmount

string

합계금액

cash

string

현금

chkBill

string

수표

credit

string

외상

note

string

어음

remark1

string

150

비고1

{invoiceeType}="외국인" 경우
외국인등록번호 또는 여권번호 필수 입력

remark2

string

150

비고2

remark3

string

150

비고3

invoicerMgtKey

string

공급자 문서번호

문서 관리를 위해 파트너가 할당하는 고유 식별번호

invoicerCorpNum

string

공급자 사업자번호

invoicerTaxRegID

string

공급자 종사업장 식별번호

invoicerCorpName

string

200

공급자 상호

invoicerCEOName

string

100

공급자 대표자 성명

invoicerAddr

string

300

공급자 주소

invoicerBizType

string

100

공급자 업태

invoicerBizClass

string

100

공급자 종목

invoicerContactName

string

100

공급자 담당자 성명

invoicerDeptName

string

100

공급자 담당자 부서명

invoicerTEL

string

공급자 담당자 연락처

invoicerHP

string

공급자 담당자 휴대폰

invoicerEmail

string

100

공급자 담당자 메일

invoicerSMSSendYN

boolean

공급자 알림문자 전송 여부

true전송

false미전송

수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}

invoiceeMgtKey

string

공급받는자 문서번호

문서 관리를 위해 파트너가 할당하는 고유 식별번호

invoiceeType

string

공급받는자 유형

사업자

개인

외국인

invoiceeCorpNum

string

공급받는자 등록번호
- {invoiceeType}="사업자" 경우 사업자번호
- {invoiceeType}="개인" 경우 주민등록번호
- {invoiceeType}="외국인" 경우 "9999999999999"

invoiceeTaxRegID

string

공급받는자 종사업장 식별번호

invoiceeCorpName

string

200

공급받는자 상호

invoiceeCEOName

string

100

공급받는자 대표자 성명

invoiceeAddr

string

300

공급받는자 주소

invoiceeBizType

string

100

공급받는자 업태

invoiceeBizClass

string

100

공급받는자 종목

closeDownState

number

공급받는자 휴폐업상태

null미확인
0미등록
1사업중
2폐업
3휴업
4확인실패

세금계산서 발행시 거래처 사업자등록상태조회 하여 결과값 반환

closeDownStateDate

string

공급받는자 휴폐업일자

형식 : yyyyMMdd

invoiceeContactName1

string

100

공급받는자 담당자 성명

invoiceeDeptName1

string

100

공급받는자 담당자 부서명

invoiceeTEL1

string

공급받는자 담당자 연락처

invoiceeHP1

string

공급받는자 담당자 휴대폰

invoiceeEmail1

string

100

공급받는자 담당자 메일

invoiceeSMSSendYN

boolean

공급받는자 알림문자 전송 여부

true전송

false미전송

수신자 : 공급자 휴대폰번호 {invoicerHP}

trusteeMgtKey

string

수탁자 문서번호

수탁자의 문서 관리를 위해 파트너가 할당하는 식별번호

trusteeCorpNum

string

수탁자 사업자번호

trusteeTaxRegID

string

수탁자 종사업장 식별번호

trusteeCorpName

string

200

수탁자 상호

trusteeCEOName

string

100

수탁자 대표자 성명

trusteeAddr

string

300

수탁자 주소

trusteeBizType

string

100

수탁자 업태

trusteeBizClass

string

100

수탁자 종목

trusteeContactName

string

100

수탁자 담당자 성명

trusteeDeptName

string

100

수탁자 담당자 부서명

trusteeTEL

string

수탁자 담당자 연락처

trusteeHP

string

수탁자 담당자 휴대폰

trusteeEmail

string

100

수탁자 담당자 메일

trusteeSMSSendYN

boolean

수탁자 알림문자 전송 여부

true전송

false미전송

수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}

modifyCode

number

수정 사유코드

수정세금계산서 작성시 필수 [참고] 수정세금계산서

orgNTSConfirmNum

string

당초 국세청승인번호

수정세금계산서 작성시 반환

businessLicenseYN

boolean

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

true첨부

false미첨부

bankBookYN

boolean

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

true첨부

false미첨부

detailList

array

품목 상세정보

최대 : 99개

변수명	타입	길이	설명
serialNum	number	2	Y	일련번호
purchaseDT	string	8	N	거래일자 형식 : yyyyMMdd
itemName	string	100	N	품명
spec	string	60	N	규격
qty	string	12	N	수량 -99999999.99 ~ 999999999.99 소수점 아래 2번째 자리까지 입력 가능
unitCost	string	18	N	단가 -99999999999999.99 ~ 999999999999999.99 소수점 아래 2번째 자리까지 입력 가능
supplyCost	string	18	N	공급가액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 자동 절사
tax	string	18	N	세액 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 자동 절사
remark	string	100	N	비고

addContactList

array

공급받는자 추가담당자 정보

최대 : 5명

변수명	타입	길이	설명
serialNum	number	1	Y	일련번호
contactName	string	100	N	담당자 성명
email	string	100	Y	메일

응답 예시

{
    "writeSpecification": false,
    "writeDate": "20251016",
    "chargeDirection": "정과금",
    "issueType": "정발행",
    "issueTiming": "직접발행",
    "taxType": "과세",
    "invoicerCorpNum": "1234567890",
    "invoicerMgtKey": "MKGTKEY-0002",
    "invoicerTaxRegID": "0001",
    "invoicerCorpName": "공급자 상호",
    "invoicerCEOName": "공급자 대표자 성명",
    "invoicerAddr": "공급자 주소",
    "invoicerBizClass": "공급자 종목",
    "invoicerBizType": "공급자 업태",
    "invoicerContactName": "공급자 담당자 성명",
    "invoicerDeptName": "공급자 담당자 부서명",
    "invoicerTEL": "010-1234-5678",
    "invoicerHP": "010-1234-5678",
    "invoicerEmail": "test@test.com",
    "invoicerSMSSendYN": false,
    "invoiceeCorpNum": "1234567890",
    "invoiceeType": "사업자",
    "invoiceeTaxRegID": "0001",
    "invoiceeCorpName": "공급받는자 상호",
    "invoiceeCEOName": "공급받는자 대표자 성명",
    "invoiceeAddr": "공급받는자 주소",
    "invoiceeBizType": "공급받는자 업태",
    "invoiceeBizClass": "공급받는자 종목",
    "invoiceeContactName1": "공급받는자 담당자 성명",
    "invoiceeDeptName1": "공급받는자 담당자 부서명",
    "invoiceeTEL1": "010-1234-5678",
    "invoiceeHP1": "010-1234-5678",
    "invoiceeEmail1": "test@test.com",
    "invoiceeSMSSendYN": false,
    "trusteeSMSSendYN": false,
    "taxTotal": "1000",
    "supplyCostTotal": "10000",
    "totalAmount": "11000",
    "purposeType": "영수",
    "businessLicenseYN": false,
    "bankBookYN": false,
    "faxsendYN": false,
    "ntsconfirmNum": "202510168888888800000002",
    "detailList": [
        {
            "serialNum": 1,
            "purchaseDT": "20251016",
            "itemName": "품명",
            "spec": "규격",
            "qty": "1",
            "unitCost": "10000",
            "supplyCost": "10000",
            "tax": "1000",
            "remark": "비고"
        }
    ],
    "addContactList": [
      {
        "serialNum": 1,
        "contactName": "담당자 성명",
        "email": "test@test.com"
      }
    ],
    "closeDownState": 0
}

4. CheckMgtKeyInUse - 문서번호 사용 여부 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
응답 본문의 itemKey 필드에 값이 존재하면 사용 중인 문서번호이며, 값이 존재하지 않으면 사용 가능한 문서번호 입니다.
이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
itemKey	string	18	팝빌에서 할당한 식별번호
taxType	string	2	과세형태 과세 영세 면세
writeDate	string	8	작성일자 형식 : yyyyMMdd
regDT	string	14	임시저장 일시 형식 : yyyyMMddHHmmss
issueType	string	3	발행형태 정발행 역발행 위수탁
supplyCostTotal	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
purposeType	string	2	영수/청구 영수 청구 없음
issueDT	string	14	발행일시 형식 : yyyyMMddHHmmss
lateIssueYN	boolean	-	지연발행 여부 true지연발행 false정상발행
openYN	boolean	-	개봉 여부 true개봉 false미개봉 {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
openDT	string	14	개봉일시 형식 : yyyyMMddHHmmss
stateMemo	string	200	상태메모
stateCode	string	3	상태코드 [참고] 팝빌 상태코드
stateDT	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
ntsconfirmNum	string	18	국세청승인번호 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
ntsresult	string	6	국세청 전송결과
ntssendDT	string	14	국세청 전송일시 형식 : yyyyMMddHHmmss
ntsresultDT	string	14	국세청 결과 수신일시 형식 : yyyyMMddHHmmss
ntssendErrCode	string	6	국세청 결과코드 [참고] 국세청 결과코드
modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 [참고] 수정세금계산서
interOPYN	boolean	-	연동문서 여부 trueAPI를 통해 발행한 연동문서 false팝빌 사이트를 통해 발행한 문서
invoicerCorpName	string	200	공급자 상호
invoicerCorpNum	string	10	공급자 사업자번호
invoicerMgtKey	string	24	공급자 문서번호 파트너가 할당한 문서번호
invoicerPrintYN	boolean	-	공급자 인쇄여부 true인쇄 false미인쇄
invoiceeCorpName	string	200	공급받는자 상호
invoiceeCorpNum	string	13	공급받는자 사업자번호
invoiceeMgtKey	string	24	공급받는자 문서번호 파트너가 할당한 문서번호
invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true인쇄 false미인쇄
closeDownState	number	1	공급받는자 휴폐업상태 null미확인 0미등록 1사업중 2폐업 3휴업 4확인실패
closeDownStateDate	string	8	공급받는자 휴폐업일자 형식 : yyyyMMdd
trusteeCorpName	string	200	수탁자 상호
trusteeCorpNum	string	10	수탁자 사업자번호
trusteeMgtKey	string	24	수탁자 문서번호 파트너가 할당한 문서번호
trusteePrintYN	boolean	-	수탁자 인쇄여부 true인쇄 false미인쇄

응답 예시

{
    "itemKey": "025102114360700001",
}

5. GetXML - 상세정보 확인(XML)

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}

세금계산서 1건의 상세정보를 XML로 반환합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	MgtKey	string	24	Y	파트너가 할당한 문서번호

Query 파라미터

순번	변수명	타입	길이	필수	설명
	XML	-	-	Y	XML 빈값으로 입력

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}?XML' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
code	number	-	API 처리에 대한 응답코드 1성공
message	string	-	API 처리에 대한 응답메시지
retObject	string	-	전자세금계산서 XML 문서

응답 예시

{
    "code": 1,
    "message": "확인완료",
    "retObject": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n<TaxInvoice..."
}

6. Search - 목록 조회

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}

검색조건에 해당하는 세금계산서를 조회합니다. (최대 조회기간 : 6개월)

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁

Query 파라미터

변수명	타입	길이	필수	설명
DType	string	1	Y	검색일자 유형 (택 1) R등록일자 W작성일자 I발행일자
SDate	string	8	Y	검색 시작일자 형식 : yyyyMMdd
EDate	string	8	Y	검색 종료일자 형식 : yyyyMMdd
State	string	-	N	세금계산서 상태코드 2, 3번째 자리에 와일드카드() 사용가능. 예) 3,60 [참고] 팝빌 상태코드 기본값 : 전체조회
Type	string	-	N	세금계산서 문서 유형 (다중 선택 가능) N세금계산서 M수정세금계산서 다중 선택시 콤마(',')로 구분. 예) N,M 기본값 : 전체조회
TaxType	string	-	N	과세형태 (다중 선택 가능) T과세 N면세 Z영세 다중 선택시 콤마(',')로 구분. 예) T,N 기본값 : 전체조회
IssueType	string	-	N	발행형태 (다중 선택 가능) N정발행 R역발행 T위수탁 다중 선택시 콤마(',')로 구분. 예) N,R 기본값 : 전체조회
LateOnly	boolean	-	N	지연발행 여부 true지연발행 false정상발행 기본값 : 전체조회
TaxRegIDType	string	1	N	종사업자번호의 주체 (택 1) S공급자 B공급받는자 T수탁자 기본값 : 전체조회
TaxRegID	string	-	N	종사업장번호 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 기본값 : 전체조회
TaxRegIDYN	string	1	N	종사업장번호 유무 0없음 1있음 기본값 : 전체조회
QString	string	-	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
Page	number	-	Y	목록 페이지번호 기본값 : 1
PerPage	number	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	string	1	N	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
InterOPYN	string	1	N	세금계산서 작성유형 0팝빌 사이트를 통해 작성한 세금계산서 1API로 작성한 세금계산서 기본값 : 전체조회
RegType	string	-	N	전자세금계산서 등록 유형 (다중 선택 가능) P팝빌에서 등록(발행) H홈택스 또는 ASP에서 등록(발행) 다중 선택시 콤마(',')로 구분. 예) P,H 기본값 : 전체조회
CloseDownState	string	-	N	휴폐업상태 (다중 선택 가능) N미확인 0미등록 1사업중 2폐업 3휴업 4확인실패 다중 선택시 콤마(',')로 구분. 예) N,0 기본값 : 전체조회
MgtKey	string	-	N	문서번호 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 기본값 : 전체조회

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}?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 – 상태 확인]의 리턴값 구성과 동일
최대 : 1,000건

변수명	타입	길이	설명
itemKey	string	18	팝빌에서 할당한 식별번호
taxType	string	2	과세형태 과세 영세 면세
writeDate	string	8	작성일자 형식 : yyyyMMdd
regDT	string	14	임시저장 일시 형식 : yyyyMMddHHmmss
issueType	string	3	발행형태 정발행 역발행 위수탁
supplyCostTotal	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
purposeType	string	2	영수/청구 영수 청구 없음
issueDT	string	14	발행일시 형식 : yyyyMMddHHmmss
lateIssueYN	boolean	-	지연발행 여부 true지연발행 false정상발행
openYN	boolean	-	개봉 여부 true개봉 false미개봉 {issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리 {issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
openDT	string	14	개봉일시 형식 : yyyyMMddHHmmss
stateMemo	string	200	상태메모
stateCode	string	3	상태코드 [참고] 팝빌 상태코드
stateDT	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
ntsconfirmNum	string	18	국세청승인번호 전자세금계산서 발행 시점에 팝빌에서 자동으로 할당
ntsresult	string	6	국세청 전송결과
ntssendDT	string	14	국세청 전송일시 형식 : yyyyMMddHHmmss
ntsresultDT	string	14	국세청 결과 수신일시 형식 : yyyyMMddHHmmss
ntssendErrCode	string	6	국세청 결과코드 [참고] 국세청 결과코드
modifyCode	number	1	수정세금계산서 발행시 입력한 사유코드 [참고] 수정세금계산서
interOPYN	boolean	-	연동문서 여부 trueAPI를 통해 발행한 연동문서 false팝빌 사이트를 통해 발행한 문서
invoicerCorpName	string	200	공급자 상호
invoicerCorpNum	string	10	공급자 사업자번호
invoicerMgtKey	string	24	공급자 문서번호 파트너가 할당한 문서번호
invoicerPrintYN	boolean	-	공급자 인쇄여부 true인쇄 false미인쇄
invoiceeCorpName	string	200	공급받는자 상호
invoiceeCorpNum	string	13	공급받는자 사업자번호
invoiceeMgtKey	string	24	공급받는자 문서번호 파트너가 할당한 문서번호
invoiceePrintYN	boolean	-	공급받는자 인쇄여부 true인쇄 false미인쇄
closeDownState	number	1	공급받는자 휴폐업상태 null미확인 0미등록 1사업중 2폐업 3휴업 4확인실패
closeDownStateDate	string	8	공급받는자 휴폐업일자 형식 : yyyyMMdd
trusteeCorpName	string	200	수탁자 상호
trusteeCorpNum	string	10	수탁자 사업자번호
trusteeMgtKey	string	24	수탁자 문서번호 파트너가 할당한 문서번호
trusteePrintYN	boolean	-	수탁자 인쇄여부 true인쇄 false미인쇄

응답 예시

{
    "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": "검색 완료"
}

7. GetLogs - 상태 변경이력 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Logs

GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Logs

세금계산서의 상태에 대한 변경이력을 확인합니다.

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
	MgtKeyType	string	-	Y	문서번호 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	MgtKey	string	24	Y	파트너가 할당한 문서번호

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}/Logs' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
docLogType	number	3	로그타입 100임시저장 101수정 102개봉 103수신확인 111메일 재전송 112문자 재전송 113팩스 재전송 122문자 전송결과 123팩스 전송결과 124사업자등록상태 확인 125문서번호 할당 220역발행요청 221역발행요청 거부 222역발행요청 취소 230발행 240발행취소 250국세청전송 요청 251국세청전송 대기중 252국세청전송 진행중 253국세청전송 접수 254국세청전송 성공 255국세청전송 실패
log	string	2000	이력정보
procType	string	3	처리형태 연동API를 통해 처리함 일반팝빌 사이트를 통해 처리함 시스템팝빌이 처리함
procCorpName	string	70	처리회사명
procContactName	string	30	처리담당자
procMemo	string	200	처리메모
regDT	string	14	등록일시 형식 : yyyyMMddHHmmss
ip	string	39	아이피

응답 예시

[
    {
        "ip": "192.***.*.104",
        "log": "임시저장 되었습니다.",
        "regDT": "20251021143608",
        "docLogType": 100,
        "procType": "연동",
        "procCorpName": "회사명",
        "procContactName": "담당자 성명2"
    }
]

8. GetURL - 문서함 팝업 URL

GET https://popbill-test.linkhub.co.kr/Taxinvoice

GET https://popbill.linkhub.co.kr/Taxinvoice

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매출 발행 대기함 SBOX매출 문서함 PWBOX매입 발행 대기함 PBOX매입 문서함 WRITE정발행 작성

요청 예시

curl --request GET \
  --url 'https://{domain}/Taxinvoice?TG={TG}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	url	string	-	세금계산서 문서함 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}