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

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

SDK 레퍼런스

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

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

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

고객지원

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

팝빌의
서비스 제안서 수많은 기업이
선택한 팝빌
API 레퍼런스
전자세금계산서
API 레퍼런스 전자세금계산서 부가기능

부가기능

1. GetSealURL - 인감 및 첨부문서 등록 팝업 URL

GET https://popbill-test.linkhub.co.kr/Member
GET https://popbill.linkhub.co.kr/Member
  • 전자세금계산서에 첨부될 인감, 사업자등록증, 통장사본을 등록하는 팝업 URL을 반환합니다.
  • 권장 사이즈 : width = 600px / height = 755px
  • 반환되는 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 고정값 : SEAL
요청 예시
curl --request GET \
  --url 'https://{domain}/Member?TG=SEAL' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
url string - 인감 및 첨부문서 등록 팝업 URL
응답 예시
{
    "url": "https://test.popbill.com/App/API?T=FFXMY6SEHFVDD27TUYBESQ7...XYK2NPF5NLWKD2==="
}

2. AttachFile - 파일 첨부

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files
  • "임시저장" 상태의 세금계산서에 1개의 파일을 첨부합니다. (최대 5개)
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
multipart/form-data
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 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
Filedata file - Y 파일 데이터
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}/Files' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: multipart/form-data' \
  --form 'Filedata=@"/path/test.jpg"'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "첨부 완료"
}

3. DeleteFile - 첨부파일 삭제

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files/{FileID}
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files/{FileID}
  • "임시저장" 상태의 세금계산서에 첨부된 1개의 파일을 삭제합니다.
  • 파일 식별을 위해 첨부시 할당되는 FileID는 함수 [GetFiles – 첨부파일 목록 확인] 를 호출하여 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-HTTP-Method-Override Y 요청 메서드 재정의
DELETE
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
MgtKeyType string - Y 문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey string 24 Y 파트너가 할당한 문서번호
FileID string 255 Y 팝빌이 할당한 파일 식별번호
함수 [GetFiles – 첨부파일 목록 확인]의 리턴값 중 attachedFile 필드 참조
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}/Files/{FileID}' \
  --header 'Authorization: Bearer {token}' \
  --header 'X-HTTP-Method-Override: DELETE'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "첨부삭제 완료"
}

4. GetFiles - 첨부파일 목록 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files
GET https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/Files
  • 세금계산서에 첨부된 파일목록을 확인합니다.
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}/Files' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
serialNum number 1 첨부파일 일련번호
attachedFile string 255 팝빌이 할당한 파일 식별번호
팝빌이 첨부파일 관리를 위해 할당한 식별번호
함수 [DeleteFile – 첨부파일 삭제]호출을 위한 필수값
displayName string 255 파일명
regDT string 14 첨부일시
형식 : yyyyMMddHHmmss
응답 예시
[
    {
        "displayName": "test.jpg",
        "serialNum": 2,
        "attachedFile": "B8930D66-6684-4B25-ABA0-3BD4E848ECAF.PBF",
        "regDT": "20251022203916"
    }
]

5. SendEmail - 메일 재전송

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
  • 세금계산서와 관련된 안내 메일을 재전송 합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-HTTP-Method-Override Y 요청 메서드 재정의
EMAIL
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
MgtKeyType string - Y 문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
receiver string - Y 수신자 메일주소
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --header 'X-HTTP-Method-Override: EMAIL' \
  --data '{
    "receiver": "test@test.com"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "이메일 재전송 완료"
}

6. SendSMS - 문자 재전송

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
  • 세금계산서와 관련된 안내 SMS(단문) 문자를 재전송하는 함수로, 팝빌 사이트 [ 문자 > 결과 > 전송결과 ] 메뉴에서 전송결과를 확인할 수 있습니다.
  • 메시지는 최대 90byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송합니다. (한글 최대 45자)
  • API 호출 시 포인트가 차감됩니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-HTTP-Method-Override Y 요청 메서드 재정의
SMS
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
MgtKeyType string - Y 문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
sender string - Y 발신번호
receiver string - Y 수신번호
contents string 90 Y 메시지 내용
최대 90 byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --header 'X-HTTP-Method-Override: SMS' \
  --data '{
    "sender": "01012345678",
    "receiver": "01012345678",
    "contents": "메시지 내용"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "문자알림 재전송 완료"
}

7. SendFAX - 팩스 전송

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}
  • 세금계산서를 팩스로 전송하는 함수로, 팝빌 사이트 [ 팩스 > 결과 > 전송결과 ] 메뉴에서 전송결과를 확인할 수 있습니다.
  • API 호출 시 포인트가 차감됩니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-HTTP-Method-Override Y 요청 메서드 재정의
FAX
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
MgtKeyType string - Y 문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
sender string - Y 발신번호
receiver string - Y 수신번호
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --header 'X-HTTP-Method-Override: FAX' \
  --data '{
    "sender": "01012345678",
    "receiver": "01012345678"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "팩스 재전송 완료"
}

8. AttachStatement - 전자명세서 첨부

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/AttachStmt
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/AttachStmt
  • 팝빌 전자명세서 API를 통해 발행한 전자명세서를 세금계산서에 첨부합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
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 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
ItemCode number 3 Y 첨부할 전자명세서 문서 유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
전자명세서 발행시 입력한 값과 동일하게 작성
MgtKey string 24 Y 첨부할 전자명세서 문서번호
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}/AttachStmt' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "ItemCode": 121,
    "MgtKey": "첨부할 전자명세서 문서번호"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "첨부 완료"
}

9. DetachStatement - 전자명세서 첨부해제

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/DetachStmt
POST https://popbill.linkhub.co.kr/Taxinvoice/{MgtKeyType}/{MgtKey}/DetachStmt
  • 세금계산서에 첨부된 전자명세서를 해제합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/json
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 파트너가 할당한 문서번호
요청 본문
순번 변수명 타입 길이 필수 설명
ItemCode number 3 Y 첨부해제할 전자명세서 문서 유형 (택 1)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
전자명세서 발행시 입력한 값과 동일하게 작성
MgtKey string 24 Y 첨부해제할 전자명세서 문서번호
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{MgtKeyType}/{MgtKey}/DetachStmt' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "ItemCode": 121,
    "MgtKey": "첨부해제할 전자명세서 문서번호"
  }'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "첨부해제 완료"
}

10. AssignMgtKey - 문서번호 할당

POST https://popbill-test.linkhub.co.kr/Taxinvoice/{ItemKey}/{MgtKeyType}
POST https://popbill.linkhub.co.kr/Taxinvoice/{ItemKey}/{MgtKeyType}
  • 팝빌 사이트를 통해 발행하여 문서번호가 할당되지 않은 세금계산서에 문서번호를 할당합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Content-Type Y 요청 본문 형식
application/x-www-form-urlencoded; charset=utf-8
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Path 파라미터
순번 변수명 타입 길이 필수 설명
ItemKey string 18 Y 파트너가 할당한 문서번호
MgtKeyType string - Y 문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
요청 본문
순번 변수명 타입 길이 필수 설명
MgtKey string 24 Y 파트너가 할당한 문서번호
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/{ItemKey}/{MgtKeyType}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \
  --data-urlencode 'MgtKey=TEST0001'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "할당 완료"
}

11. ListEmailConfig - 알림메일 발송설정 조회

GET https://popbill-test.linkhub.co.kr/Taxinvoice/EmailSendConfig
GET https://popbill.linkhub.co.kr/Taxinvoice/EmailSendConfig
  • 세금계산서 관련 메일 항목에 대한 발송설정을 확인합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://{domain}/Taxinvoice/EmailSendConfig' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
emailType string 32 메일 전송 유형
정발행
TAX_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_CHECK
공급자에게 세금계산서가 수신확인 되었음을 알려주는 메일
TAX_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
역발행
TAX_REQUEST
공급자에게 세금계산서를 전자서명 하여 발행을 요청하는 메일
TAX_CANCEL_REQUEST
공급받는자에게 세금계산서가 취소 되었음을 알려주는 메일
TAX_REFUSE
공급받는자에게 세금계산서가 거부 되었음을 알려주는 메일
위수탁 발행
TAX_TRUST_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_TRUSTEE
수탁자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE_INVOICER
공급자에게 세금계산서가 발행취소 되었음을 알려주는 메일
처리결과
TAX_CLOSEDOWN
거래처의 휴폐업 여부를 확인하여 안내하는 메일
TAX_NTSFAIL_INVOICER
세금계산서 국세청 전송실패를 안내하는 메일
정기발송
ETC_CERT_EXPIRATION
팝빌에 등록된 인증서의 만료예정을 안내하는 메일
sendYN boolean - 전송 여부
true전송
false미전송
응답 예시
[
    {
        "emailType": "TAX_ISSUE_INVOICER",
        "sendYN": false
    },
    {
        "emailType": "TAX_CHECK",
        "sendYN": true
    },
    {
        "emailType": "TAX_CANCEL_ISSUE",
        "sendYN": true
    },
    {
        "emailType": "TAX_REQUEST",
        "sendYN": true
    },
    {
        "emailType": "TAX_CANCEL_REQUEST",
        "sendYN": true
    },
    {
        "emailType": "TAX_REFUSE",
        "sendYN": true
    },
    {
        "emailType": "TAX_REVERSE_ISSUE",
        "sendYN": true
    },
    {
        "emailType": "TAX_TRUST_ISSUE",
        "sendYN": true
    },
    {
        "emailType": "TAX_TRUST_ISSUE_TRUSTEE",
        "sendYN": false
    },
    {
        "emailType": "TAX_TRUST_ISSUE_INVOICER",
        "sendYN": true
    },
    {
        "emailType": "TAX_TRUST_CANCEL_ISSUE",
        "sendYN": true
    },
    {
        "emailType": "TAX_TRUST_CANCEL_ISSUE_INVOICER",
        "sendYN": true
    },
    {
        "emailType": "TAX_CLOSEDOWN",
        "sendYN": true
    },
    {
        "emailType": "TAX_NTSFAIL_INVOICER",
        "sendYN": true
    },
    {
        "emailType": "ETC_CERT_EXPIRATION",
        "sendYN": true
    }
]

12. UpdateEmailConfig - 알림메일 발송설정 수정

POST https://popbill-test.linkhub.co.kr/Taxinvoice/EmailSendConfig
POST https://popbill.linkhub.co.kr/Taxinvoice/EmailSendConfig
  • 세금계산서 관련 메일 항목에 대한 발송설정을 수정합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
Query 파라미터
순번 변수명 타입 길이 필수 설명
EmailType string - Y 메일 전송 유형
정발행
TAX_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_CHECK
공급자에게 세금계산서가 수신확인 되었음을 알려주는 메일
TAX_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
역발행
TAX_REQUEST
공급자에게 세금계산서를 전자서명 하여 발행을 요청하는 메일
TAX_CANCEL_REQUEST
공급받는자에게 세금계산서가 취소 되었음을 알려주는 메일
TAX_REFUSE
공급받는자에게 세금계산서가 거부 되었음을 알려주는 메일
위수탁 발행
TAX_TRUST_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_TRUSTEE
수탁자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE_INVOICER
공급자에게 세금계산서가 발행취소 되었음을 알려주는 메일
처리결과
TAX_CLOSEDOWN
거래처의 휴폐업 여부를 확인하여 안내하는 메일
TAX_NTSFAIL_INVOICER
세금계산서 국세청 전송실패를 안내하는 메일
정기발송
ETC_CERT_EXPIRATION
팝빌에 등록된 인증서의 만료예정을 안내하는 메일
SendYN boolean - Y 전송 여부
true전송
false미전송
요청 예시
curl --request POST \
  --url 'https://{domain}/Taxinvoice/EmailSendConfig?EmailType={EmailType}&SendYN={SendYN}' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
응답 예시
{
    "code": 1,
    "message": "수정 완료"
}

13. GetSendToNTSConfig - 국세청 전송 옵션 설정 상태 확인

GET https://popbill-test.linkhub.co.kr/Taxinvoice/SendToNTSConfig
GET https://popbill.linkhub.co.kr/Taxinvoice/SendToNTSConfig
  • 국세청 전송 옵션 설정은 팝빌 사이트 (www.popbill.com) 로그인 > 전자세금계산서 > 관리 > 환경설정 메뉴에서 설정할 수 있으며, API로 설정은 불가능 합니다.
Request
요청 헤더
순번 변수명 필수 설명
Authorization Y 인증 토큰
[참고] 인증 및 헤더 설정
Accept-Language N 응답 언어 설정
ko-KR: 기본값
en-US
Accept-Encoding N 응답 압축 방식
gzip
X-PB-UserID N 팝빌회원 아이디
요청 예시
curl --request GET \
  --url 'https://{domain}/Taxinvoice/SendToNTSConfig' \
  --header 'Authorization: Bearer {token}'
Response
응답 본문
순번 변수명 타입 길이 설명
sendToNTS boolean - 국세청 전송 옵션 설정 상태
true발행 즉시 전송
false익일 자동 전송
응답 예시
{
    "sendToNTS": true
}