# 전송

팝빌 팩스 전송에 대하여 안내합니다.

## 전송 안내

팩스를 팝빌로 접수하여 전송을 처리합니다. 팝빌은 직접 연계된 통신사의 다수 전송라인을 보유하여 자체 개발한 팩스 자동분배 시스템으로 접수된 팩스를 효율적으로 분배하여 신속하고 안정적으로 처리합니다.

팝빌로 접수하여 전송가능한 파일 확장자는 다음과 같습니다.

| 구분      | 확장자                                                                    |
| ------- | ---------------------------------------------------------------------- |
| Acrobat | **.pdf**                                                               |
| Office  | **.doc .docx .hwp .ppt .pptx** .txt .xls .xlsx .xlt .gul .rtf          |
| 이미지     | **.tif .tiff** .png .jpg .jpeg .bmp .gif .tga .psd .pcx .sgi .emf .wmf |

> **비권장 포맷 전송 시 유의사항**
>
> - 변환 과정에서 원본 파일의 페이지 보다 더 많은 장수의 페이지로 변환되어 전송될 수 있습니다.
> - 가로·세로 비율에 따라 문서가 임의로 회전되어 전송될 수 있습니다.

## 전송 프로세스

파일을 업로드하여 전송을 요청하고, 팝빌은 요청에 대한 접수번호를 반환합니다. [\[SendFAX - 팩스 전송\]](https://developers.popbill.com/api-reference/fax/api/send#SendFAX)

```mermaid
sequenceDiagram
    participant 파트너
    participant POPBiLL

    파트너->>POPBiLL: 팩스 전송 (SendFAX) <br/> 단건전송 / 동보전송 / 바이너리 전송 / 재전송
    POPBiLL-->>파트너: receiptNum(접수번호) 반환
```

> **원본파일 즉시삭제**
>
> - 민감한 개인정보가 포함된 데이터 유출을 사전에 차단하기 위하여 팩스 전송 완료 즉시 원본파일을 삭제하는 기능을 제공합니다.
> - 개인정보가 다수 포함된 서비스 신청서, 예약안내, 보험서류 등을 전송하는 다양한 플랫폼에서 활용할 수 있습니다.
> - “원본파일 즉시삭제” 기능이 필요한 파트너는 팝빌에 사전 문의하여 주시기 바랍니다. [\[연동문의\]](https://developers.popbill.com/customer-center/inquiry)

## 상태확인

팝빌에서 처리된 팩스 상태를 확인하는 방법은 2가지를 지원합니다.

- **Webhook(Push)**\
  팝빌에서 팩스 전송 상태가 변경된 시점에 파트너가 지정한 Callback URL로 이벤트 전송 [\[Webhook\]](https://developers.popbill.com/api-reference/fax/webhook/introduction)
- **API(Polling)**\
  파트너가 주기적으로 API를 호출하여 상태 확인

**Webhook(Push)**

```mermaid
sequenceDiagram
    participant 파트너
    participant Webhook Receiver
    participant POPBiLL

    파트너->>POPBiLL: Callback URL 등록
    파트너->>POPBiLL: 팩스 전송 (SendFAX)
    POPBiLL-->>파트너: receiptNum(접수번호) 반환
    POPBiLL->>POPBiLL: 통신사 전송 및 처리 완료
    POPBiLL->>Webhook Receiver: Webhook 실행 <br/> Event Type = "RESULT" <br/> state = 3(완료) <br/> result = 100(성공) or else(전송실패)
    Webhook Receiver->>Webhook Receiver: 결과 업데이트
```

**API(Polling)**

```mermaid
sequenceDiagram
    participant 파트너
    participant POPBiLL

    파트너->>POPBiLL: 팩스 전송 (SendFAX)
    POPBiLL-->>파트너: receiptNum(접수번호) 반환
    POPBiLL->>POPBiLL: 통신사 전송 및 결과반영
    파트너->>POPBiLL: GetFaxResult - 전송내역 확인
    POPBiLL-->>파트너: 전송상태 및 처리결과 반환 <br/> state = 3(완료) <br/> result = 100(성공) or else(전송실패)
    파트너->>파트너: 결과 업데이트
```

## 팩스 전송은 완료 되었으나 수신하지 못한 경우

팩스 전송결과가 성공이나 수신자가 팩스를 수신하지 못한 경우는 수신자에서 발생하는 문제의 가능성이 높습니다.\
프로그램 공급사는 아래의 수신자 점검사항을 참고하여 확인하여 주시기 바랍니다.

※ 전송결과 성공 : 팝빌 상태코드가 3(전송완료) 이면서 통신사 결과코드가 100(성공)인 상태 [\[팩스 상태\]](https://developers.popbill.com/api-reference/fax/response-code)

| 구분     | 수신자 점검사항                 |
| ------ | ------------------------ |
| 인터넷 팩스 | 발신번호 차단여부                |
| 인터넷 팩스 | 팩스 수신용량 초과여부             |
| 인터넷 팩스 | 팩스 수신내용 삭제여부             |
| 인터넷 팩스 | 수신 프로세스 파일 처리 과정에서 장애 발생 |
| 기기 팩스  | 물리적 인쇄 도구 부족 (토너, 용지)    |
| 기기 팩스  | 기기 전원 연결 여부              |
| 기기 팩스  | 착신 실패                    |
| 기기 팩스  | 팩스 수신내역에 기록 존재여부         |