2. 전자명세서 정보확인
2.1. GetInfo - 상태 확인
- 전자명세서의 1건의 상태 및 요약정보 확인합니다.
Function GetInfo(CorpNum As String, itemCode As Integer, mgtKey As String, Optional UserID As String = "") As PBDocInfo
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
itemCode | Integer | 3 | Y |
전자명세서 문서유형 (택 1)
|
|
mgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.2. GetInfos - 다수건 상태 확인
- 다수건의 전자명세서 상태 및 요약정보 확인합니다. (1회 호출 시 최대 1,000건 확인 가능)
Function GetInfos(CorpNum As String, itemCode As Integer, MgtKeyList As Collection, Optional UserID As String = "") As Collection
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
itemCode | Integer | 3 | Y |
전자명세서 문서유형 (택 1)
|
|
MgtKeyList | Collection | Y |
조회할 전자명세서 문서번호
최대 : 1,000건
|
||
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.3. GetDetailInfo - 상세정보 확인
- 전자명세서 1건의 상세정보 확인합니다.
Function GetDetailInfo(CorpNum As String, itemCode As Integer, mgtKey As String, Optional UserID As String = "") As PBStatement
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
itemCode | Integer | 3 | Y |
전자명세서 문서유형 (택 1)
|
|
mgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.4. CheckMgtKeyInUse - 문서번호 사용 여부 확인
- 파트너가 전자명세서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
- 이미 사용 중인 문서번호는 중복 사용이 불가하고, 전자명세서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.
Function CheckMgtKeyInUse(CorpNum As String, itemCode As Integer, mgtKey As String) As PBResponse
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
itemCode | Integer | 3 | Y |
전자명세서 문서유형 (택 1)
|
|
mgtKey | String | 24 | Y | 파트너가 할당한 문서번호 |
Return
Throws
2.5. Search - 목록 조회
- 검색조건에 해당하는 전자명세서를 조회합니다. (최대 조회기간 : 6개월)
Function Search(CorpNum As String, DType As String, SDate As String, EDate As String, state As Collection, itemCode As Collection, Page As Integer, PerPage As Integer, Order As String, Optional QString As String)
- 페이지 관련 항목(Page, PerPage, Order)을 활용하여 전자명세서 목록을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
DType | String | 1 | Y |
조회 기준일자 유형 (택 1)
R등록일자
W작성일자
I발행일자
|
|
SDate | String | 8 | Y |
조회 기간의 시작일자
형식 : yyyyMMdd
|
|
EDate | String | 8 | Y |
조회 기간의 종료일자
형식 : yyyyMMdd
|
|
state | Collection | Y |
전자명세서 상태코드
2, 3번째 자리에 와일드카드(*) 사용가능. 예) "1**", "3+*"
[참고] 팝빌 상태코드
기본값 : 전체조회
|
||
itemCode | Collection | N |
전자명세서 문서유형 (다중 선택 가능)
기본값 : 전체조회
|
||
Page | Integer | - | N |
목록 페이지번호
기본값 : 1
|
|
PerPage | Integer | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
Order | String | 1 | Y |
조회 기준일자 유형을 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
|
QString | String | - | Y |
조회 검색어(거래처 상호/사업자번호)
기본값 : 전체조회
|
Return
Throws
2.6. GetLogs - 전자명세서 상태 변경이력 확인
- 전자명세서의 상태에 대한 변경이력을 확인합니다.
Function GetLogs(CorpNum As String, itemCode As Integer, mgtKey As String, Optional UserID As String = "") As Collection
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
itemCode | Integer | 3 | Y |
전자명세서 문서유형 (택 1)
|
|
mgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.7. GetURL - 팝빌 전자명세서 문서함 팝업 URL
- 로그인 상태로 팝빌 사이트의 전자명세서 문서함 메뉴에 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
- 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
Function GetURL(CorpNum As String, UserID As String, TOGO As String) As String
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
UserID | String | 50 | N | 팝빌회원 아이디 | |
TOGO | String | - | Y |
접근 메뉴 (택 1)
|
Return
String - 요청에 대한 응답 URL