# 보기/인쇄

## 1. GetPopUpURL - 현금영수증 팝업 URL

| HTTP Method | 테스트(Sandbox)                                           | 운영(Production)                                    |
| ----------- | ------------------------------------------------------ | ------------------------------------------------- |
| GET         | <https://popbill-test.linkhub.co.kr/Cashbill/{MgtKey}> | <https://popbill.linkhub.co.kr/Cashbill/{MgtKey}> |

![현금영수증 팝업 URL 미리보기](https://developers.popbill.com/images/reference/cashbill/getPopUpURL.png)

**현금영수증 1건의 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 680px / height = 750px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**Path 파라미터**

- MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

**Query 파라미터**

- TG `type: string` `length: -` `required: Y` `description: 고정값 : POPUP`

**요청 예시**

```bash
curl --request GET \
  --url 'https://{domain}/Cashbill/{MgtKey}?TG=POPUP' \
  --header 'Authorization: Bearer {token}'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 팝업 URL`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}
```

## 2. GetViewURL - 현금영수증 팝업 URL \[보기 전용]

| HTTP Method | 테스트(Sandbox)                                           | 운영(Production)                                    |
| ----------- | ------------------------------------------------------ | ------------------------------------------------- |
| GET         | <https://popbill-test.linkhub.co.kr/Cashbill/{MgtKey}> | <https://popbill.linkhub.co.kr/Cashbill/{MgtKey}> |

![현금영수증 팝업 URL \[보기 전용\] 미리보기](https://developers.popbill.com/images/reference/cashbill/getViewURL.png)

**현금영수증 1건의 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 680px / height = 750px
- 페이지 하단에 기능 버튼이 존재하지 않습니다.
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**Path 파라미터**

- MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

**Query 파라미터**

- TG `type: string` `length: -` `required: Y` `description: 고정값 : VIEW`

**요청 예시**

```bash
curl --request GET \
  --url 'https://{domain}/Cashbill/{MgtKey}?TG=VIEW' \
  --header 'Authorization: Bearer {token}'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 팝업 URL [보기 전용]`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}
```

## 3. GetPrintURL - 인쇄 팝업 URL

| HTTP Method | 테스트(Sandbox)                                           | 운영(Production)                                    |
| ----------- | ------------------------------------------------------ | ------------------------------------------------- |
| GET         | <https://popbill-test.linkhub.co.kr/Cashbill/{MgtKey}> | <https://popbill.linkhub.co.kr/Cashbill/{MgtKey}> |

![인쇄 팝업 URL 미리보기](https://developers.popbill.com/images/reference/cashbill/getPrintURL.png)

**현금영수증 1건의 인쇄 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 820px / height = 725px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**Path 파라미터**

- MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

**Query 파라미터**

- TG `type: string` `length: -` `required: Y` `description: 고정값 : PRINT`

**요청 예시**

```bash
curl --request GET \
  --url 'https://{domain}/Cashbill/{MgtKey}?TG=PRINT' \
  --header 'Authorization: Bearer {token}'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 인쇄 팝업 URL`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/API?T=IRXSGITDREOTPOIRLPUHCB4BSBC4...NX7BMAR3="
}
```

## 4. GetMassPrintURL - 다건 인쇄 팝업 URL

| HTTP Method | 테스트(Sandbox)                                         | 운영(Production)                                  |
| ----------- | ---------------------------------------------------- | ----------------------------------------------- |
| POST        | <https://popbill-test.linkhub.co.kr/Cashbill/Prints> | <https://popbill.linkhub.co.kr/Cashbill/Prints> |

![다건 인쇄 팝업 URL 미리보기](https://developers.popbill.com/images/reference/cashbill/getMassPrintURL.png)

**현금영수증 다건의 인쇄 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 820px / height = 725px
- 1회 호출에 최대 100건까지 인쇄가 가능합니다.
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Content-Type `required: Y` `description: 요청 본문 형식`
  - `application/json`
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**요청 본문**

- \- `type: array` `length: 100` `required: Y` `description: 문서번호 목록`
  - 최대 : 100건

**요청 예시**

```bash
curl --request POST \
  --url 'https://{domain}/Cashbill/Prints' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '["TEST0001"]'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 다건 인쇄 팝업 URL`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/API?T=2ZU3PQGQII4UD3J7HW2EURIBS...AWPV2OWRUPGACA======"
}
```

## 5. GetMailURL - 메일 보기 팝업 URL

| HTTP Method | 테스트(Sandbox)                                           | 운영(Production)                                    |
| ----------- | ------------------------------------------------------ | ------------------------------------------------- |
| GET         | <https://popbill-test.linkhub.co.kr/Cashbill/{MgtKey}> | <https://popbill.linkhub.co.kr/Cashbill/{MgtKey}> |

![메일 보기 팝업 URL 미리보기](https://developers.popbill.com/images/reference/cashbill/getMailURL.png)

**현금영수증 발행 안내 메일의 ‘보기’ 버튼 URL을 반환합니다.**

- 권장 사이즈 : width = 680px / height = 750px
- 반환되는 URL은 유효기간 제한 없이 사용할 수 있습니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**Path 파라미터**

- MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

**Query 파라미터**

- TG `type: string` `length: -` `required: Y` `description: 고정값 : MAIL`

**요청 예시**

```bash
curl --request GET \
  --url 'https://{domain}/Cashbill/{MgtKey}?TG=MAIL' \
  --header 'Authorization: Bearer {token}'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 메일 보기 팝업 URL`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/Cash/025102315531300001.E?T=Q5LM53CQT8UNP83LS259R5SQA...5EQG"
}
```

## 6. GetPDFURL - PDF 다운로드 URL

| HTTP Method | 테스트(Sandbox)                                           | 운영(Production)                                    |
| ----------- | ------------------------------------------------------ | ------------------------------------------------- |
| GET         | <https://popbill-test.linkhub.co.kr/Cashbill/{MgtKey}> | <https://popbill.linkhub.co.kr/Cashbill/{MgtKey}> |

- 현금영수증 1건의 PDF 파일 다운로드 URL을 반환합니다.
- 반환되는 URL은 30초 동안만 사용이 가능합니다.

### Request

**요청 헤더**

- Authorization `required: Y` `description: 인증 토큰`
  - [\[참고\] 인증 및 헤더 설정](https://developers.popbill.com/api-reference/cashbill/getting-started/authorization)
- Accept-Language `required: N` `description: 응답 언어 설정`
  - `ko-KR`: 기본값
  - `en-US`
- Accept-Encoding `required: N` `description: 응답 압축 방식`
  - `gzip`
- X-PB-UserID `required: N` `description: 팝빌회원 아이디`

**Path 파라미터**

- MgtKey `type: string` `length: 24` `required: Y` `description: 파트너가 할당한 문서번호`

**Query 파라미터**

- TG `type: string` `length: -` `required: Y` `description: 고정값 : PDF`

**요청 예시**

```bash
curl --request GET \
  --url 'https://{domain}/Cashbill/{MgtKey}?TG=PDF' \
  --header 'Authorization: Bearer {token}'
```

### Response

**응답 본문**

- url `type: string` `length: -` `description: 현금영수증 PDF 다운로드 URL`

**응답 예시**

```json
{
    "url": "https://test.popbill.com/App/API?T=SRLKRJXIVD3BCHUOT57UJWIDWDEJYTKJNRF...P756YYKGQ===="
}
```