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

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK 레퍼런스

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

팝빌의
SDK 다운로드
API 레퍼런스

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

고객지원

API 연동 중 발생하는 문제는
팝빌에서 해결을 도와드립니다.

팝빌의
서비스 제안서 수많은 기업이
선택한 팝빌
API 레퍼런스
전자명세서
API 레퍼런스 전자명세서 보기/인쇄

보기/인쇄

1. GetPopUpURL - 전자명세서 팝업 URL

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
  • 전자명세서 1건의 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 1,250px (최소 975px) / height = 800px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
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 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : POPUP
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?TG=POPUP' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자명세서 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}

2. GetViewURL - 전자명세서 팝업 URL [보기 전용]

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
  • 전자명세서 1건의 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 1,250px (최소 975px) / height = 800px
  • 페이지 상/하단에 기능 버튼이 존재하지 않습니다.
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
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 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : VIEW
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?TG=VIEW' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자명세서 팝업 URL [보기 전용]
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}

3. GetPrintURL - 공급자 인쇄 팝업 URL

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
  • 전자명세서 1건의 공급자 인쇄 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 900px / height = 730px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
  • 전자명세서의 공급자는 "발신자", 공급받는자는 "수신자"를 나타내는 용어입니다.
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 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : PRINT
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?TG=PRINT' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자명세서 공급자 인쇄 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}

4. GetEPrintURL - 공급받는자 인쇄 팝업 URL

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
  • 전자명세서 1건의 공급받는자 인쇄 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 900px / height = 730px
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
  • 전자명세서의 공급받는자는 "수신자"를 나타내는 용어입니다.
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 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : EPRINT
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?TG=EPRINT' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자명세서 공급받는자 인쇄 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}

5. GetMassPrintURL - 다건 인쇄 팝업 URL

POST https://popbill-test.linkhub.co.kr/Statement/{ItemCode}
POST https://popbill.linkhub.co.kr/Statement/{ItemCode}
  • 전자명세서 다건의 인쇄 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 900px / height = 730px
  • 1회 호출에 최대 100건까지 인쇄가 가능합니다.
  • 반환되는 URL은 30초 동안만 사용이 가능합니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
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영수증
Query 파라미터
순번 변수명 타입 길이 필수 설명
Print - - Y 빈값으로 입력
요청 본문
순번 변수명 타입 길이 필수 설명
- array - Y 문서번호 목록
최대 : 100건
요청 예시
curl --request POST \
  --url 'https://{domain}/Statement/{ItemCode}?Print' \
  --header 'Authorization: Bearer {token}' \
  --data '["TEST0001"]'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자명세서 다건 인쇄 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}

6. GetMailURL - 메일 보기 팝업 URL

GET https://popbill-test.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
GET https://popbill.linkhub.co.kr/Statement/{ItemCode}/{MgtKey}
  • 전자명세서 발행 안내 메일의 '보기' 버튼 URL을 반환합니다.
  • 권장 사이즈 : width = 1,250px (최소 975px) / height = 800px
  • 반환되는 URL은 유효기간 제한 없이 사용할 수 있습니다.
  • 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
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 파라미터
순번 변수명 타입 길이 필수 설명
TG string - Y 고정값 : MAIL
요청 예시
curl --request GET \
  --url 'https://{domain}/Statement/{ItemCode}/{MgtKey}?TG=MAIL' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 전자세금계산서 메일 보기 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/Taxinvoice/025102114360700001.E?T=Q5LM53CQT...FQH0QUG"
}