# 정보확인

## 1. GetInfo - 상태 확인

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

```vb
Function GetInfo(CorpNum, itemCode, mgtKey, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- itemCode `type: Integer` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKey `type: String` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**StatementInfo**

- itemCode `type: Integer` `length: 3` `description: 전자명세서 문서 유형`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- itemKey `type: String` `length: 18` `description: 팝빌번호`
  - 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
- invoiceNum `type: String` `length: 24` `description: 팝빌 승인번호`
  - 전자명세서 발행 시점에 팝빌에서 자동으로 할당
- mgtKey `type: String` `length: 24` `description: 파트너가 할당한 문서번호`
- taxType `type: String` `length: 2` `description: 과세형태`
  - `과세`
  - `영세`
  - `면세`
- writeDate `type: String` `length: 8` `description: 작성일자`
  - 형식 : yyyyMMdd
- regDT `type: String` `length: 14` `description: 임시저장일시`
  - 형식 : yyyyMMddHHmmss
- senderCorpName `type: String` `length: 200` `description: 발신자 상호`
- senderCorpNum `type: String` `length: 10` `description: 발신자 사업자번호`
- senderPrintYN `type: Boolean` `length: -` `description: 발신자 인쇄여부`
  - `True`: 인쇄
  - `False`: 미인쇄
- receiverCorpName `type: String` `length: 200` `description: 수신자 상호`
- receiverCorpNum `type: String` `length: 10` `description: 수신자 사업자번호`
- receiverPrintYN `type: Boolean` `length: -` `description: 수신자 인쇄여부`
  - `True`: 인쇄
  - `False`: 미인쇄
- supplyCostTotal `type: String` `length: 18` `description: 공급가액 합계`
- taxTotal `type: String` `length: 18` `description: 세액 합계`
- purposeType `type: String` `length: 2` `description: 영수/청구`
  - `영수`
  - `청구`
  - `없음`
- issueDT `type: String` `length: 14` `description: 발행일시`
  - 형식 : yyyyMMddHHmmss
- stateCode `type: Integer` `length: 3` `description: 상태코드`
  - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/statement/asp/response-code#state-code)
- stateDT `type: String` `length: 14` `description: 상태 변경일시`
  - 형식 : yyyyMMddHHmmss
- stateMemo `type: String` `length: 200` `description: 상태메모`
- openYN `type: Boolean` `length: -` `description: 개봉여부`
  - `True`: 개봉
  - `False`: 미개봉
- openDT `type: String` `length: 14` `description: 개봉 일시`
  - 형식 : yyyyMMddHHmmss

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 2. GetInfos - 다수건 상태 확인

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

```vb
Function GetInfos(CorpNum, itemCode, mgtKeyList, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- itemCode `type: Integer` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKeyList `type: Arrays` `length: 1,000` `required: Y` `description: 문서번호 목록`
  - 최대 : 1,000건
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**StatementInfo**

- itemCode `type: Integer` `length: 3` `description: 전자명세서 문서 유형`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- itemKey `type: String` `length: 18` `description: 팝빌번호`
  - 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
- invoiceNum `type: String` `length: 24` `description: 팝빌 승인번호`
  - 전자명세서 발행 시점에 팝빌에서 자동으로 할당
- mgtKey `type: String` `length: 24` `description: 파트너가 할당한 문서번호`
- taxType `type: String` `length: 2` `description: 과세형태`
  - `과세`
  - `영세`
  - `면세`
- writeDate `type: String` `length: 8` `description: 작성일자`
  - 형식 : yyyyMMdd
- regDT `type: String` `length: 14` `description: 임시저장일시`
  - 형식 : yyyyMMddHHmmss
- senderCorpName `type: String` `length: 200` `description: 발신자 상호`
- senderCorpNum `type: String` `length: 10` `description: 발신자 사업자번호`
- senderPrintYN `type: Boolean` `length: -` `description: 발신자 인쇄여부`
  - `True`: 인쇄
  - `False`: 미인쇄
- receiverCorpName `type: String` `length: 200` `description: 수신자 상호`
- receiverCorpNum `type: String` `length: 10` `description: 수신자 사업자번호`
- receiverPrintYN `type: Boolean` `length: -` `description: 수신자 인쇄여부`
  - `True`: 인쇄
  - `False`: 미인쇄
- supplyCostTotal `type: String` `length: 18` `description: 공급가액 합계`
- taxTotal `type: String` `length: 18` `description: 세액 합계`
- purposeType `type: String` `length: 2` `description: 영수/청구`
  - `영수`
  - `청구`
  - `없음`
- issueDT `type: String` `length: 14` `description: 발행일시`
  - 형식 : yyyyMMddHHmmss
- stateCode `type: Integer` `length: 3` `description: 상태코드`
  - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/statement/asp/response-code#state-code)
- stateDT `type: String` `length: 14` `description: 상태 변경일시`
  - 형식 : yyyyMMddHHmmss
- stateMemo `type: String` `length: 200` `description: 상태메모`
- openYN `type: Boolean` `length: -` `description: 개봉여부`
  - `True`: 개봉
  - `False`: 미개봉
- openDT `type: String` `length: 14` `description: 개봉 일시`
  - 형식 : yyyyMMddHHmmss

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 3. GetDetailInfo - 상세정보 확인

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

```vb
Function GetDetailInfo(CorpNum, itemCode, mgtKey, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- itemCode `type: Integer` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKey `type: String` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**Statement**

- itemCode `type: Integer` `length: 3` `description: 전자명세서 문서 유형`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKey `type: String` `length: 24` `description: 문서번호`
  - 전자명세서 관리를 위해 파트너가 할당하는 식별번호
- invoiceNum `type: String` `length: 24` `description: 팝빌 승인번호`
  - 전자명세서 발행 시점에 팝빌에서 자동으로 할당
- formCode `type: String` `length: 8` `description: 맞춤양식 코드`
- writeDate `type: String` `length: 8` `description: 작성일자`
  - 형식 : yyyyMMdd
- taxType `type: String` `length: 2` `description: 과세형태`
  - `과세`
  - `영세`
  - `면세`
  - {itemCode}=121 경우 반환
- purposeType `type: String` `length: -` `description: 영수/청구`
  - `영수`
  - `청구`
  - `없음`
- serialNum `type: String` `length: 30` `description: 일련번호`
- supplyCostTotal `type: String` `length: 18` `description: 공급가액 합계`
- taxTotal `type: String` `length: 18` `description: 세액 합계`
- totalAmount `type: String` `length: 18` `description: 합계금액`
- remark1 `type: String` `length: 150` `description: 비고 1`
- remark2 `type: String` `length: 150` `description: 비고 2`
- remark3 `type: String` `length: 150` `description: 비고 3`
- senderCorpNum `type: String` `length: 10` `description: 발신자 사업자번호 ('-' 제외)`
- senderTaxRegID `type: String` `length: 4` `description: 발신자 종사업장 식별번호`
  - 종사업장 식별번호는 4자리 숫자로만 구성
- senderCorpName `type: String` `length: 200` `description: 발신자 상호`
- senderCEOName `type: String` `length: 100` `description: 발신자 대표자성명`
- senderAddr `type: String` `length: 300` `description: 발신자 주소`
- senderBizType `type: String` `length: 100` `description: 발신자 업태`
- senderBizClass `type: String` `length: 100` `description: 발신자 종목`
- senderContactName `type: String` `length: 100` `description: 발신자 성명`
- senderDeptName `type: String` `length: 40` `description: 발신자 부서명`
- senderTEL `type: String` `length: 20` `description: 발신자 연락처`
- senderHP `type: String` `length: 20` `description: 발신자 휴대전화`
- senderEmail `type: String` `length: 100` `description: 발신자 메일주소`
- senderFAX `type: String` `length: 20` `description: 발신자 팩스번호`
- receiverCorpNum `type: String` `length: 10` `description: 수신자 사업자번호 ('-' 제외)`
- receiverTaxRegID `type: String` `length: 4` `description: 수신자 종사업장 식별번호`
  - 종사업장 식별번호는 4자리 숫자로만 구성
- receiverCorpName `type: String` `length: 200` `description: 수신자 상호`
- receiverCEOName `type: String` `length: 100` `description: 수신자 대표자성명`
- receiverAddr `type: String` `length: 300` `description: 수신자 주소`
- receiverBizType `type: String` `length: 100` `description: 수신자 업태`
- receiverBizClass `type: String` `length: 100` `description: 수신자 종목`
- receiverContactName `type: String` `length: 100` `description: 수신자 성명`
- receiverDeptName `type: String` `length: 40` `description: 수신자 부서명`
- receiverTEL `type: String` `length: 20` `description: 수신자 연락처`
- receiverHP `type: String` `length: 20` `description: 수신자 휴대전화`
- receiverEmail `type: String` `length: 100` `description: 수신자 메일주소`
- receiverFAX `type: String` `length: 20` `description: 수신자 팩스번호`
- businessLicenseYN `type: Boolean` `length: -` `description: 팝빌에 등록된 사업자등록증 첨부 여부`
  - `True`: 첨부
  - `False`: 미첨부
- bankBookYN `type: Boolean` `length: -` `description: 팝빌에 등록된 통장사본 첨부 여부`
  - `True`: 첨부
  - `False`: 미첨부
- smssendYN `type: Boolean` `length: -` `description: 알림문자 전송 여부`
  - `True`: 전송
  - `False`: 미전송
  - 수신자 : 수신자 휴대폰번호 {receiverHP}
- propertyBag `type: String` `length: -` `description: 추가속성`
  - 전자명세서 종류별 추가할 속성을 "key", "value" 형식으로 값을 입력 [\[참고\] 기본양식 추가속성](https://developers.popbill.com/guide/statement/introduction/statement-form#propertybag-table)
- detailList `type: StatementDetail( )` `length: -` `description: 거래 물품 상세정보`
  - 길이 제한 없음
  - serialNum `type: Integer` `length: -` `description: 일련번호`
    - 1부터 순차적으로 입력
  - purchaseDT `type: String` `length: 8` `description: 거래일자`
    - 형식 : yyyyMMdd
  - itemName `type: String` `length: 100` `description: 품명`
  - spec `type: String` `length: 60` `description: 규격`
  - qty `type: String` `length: 12` `description: 수량`
    - 소수점 아래 2번째 자리까지 입력 가능
  - unitCost `type: String` `length: 18` `description: 단가`
    - 소수점 아래 2번째 자리까지 입력 가능
    - 마이너스 금액 입력 가능
  - supplyCost `type: String` `length: 18` `description: 공급가액`
    - 정수만 입력 가능
    - 마이너스 금액 입력 가능, 소수점 아래 자동 절사
  - tax `type: String` `length: 18` `description: 세액`
    - 정수만 입력 가능
    - 마이너스 금액 입력 가능, 소수점 아래 자동 절사
  - remark `type: String` `length: 100` `description: 비고`
  - spare1 `type: String` `length: 100` `description: 여분1`
  - spare2 `type: String` `length: 100` `description: 여분2`
  - spare3 `type: String` `length: 100` `description: 여분3`
  - spare4 `type: String` `length: 100` `description: 여분4`
  - spare5 `type: String` `length: 100` `description: 여분5`
  - spare6 `type: String` `length: 100` `description: 여분6`
  - spare7 `type: String` `length: 100` `description: 여분7`
  - spare8 `type: String` `length: 100` `description: 여분8`
  - spare9 `type: String` `length: 100` `description: 여분9`
  - spare10 `type: String` `length: 100` `description: 여분10`
  - spare11 `type: String` `length: 100` `description: 여분11`
  - spare12 `type: String` `length: 100` `description: 여분12`
  - spare13 `type: String` `length: 100` `description: 여분13`
  - spare14 `type: String` `length: 100` `description: 여분14`
  - spare15 `type: String` `length: 100` `description: 여분15`
  - spare16 `type: String` `length: 100` `description: 여분16`
  - spare17 `type: String` `length: 100` `description: 여분17`
  - spare18 `type: String` `length: 100` `description: 여분18`
  - spare19 `type: String` `length: 100` `description: 여분19`
  - spare20 `type: String` `length: 100` `description: 여분20`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 4. CheckMgtKeyInUse - 문서번호 사용 여부 확인

파트너가 전자명세서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.

- 이미 사용 중인 문서번호는 중복 사용이 불가하고, 전자명세서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.

```vb
Function CheckMgtKeyInUse(CorpNum, itemCode, mgtKey)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- itemCode `type: Integer` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKey `type: String` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

### 응답

boolean - true : (사용중) / false : (미사용중)

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 5. Search - 목록 조회

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

```vb
Function Search(CorpNum, DType, SDate, EDate, State, ItemCode, Order, Page, PerPage, QString)
```

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

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- DType `type: String` `length: 1` `required: Y` `description: 검색일자 유형 (택 1)`
  - `R`: 등록일자
  - `W`: 작성일자
  - `I`: 발행일자
- SDate `type: String` `length: 8` `required: Y` `description: 검색 시작일자`
  - 형식 : yyyyMMdd
- EDate `type: String` `length: 8` `required: Y` `description: 검색 종료일자`
  - 형식 : yyyyMMdd
- State `type: Arrays` `length: -` `required: N` `description: 전자명세서 상태코드`
  - 2, 3번째 자리에 와일드카드(\*) 사용가능. 예) "1\*\*", "3\*\*" [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/statement/asp/response-code#state-code)
  - 기본값 : 전체조회
- ItemCode `type: Arrays` `length: -` `required: N` `description: 전자명세서 문서 유형 (다중 선택 가능)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
  - 기본값 : 전체조회
- Order `type: String` `length: 1` `required: Y` `description: 조회 기준일자 유형을 기준으로 하는 목록 정렬 방향`
  - `D`: 내림차순 : 기본값
  - `A`: 오름차순
- Page `type: Integer` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: Integer` `length: -` `required: N` `description: 페이지당 표시할 목록 건수`
  - 최대 : 1,000건
  - 기본값 : 500건
- QString `type: String` `length: -` `required: N` `description: 조회 검색어(거래처 상호/사업자번호)`
  - 기본값 : 전체조회

### 응답

**StmtSearchResult**

- code `type: Integer` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- message `type: String` `length: -` `description: API 처리에 대한 응답메시지`
- total `type: Integer` `length: -` `description: 총 검색결과 건수`
- perPage `type: Integer` `length: -` `description: 페이지당 목록 건수`
- pageNum `type: Integer` `length: -` `description: 페이지 번호`
- pageCount `type: Integer` `length: -` `description: 페이지 개수`
- list `type: StatementInfo( )` `length: -` `description: 전자명세서 상태/요약정보`
  - 함수 [\[GetInfo - 상태 확인\]](https://developers.popbill.com/reference/statement/asp/api/info#GetInfo)의 리턴값 구성과 동일
  - 최대 1,000건
  - itemCode `type: Integer` `length: 3` `description: 전자명세서 문서 유형`
    - `121`: 거래명세서
    - `122`: 청구서
    - `123`: 견적서
    - `124`: 발주서
    - `125`: 입금표
    - `126`: 영수증
  - itemKey `type: String` `length: 18` `description: 팝빌번호`
    - 팝빌에서 전자명세서 관리 목적으로 할당한 식별번호
  - invoiceNum `type: String` `length: 24` `description: 팝빌 승인번호`
    - 전자명세서 발행 시점에 팝빌에서 자동으로 할당
  - mgtKey `type: String` `length: 24` `description: 파트너가 할당한 문서번호`
  - taxType `type: String` `length: 2` `description: 과세형태`
    - `과세`
    - `영세`
    - `면세`
  - writeDate `type: String` `length: 8` `description: 작성일자`
    - 형식 : yyyyMMdd
  - regDT `type: String` `length: 14` `description: 임시저장일시`
    - 형식 : yyyyMMddHHmmss
  - senderCorpName `type: String` `length: 200` `description: 발신자 상호`
  - senderCorpNum `type: String` `length: 10` `description: 발신자 사업자번호`
  - senderPrintYN `type: Boolean` `length: -` `description: 발신자 인쇄여부`
    - `True`: 인쇄
    - `False`: 미인쇄
  - receiverCorpName `type: String` `length: 200` `description: 수신자 상호`
  - receiverCorpNum `type: String` `length: 10` `description: 수신자 사업자번호`
  - receiverPrintYN `type: Boolean` `length: -` `description: 수신자 인쇄여부`
    - `True`: 인쇄
    - `False`: 미인쇄
  - supplyCostTotal `type: String` `length: 18` `description: 공급가액 합계`
  - taxTotal `type: String` `length: 18` `description: 세액 합계`
  - purposeType `type: String` `length: 2` `description: 영수/청구`
    - `영수`
    - `청구`
    - `없음`
  - issueDT `type: String` `length: 14` `description: 발행일시`
    - 형식 : yyyyMMddHHmmss
  - stateCode `type: Integer` `length: 3` `description: 상태코드`
    - [\[참고\] 팝빌 상태코드](https://developers.popbill.com/reference/statement/asp/response-code#state-code)
  - stateDT `type: String` `length: 14` `description: 상태 변경일시`
    - 형식 : yyyyMMddHHmmss
  - stateMemo `type: String` `length: 200` `description: 상태메모`
  - openYN `type: Boolean` `length: -` `description: 개봉여부`
    - `True`: 개봉
    - `False`: 미개봉
  - openDT `type: String` `length: 14` `description: 개봉 일시`
    - 형식 : yyyyMMddHHmmss

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

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

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

```vb
Function GetLogs(CorpNum, itemCode, mgtKey, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- itemCode `type: Integer` `length: 3` `required: Y` `description: 전자명세서 문서 유형 (택 1)`
  - `121`: 거래명세서
  - `122`: 청구서
  - `123`: 견적서
  - `124`: 발주서
  - `125`: 입금표
  - `126`: 영수증
- mgtKey `type: String` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**StatementLog**

- docLogType `type: Integer` `length: 3` `description: 로그타입`
  - `100`: 임시저장
  - `101`: 수정
  - `102`: 개봉
  - `103`: 수신확인
  - `111`: 메일 재전송
  - `112`: 문자 재전송
  - `113`: 팩스 재전송
  - `122`: 문자 전송결과
  - `123`: 팩스 전송결과
  - `310`: 발행
  - `312`: 자동승인
  - `340`: 발행취소
- log `type: String` `length: 2000` `description: 이력정보`
- procType `type: String` `length: 3` `description: 처리형태`
  - `연동`: API를 통해 처리함
  - `일반`: 팝빌 사이트를 통해 처리함
  - `시스템`: 팝빌이 처리함
- procMemo `type: String` `length: 200` `description: 처리메모`
- regDT `type: String` `length: 14` `description: 등록일시`
  - 형식 : yyyyMMddHHmmss
- ip `type: String` `length: 39` `description: 아이피`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 7. GetURL - 문서함 팝업 URL

![문서함 팝업 URL 미리보기](https://developers.popbill.com/images/reference/statement/getURL.png)

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

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

```vb
Function GetURL(CorpNum, UserID, TOGO)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`
- TOGO `type: String` `length: -` `required: Y` `description: 접근 메뉴 (택 1)`
  - `TBOX`: 임시 문서함
  - `SWBOX`: 발행 문서함

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`