정보확인

1. GetInfo - 상태 확인

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

전자명세서 1건의 상태 및 요약정보를 확인합니다.

Request

요청 헤더

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

Path 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	`itemCode`	number	3	전자명세서 문서 유형 `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증
2	`itemKey`	string	18	팝빌번호 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
3	`invoiceNum`	string	24	팝빌 승인번호 전자명세서 발행 시점에 팝빌에서 자동으로 할당
4	`mgtKey`	string	24	파트너가 할당한 문서번호
5	`taxType`	string	2	과세형태 `과세` `영세` `면세`
6	`writeDate`	string	8	작성일자 형식 : yyyyMMdd
7	`regDT`	string	14	임시저장일시 형식 : yyyyMMddHHmmss
8	`senderCorpName`	string	200	발신자 상호
9	`senderCorpNum`	string	10	발신자 사업자번호
10	`senderPrintYN`	boolean	-	발신자 인쇄여부 `true` 인쇄 `false` 미인쇄
11	`receiverCorpName`	string	200	수신자 상호
12	`receiverCorpNum`	string	10	수신자 사업자번호
13	`receiverPrintYN`	boolean	-	수신자 인쇄여부 `true` 인쇄 `false` 미인쇄
14	`supplyCostTotal`	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
15	`taxTotal`	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
16	`purposeType`	string	2	영수/청구 `영수` `청구` `없음`
17	`issueDT`	string	14	발행일시 형식 : yyyyMMddHHmmss
18	`stateCode`	number	3	상태코드 [참고] 팝빌 상태코드
19	`stateDT`	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
20	`stateMemo`	string	200	상태메모
21	`openYN`	boolean	-	개봉여부 `true` 개봉 `false` 미개봉
22	`openDT`	string	14	개봉 일시 형식 : yyyyMMddHHmmss

응답 예시

{
    "itemCode": 121,
    "itemKey": "025102118531000001",
    "invoiceNum": "123456789020251021000003",
    "mgtKey": "20251021_004",
    "taxType": "과세",
    "writeDate": "20251021",
    "regDT": "20251021185310",
    "senderCorpName": "테스트 상호",
    "senderCorpNum": "1234567890",
    "senderPrintYN": false,
    "receiverCorpName": "공급받는자 상호",
    "receiverCorpNum": "8888888888",
    "receiverPrintYN": 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}

다수건의 전자명세서 상태 및 요약정보를 확인합니다. (1회 호출에 최대 1,000건 확인 가능)

Request

요청 헤더

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

Path 파라미터

순번	변수명	타입	길이	필수	설명
1	`ItemCode`	number	-	Y	전자명세서 문서 유형 (택 1) `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증

요청 본문

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	`itemCode`	number	3	전자명세서 문서 유형 `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증
2	`itemKey`	string	18	팝빌번호 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
3	`invoiceNum`	string	24	팝빌 승인번호 전자명세서 발행 시점에 팝빌에서 자동으로 할당
4	`mgtKey`	string	24	파트너가 할당한 문서번호
5	`taxType`	string	2	과세형태 `과세` `영세` `면세`
6	`writeDate`	string	8	작성일자 형식 : yyyyMMdd
7	`regDT`	string	14	임시저장일시 형식 : yyyyMMddHHmmss
8	`senderCorpName`	string	200	발신자 상호
9	`senderCorpNum`	string	10	발신자 사업자번호
10	`senderPrintYN`	boolean	-	발신자 인쇄여부 `true` 인쇄 `false` 미인쇄
11	`receiverCorpName`	string	200	수신자 상호
12	`receiverCorpNum`	string	10	수신자 사업자번호
13	`receiverPrintYN`	boolean	-	수신자 인쇄여부 `true` 인쇄 `false` 미인쇄
14	`supplyCostTotal`	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
15	`taxTotal`	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
16	`purposeType`	string	2	영수/청구 `영수` `청구` `없음`
17	`issueDT`	string	14	발행일시 형식 : yyyyMMddHHmmss
18	`stateCode`	number	3	상태코드 [참고] 팝빌 상태코드
19	`stateDT`	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
20	`stateMemo`	string	200	상태메모
21	`openYN`	boolean	-	개봉여부 `true` 개봉 `false` 미개봉
22	`openDT`	string	14	개봉 일시 형식 : yyyyMMddHHmmss

응답 예시

[
    {
        "itemCode": 121,
        "itemKey": "025102118531000001",
        "invoiceNum": "123456789020251021000003",
        "mgtKey": "20251021_004",
        "taxType": "과세",
        "writeDate": "20251021",
        "regDT": "20251021185310",
        "senderCorpName": "테스트 상호",
        "senderCorpNum": "1234567890",
        "senderPrintYN": false,
        "receiverCorpName": "공급받는자 상호",
        "receiverCorpNum": "8888888888",
        "receiverPrintYN": 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}

전자명세서 1건의 상세정보를 확인합니다.

Request

요청 헤더

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

Path 파라미터

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

순번 변수명 타입 길이 설명

itemCode

number

전자명세서 문서 유형

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

mgtKey

string

문서번호

전자명세서 관리를 위해 파트너가 할당하는 식별번호

invoiceNum

string

팝빌 승인번호

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

formCode

string

맞춤양식 코드

writeDate

string

작성일자

형식 : yyyyMMdd

taxType

string

과세형태

과세
영세
면세

{itemCode}=121 경우 반환

purposeType

string

영수/청구

영수
청구
없음

serialNum

string

일련번호

supplyCostTotal

string

공급가액 합계

taxTotal

string

세액 합계

totalAmount

string

합계금액

remark1

string

150

비고1

remark2

string

150

비고2

remark3

string

150

비고3

senderCorpNum

string

발신자 사업자번호 ('-' 제외)

senderTaxRegID

string

발신자 종사업장 식별번호

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

senderCorpName

string

200

발신자 상호

senderCEOName

string

100

발신자 대표자성명

senderAddr

string

300

발신자 주소

senderBizType

string

100

발신자 업태

senderBizClass

string

100

발신자 종목

senderContactName

string

100

발신자 성명

senderDeptName

string

발신자 부서명

senderTEL

string

발신자 연락처

senderHP

string

발신자 휴대전화

senderEmail

string

100

발신자 메일주소

senderFAX

string

발신자 팩스번호

receiverCorpNum

string

수신자 사업자번호 ('-' 제외)

receiverTaxRegID

string

수신자 종사업장 식별번호

receiverCorpName

string

200

수신자 상호

receiverCEOName

string

100

수신자 대표자성명

receiverAddr

string

300

수신자 주소

receiverBizType

string

100

수신자 업태

receiverBizClass

string

100

수신자 종목

receiverContactName

string

100

수신자 성명

receiverDeptName

string

수신자 부서명

receiverTEL

string

수신자 연락처

receiverHP

string

수신자 휴대전화

receiverEmail

string

100

수신자 메일주소

receiverFAX

string

수신자 팩스번호

businessLicenseYN

boolean

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

true 첨부
false 미첨부

bankBookYN

boolean

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

true 첨부
false 미첨부

smssendYN

boolean

알림문자 전송 여부

true 전송
false 미전송

수신자 : 수신자 휴대폰번호 {receiverHP}

propertyBag

object

추가속성

array

거래 물품 상세정보

길이 제한 없음

detailList

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

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

Request

요청 헤더

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

Path 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	`itemCode`	number	3	전자명세서 문서 유형 `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증
2	`itemKey`	string	18	팝빌번호 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
3	`invoiceNum`	string	24	팝빌 승인번호 전자명세서 발행 시점에 팝빌에서 자동으로 할당
4	`mgtKey`	string	24	파트너가 할당한 문서번호
5	`taxType`	string	2	과세형태 `과세` `영세` `면세`
6	`writeDate`	string	8	작성일자 형식 : yyyyMMdd
7	`regDT`	string	14	임시저장일시 형식 : yyyyMMddHHmmss
8	`senderCorpName`	string	200	발신자 상호
9	`senderCorpNum`	string	10	발신자 사업자번호
10	`senderPrintYN`	boolean	-	발신자 인쇄여부 `true` 인쇄 `false` 미인쇄
11	`receiverCorpName`	string	200	수신자 상호
12	`receiverCorpNum`	string	10	수신자 사업자번호
13	`receiverPrintYN`	boolean	-	수신자 인쇄여부 `true` 인쇄 `false` 미인쇄
14	`supplyCostTotal`	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
15	`taxTotal`	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
16	`purposeType`	string	2	영수/청구 `영수` `청구` `없음`
17	`issueDT`	string	14	발행일시 형식 : yyyyMMddHHmmss
18	`stateCode`	number	3	상태코드 [참고] 팝빌 상태코드
19	`stateDT`	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
20	`stateMemo`	string	200	상태메모
21	`openYN`	boolean	-	개봉여부 `true` 개봉 `false` 미개봉
22	`openDT`	string	14	개봉 일시 형식 : yyyyMMddHHmmss

응답 예시

{
    "itemKey": "025102118531000001"
}

5. Search - 목록 조회

GET https://popbill-test.linkhub.co.kr/Statement/Search

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

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

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	`DType`	string	1	Y	검색일자 유형 (택 1) `R` 등록일자 `W` 작성일자 `I` 발행일자
2	`SDate`	string	8	Y	검색 시작일자 형식 : yyyyMMdd
3	`EDate`	string	8	Y	검색 종료일자 형식 : yyyyMMdd
4	`State`	string	-	N	전자명세서 상태코드 2, 3번째 자리에 와일드카드() 사용가능. 예) 1,3* [참고] 팝빌 상태코드 기본값 : 전체조회
5	`ItemCode`	number	-	N	전자명세서 문서 유형 (다중 선택 가능) `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증 다중 선택시 콤마(',')로 구분. 예) 121,122 기본값 : 전체조회
6	`QString`	string	-	N	조회 검색어(거래처 상호/사업자번호) 기본값 : 전체조회
7	`Page`	number	-	N	목록 페이지번호 기본값 : 1
8	`PerPage`	number	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
9	`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

number

총 검색결과 건수

perPage

number

페이지당 목록 건수

pageNum

number

페이지 번호

pageCount

number

페이지 개수

array

전자명세서 상태/요약정보

[GetInfo – 상태 확인] API의 리턴값 구성과 동일

최대 : 1,000건

list

순번	변수명	타입	길이	설명
1	`itemCode`	number	3	전자명세서 문서 유형 `121` 거래명세서 `122` 청구서 `123` 견적서 `124` 발주서 `125` 입금표 `126` 영수증
2	`itemKey`	string	18	팝빌번호 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
3	`invoiceNum`	string	24	팝빌 승인번호 전자명세서 발행 시점에 팝빌에서 자동으로 할당
4	`mgtKey`	string	24	파트너가 할당한 문서번호
5	`taxType`	string	2	과세형태 `과세` `영세` `면세`
6	`writeDate`	string	8	작성일자 형식 : yyyyMMdd
7	`regDT`	string	14	임시저장일시 형식 : yyyyMMddHHmmss
8	`senderCorpName`	string	200	발신자 상호
9	`senderCorpNum`	string	10	발신자 사업자번호
10	`senderPrintYN`	boolean	-	발신자 인쇄여부 `true` 인쇄 `false` 미인쇄
11	`receiverCorpName`	string	200	수신자 상호
12	`receiverCorpNum`	string	10	수신자 사업자번호
13	`receiverPrintYN`	boolean	-	수신자 인쇄여부 `true` 인쇄 `false` 미인쇄
14	`supplyCostTotal`	string	18	공급가액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
15	`taxTotal`	string	18	세액 합계 정수만 입력 가능 마이너스 금액 입력 가능, 소수점 아래 자동 절사
16	`purposeType`	string	2	영수/청구 `영수` `청구` `없음`
17	`issueDT`	string	14	발행일시 형식 : yyyyMMddHHmmss
18	`stateCode`	number	3	상태코드 [참고] 팝빌 상태코드
19	`stateDT`	string	14	상태 변경일시 형식 : yyyyMMddHHmmss
20	`stateMemo`	string	200	상태메모
21	`openYN`	boolean	-	개봉여부 `true` 개봉 `false` 미개봉
22	`openDT`	string	14	개봉 일시 형식 : yyyyMMddHHmmss

응답 예시

{
    "code": 1,
    "total": 1,
    "perPage": 500,
    "pageNum": 1,
    "pageCount": 1,
    "list": [
        {
            "itemCode": 121,
            "itemKey": "025102611470500001",
            "invoiceNum": "123456789020251026000003",
            "mgtKey": "TEST202510261138",
            "taxType": "과세",
            "writeDate": "20251026",
            "regDT": "20251026114706",
            "senderCorpNum": "1234567890",
            "senderPrintYN": false,
            "receiverCorpName": "수신자 상호",
            "receiverPrintYN": false,
            "supplyCostTotal": "10000",
            "taxTotal": "1000",
            "purposeType": "청구",
            "issueDT": "20251026114716",
            "stateCode": 500,
            "stateDT": "20251026114841",
            "openYN": false,
            "stateMemo": "메모"
        }
    ],
    "message": "검색 완료"
}

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

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

전자명세서의 상태에 대한 변경이력을 확인합니다.

Request

요청 헤더

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

Path 파라미터

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

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	`docLogType`	number	3	로그타입 `100` 임시저장 `101` 수정 `102` 개봉 `103` 수신확인 `111` 메일 재전송 `112` 문자 재전송 `113` 팩스 재전송 `122` 문자 전송결과 `123` 팩스 전송결과 `310` 발행 `312` 자동승인 `340` 발행취소
2	`log`	string	2000	이력정보
3	`procType`	string	3	처리형태 `연동` API를 통해 처리함 `일반` 팝빌 사이트를 통해 처리함 `시스템` 팝빌이 처리함
4	`procCorpName`	string	70	처리회사명
5	`procContactName`	string	30	처리담당자
6	`procMemo`	string	200	처리메모
7	`regDT`	string	14	등록일시 형식 : yyyyMMddHHmmss
8	`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

문서함 팝업 URL 미리보기

전자명세서 문서함의 팝업 URL을 반환합니다.

권장 사이즈 : width = 1,280px (최소 1,000px) / height = 800px
반환되는 URL은 30초 동안만 사용이 가능합니다.
반환되는 URL은 팝빌회원의 로그인 세션을 포함하고 있으니 사용에 유의하여 주시기 바랍니다.

Request

요청 헤더

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

Query 파라미터

순번	변수명	타입	길이	필수	설명
1	`TG`	string	-	Y	접근 메뉴 (택 1) `TBOX` 임시 문서함 `SWBOX` 발행 문서함

요청 예시

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

Response

응답 본문

순번	변수명	타입	길이	설명
1	`url`	string	-	전자명세서 문서함 팝업 URL

응답 예시

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