부가기능
1. GetSealURL - 인감 및 첨부문서 등록 팝업 URL
- 전자세금계산서에 첨부될 인감, 사업자등록증, 통장사본을 등록하는 팝업 URL을 반환합니다.
- 권장 사이즈 : width = 600px / height = 755px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
string GetSealURL(string CorpNum, string UserID = null)
- 인감을 등록한 이후 세금계산서를 발행하는 경우, 자동으로 등록된 인감이 첨부되어 세금계산서가 발행됩니다.
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 응답 URL
예외
2. AttachFile - 파일 첨부
- "임시저장" 상태의 세금계산서에 1개의 파일을 첨부합니다. (최대 5개)
Response AttachFile(string CorpNum, MgtKeyType KeyType, string MgtKey, string FilePath, string UserID = null, string DisplayName = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| FilePath | string | - | Y | 첨부파일 경로 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| DisplayName | string | 255 | N | 파일명 |
응답
예외
3. AttachFileBinary - 파일 첨부(바이너리)
- "임시저장" 상태의 세금계산서에 1개의 파일(바이너리)을 첨부합니다. (최대 5개)
Response AttachFileBinary(string CorpNum, MgtKeyType KeyType, string MgtKey, BinaryFile BinaryFile, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| BinaryFile | BinaryFile | Y | 첨부 파일 | ||
| UserID | string | 50 | N | 팝빌회원 아이디 | |
응답
예외
4. DeleteFile - 첨부파일 삭제
- "임시저장" 상태의 세금계산서에 첨부된 1개의 파일을 삭제합니다.
- 파일 식별을 위해 첨부시 할당되는 'FileID'는 함수 [GetFiles – 첨부파일 목록 확인] 를 호출하여 확인합니다.
Response DeleteFile(string CorpNum, MgtKeyType KeyType, string MgtKey, string FileID, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| FileID | string | 255 | Y |
팝빌이 할당한 파일 식별번호
함수 [GetFiles – 첨부파일 목록 확인]의 응답 객체 AttachedFile의 변수 'attachedFile'를 통해 확인 가능
|
|
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
5. GetFiles - 첨부파일 목록 확인
- 세금계산서에 첨부된 파일목록을 확인합니다.
List<AttachedFile> GetFiles(string CorpNum, MgtKeyType KeyType, string MgtKey, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
6. SendEmail - 메일 재전송
- 세금계산서와 관련된 안내 메일을 재전송 합니다.
Response SendEmail(string CorpNum, MgtKeyType KeyType, string MgtKey, string Receiver, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 메일 재전송할 세금계산서 문서번호 | |
| Receiver | string | - | Y | 수신자 메일주소 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
7. SendSMS - 문자 재전송
- 세금계산서와 관련된 안내 SMS(단문) 문자를 재전송하는 함수로, 팝빌 사이트 [ 문자 > 결과 > 전송결과 ] 메뉴에서 전송결과를 확인할 수 있습니다.
- 메시지는 최대 90byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송합니다. (한글 최대 45자)
Response SendSMS(string CorpNum, MgtKeyType KeyType, string MgtKey, string Sender, string Receiver, string Contents, string UserID = null)
- API 호출 시 포인트가 차감됩니다.
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| Sender | string | - | Y | 발신번호 | |
| Receiver | string | - | Y | 수신번호 | |
| Contents | string | 90 | Y |
메시지 내용
최대 90 byte까지 입력 가능하고, 초과한 내용은 자동으로 삭제되어 전송
|
|
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
8. SendFAX - 팩스 전송
- 세금계산서를 팩스로 전송하는 함수로, 팝빌 사이트 [ 팩스 > 결과 > 전송결과 ] 메뉴에서 전송결과를 확인할 수 있습니다.
Response SendFAX(string CorpNum, MgtKeyType KeyType, string MgtKey, string Sender, string Receiver, string UserID = null)
- API 호출 시 포인트가 차감됩니다.
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| Sender | string | - | Y | 발신번호 | |
| Receiver | string | - | Y | 수신번호 | |
| UserID | string | 50 | N | 팝빌회원 사업자번호 ('-' 제외) |
응답
예외
9. AttachStatement - 전자명세서 첨부
- 팝빌 전자명세서 API를 통해 발행한 전자명세서를 세금계산서에 첨부합니다.
Response AttachStatement(string CorpNum, MgtKeyType KeyType, string MgtKey, int DocItemCode, string DocMgtKey, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| DocItemCode | int | 3 | Y |
첨부할 전자명세서 문서 유형 (택 1)
전자명세서 발행시 입력한 값과 동일하게 작성
|
|
| DocMgtKey | string | 24 | Y | 첨부할 전자명세서 문서번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
10. DetachStatement - 전자명세서 첨부해제
- 세금계산서에 첨부된 전자명세서를 해제합니다.
Response DetachStatement(string CorpNum, MgtKeyType KeyType, string MgtKey, int DocItemCode, string DocMgtKey, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| DocItemCode | int | 3 | Y |
첨부해제할 전자명세서 문서 유형 (택 1)
전자명세서 발행시 입력한 값과 동일하게 작성
|
|
| DocMgtKey | string | 24 | Y | 첨부해제할 전자명세서 문서번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
11. AssignMgtKey - 문서번호 할당
- 팝빌 사이트를 통해 발행하여 문서번호가 할당되지 않은 세금계산서에 문서번호를 할당합니다.
Response AssignMgtKey(string CorpNum, MgtKeyType KeyType, string ItemKey, string MgtKey, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
문서번호 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| ItemKey | string | 18 | Y |
팝빌에서 할당한 식별번호
함수 [Search – 목록 조회]를 통하여 TaxinvoiceInfo의 'itemKey'를 확인
|
|
| MgtKey | string | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
12. ListEmailConfig - 알림메일 발송설정 조회
- 세금계산서 관련 메일 항목에 대한 발송설정을 확인합니다.
List<EmailConfig> ListEmailConfig(string CorpNum, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
13. UpdateEmailConfig - 알림메일 발송설정 수정
- 세금계산서 관련 메일 항목에 대한 발송설정을 수정합니다.
Response UpdateEmailConfig(string CorpNum, string EmailType, bool SendYN, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| EmailType | string | - | Y |
메일 전송 유형 (택 1)
정발행
역발행
위수탁 발행
처리결과
정기발송
|
|
| SendYN | bool | - | Y |
메일 전송 여부
true전송
false미전송
|
|
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
14. GetSendToNTSConfig - 국세청 전송 옵션 설정 상태 확인
- 연동회원의 국세청 전송 옵션 설정 상태를 확인합니다. [참고] 팝빌 국세청 전송 정책
bool GetSendToNTSConfig(string CorpNum)
- 국세청 전송 옵션 설정은 팝빌 사이트 (https://www.popbill.com) 로그인 > 전자세금계산서 > 관리 > 환경설정 메뉴에서 설정할 수 있으며, API로 설정은 불가능 합니다.
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) |
응답
bool - true : (발행 즉시 전송) / false : (익일 자동 전송)












