POPBill Developers
API Reference

2. 팩스전송

2.1. SendFAX - 팩스 전송

  • 동일한 팩스파일을 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 20개) (최대 1,000건)
function SendFAX($CorpNum, $Sender, $Receivers = array(), $FilePaths = array(), $ReserveDT = null, $UserID = null, $SenderName = null, $adsYN = false, $title = null, $RequestNum = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
Sender String 20 N 발신번호
└ 함수 [GetSenderNumberMgtURL - 발신번호 관리 팝업 URL] 또는 [GetSenderNumberList - 발신번호 목록 확인] 호출하여 등록 내역 확인 가능
※ 팝빌에 등록되지 않은 번호를 입력하는 경우 '원발신번호'로 팩스 전송됨
Receivers Receiver[ ] Y 수신자 정보 (최대 1,000건)
FilePaths Array Y 전송파일 (최대 20개)
ReserveDT String 14 N 전송 예약일시 (형식 : yyyyMMddHHmmss)
※ 미입력시 즉시 전송
UserID String 50 N 팝빌회원 아이디
SenderName String 100 N 발신자명
adsYN Boolean - N 광고메시지 전송여부 : true / false 중 택 1
└ true : 광고
└ false : 일반
※ 미입력시 기본값 false 처리
title String 100 N 팩스제목
RequestNum String 36 N 전송 요청번호 : 팝빌이 접수 단위를 식별할 수 있도록 파트너가 부여하는 식별번호
└ 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.2. SendFAXBinary - 팩스 전송 (바이너리)

  • 파일의 바이너리 데이터를 팩스 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 20개) (최대 1,000건)
function SendFAXBinary($CorpNum, $Sender, $Receivers = array(), $FileDatas = array(), $ReserveDT = null, $UserID = null, $SenderName = null, $adsYN = false, $title = null, $RequestNum = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
Sender String 20 N 발신번호
└ 함수 [GetSenderNumberMgtURL - 발신번호 관리 팝업 URL] 또는 [GetSenderNumberList - 발신번호 목록 확인] 호출하여 등록 내역 확인 가능
※ 팝빌에 등록되지 않은 번호를 입력하는 경우 '원발신번호'로 팩스 전송됨
Receivers Receiver[ ] Y 수신자 정보 (최대 1,000건)
FileDatas FileData[ ] Y 전송파일 정보 (최대 20개)
ReserveDT String 14 N 전송 예약일시 (형식 : yyyyMMddHHmmss)
※ 미입력시 즉시 전송
UserID String 50 N 팝빌회원 아이디
SenderName String 100 N 발신자명
adsYN Boolean - N 광고메시지 전송여부 : true / false 중 택 1
└ true : 광고
└ false : 일반
※ 미입력시 기본값 false 처리
title String 100 N 팩스제목
RequestNum String 36 N 전송 요청번호 : 팝빌이 접수 단위를 식별할 수 있도록 파트너가 부여하는 식별번호
└ 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.3. ResendFAX - 팩스 재전송 (접수번호)

  • 팝빌에서 반환받은 접수번호를 통해 팩스를 재전송합니다. (최대 1000건)
  • 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.
function ResendFAX($CorpNum, $ReceiptNum, $SenderNum, $SenderName, $Receivers, $ReserveDT = null, $UserID = null, $title = null, $RequestNum = null)
  • 변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
ReceiptNum String 18 Y 원본 팩스 접수번호
SenderNum String 20 N 발신번호
※ 미입력시 원본 팩스 전송정보로 전송
SenderName String 30 N 발신자명
※ 미입력시 원본 팩스 전송정보로 전송
Receivers Receiver[ ] N 수신자 정보 (최대 1,000건)
ReserveDT String 14 N 전송 예약일시 (형식 : yyyyMMddHHmmss)
※ 미입력시 즉시 전송
UserID String 50 N 팝빌회원 아이디
title String 100 N 팩스제목
RequestNum String 36 N 전송 요청번호 : 팝빌이 접수 단위를 식별할 수 있도록 파트너가 부여하는 식별번호
└ 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.4. ResendFAXRN - 팩스 재전송 (전송 요청번호)

  • 파트너가 할당한 전송 요청번호를 통해 팩스를 재전송합니다. (최대 1000건)
  • 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.
function ResendFAXRN($CorpNum, $RequestNum, $SenderNum, $SenderName, $Receivers, $originalFAXrequestNum, $ReserveDT = null, $UserID = null, $title = null)
  • 변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
RequestNum String 36 N 전송 요청번호 : 팝빌이 접수 단위를 식별할 수 있도록 파트너가 부여하는 식별번호
└ 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
SenderNum String 20 N 발신번호
※ 미입력시 원본 팩스 전송정보로 전송
SenderName String 30 N 발신자명
※ 미입력시 원본 팩스 전송정보로 전송
Receivers Receiver[ ] Y 수신자 정보 (최대 1,000건)
※ 미입력시 기존 전송정보로 전송
originalFAXrequestNum String 36 Y 원본 팩스 전송시 파트너가 할당한 전송 요청번호(requestNum)
ReserveDT Stirng 14 N 전송 예약일시 (형식 : yyyyMMddHHmmss)
※ 미입력시 즉시 전송
UserID String 50 N 팝빌회원 아이디
title String 100 N 팩스제목
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.5. CancelReserve - 예약전송 취소 (접수번호)

  • 팝빌에서 반환받은 접수번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)
function CancelReserve($CorpNum, $ReceiptNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
ReceiptNum String 18 Y 예약팩스 전송요청시 팝빌로부터 반환 받은 접수번호
UserID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

2.6. CancelReserveRN - 예약전송 취소 (전송 요청번호)

  • 파트너가 할당한 전송 요청번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)
function CancelReserveRN($CorpNum, $RequestNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
RequestNum String 36 Y 예약팩스 전송요청시 파트너가 할당한 전송 요청번호
UserID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException