2. 팩스전송

2.1. SendFAX - 팩스 전송

팩스 1건을 전송합니다. (최대 전송파일 개수: 20개)

faxService.sendFAX(CorpNum, Sender, Receiver, ReceiverName, FilePaths, ReserveDT, SenderName, AdsYN, Title, RequestNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
Sender	string	20	Y	발신번호 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
Receiver	string	20	Y	수신번호
ReceiverName	string	30	N	수신자명
FilePaths	Array		Y	전송파일 최대 : 20개 [참고] 권장 파일 확장자
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
SenderName	string	70	N	발신자명
AdsYN	boolean	-	N	광고팩스 전송여부 true광고 false일반 : 기본값
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

2.2. SendFAX - 팩스 전송 (동보전송)

동일한 팩스파일을 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 20개) (최대 1,000건)

faxService.sendFAX(CorpNum, Sender, Receiver, ReceiverName, FilePaths, ReserveDT, SenderName, AdsYN, Title, RequestNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
Sender	string	20	Y	발신번호 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
Receiver	FaxReceiver[ ]		Y	수신자 정보 최대 : 1,000건
ReceiverName	string	30	N	수신자명
FilePaths	Array		Y	전송파일 최대 : 20개 [참고] 권장 파일 확장자
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
SenderName	string	70	N	발신자명
AdsYN	boolean	-	N	광고팩스 전송여부 true광고 false일반 : 기본값
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

2.3. SendFaxBinary - 팩스 전송 (바이너리)

전송할 파일의 바이너리 데이터를 팩스 1건 전송합니다. (최대 전송파일 개수: 20개)

faxService.sendFaxBinary(CorpNum, Sender, Receiver, ReceiverName, BinaryFiles, ReserveDT, SenderName, AdsYN, Title, RequestNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
Sender	string	20	Y	발신번호 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
Receiver	string	20	Y	수신번호
ReceiverName	string	30	N	수신자명
BinaryFiles	BinaryFiles[ ]		Y	전송할 파일의 객체정보 최대 : 20개 [참고] 권장 파일 확장자
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
SenderName	string	70	N	발신자명
AdsYN	boolean	-	N	광고팩스 전송여부 true광고 false일반 : 기본값
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

2.4. SendFaxBinary - 팩스 전송 (바이너리 동보전송)

동일한 파일의 바이너리 데이터를 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 20개) (최대 1,000건)

faxService.sendFaxBinary(CorpNum, Sender, Receiver, ReceiverName, BinaryFiles, ReserveDT, SenderName, AdsYN, Title, RequestNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
Sender	string	20	Y	발신번호 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
Receiver	FaxReceiver[ ]		Y	수신자 정보 최대 : 1,000건
ReceiverName	string	30	N	수신자명
BinaryFiles	BinaryFiles[ ]		Y	전송할 파일의 객체정보 최대 : 20개 [참고] 권장 파일 확장자
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
SenderName	string	70	N	발신자명
AdsYN	boolean	-	N	광고팩스 전송여부 true광고 false일반 : 기본값
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

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

팝빌에서 반환받은 접수번호를 통해 팩스 1건을 재전송합니다.
발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

faxService.resendFAX(CorpNum, ReceiptNum, Sender, SenderName, Receiver, ReceiverName, ReserveDT, Title, RequestNum, UserID, success, error)

변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
ReceiptNum	string	18	Y	원본 팩스 접수번호
Sender	string	20	N	발신번호 발신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 발신번호
SenderName	string	30	N	발신자명 발신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 발신자명
Receiver	string	20	N	수신번호 수신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 수신번호
ReceiverName	string	30	N	수신자명 수신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 수신자명
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

2.6. ResendFAX - 팩스 재전송 (접수번호 동보전송)

동일한 팩스파일을 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수: 20개) (최대 1,000건)
발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

faxService.resendFAX(CorpNum, ReceiptNum, Sender, SenderName, Receiver, ReceiverName, ReserveDT, Title, RequestNum, UserID, success, error)

변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
ReceiptNum	string	18	Y	원본 팩스 접수번호
Sender	string	20	N	발신번호 발신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 발신번호
SenderName	string	30	N	발신자명 발신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 발신자명
Receiver	FaxReceiver[ ]		Y	수신자 정보 최대 : 1,000건
ReceiverName	string	30	N	수신자명
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

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

파트너가 할당한 요청번호를 통해 팩스 1건을 재전송합니다.
발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

faxService.resendFAXRN(CorpNum, OrgRequestNum, Sender, SenderName, Receiver, ReceiverName, ReserveDT, Title, RequestNum, UserID, success, error)

변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
OrgRequestNum	string	36	Y	원본 팩스 전송시 파트너가 할당한 요청번호(requestNum)
Sender	string	20	N	발신번호 발신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 발신번호
SenderName	string	30	N	발신자명 발신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 발신자명
Receiver	string	20	N	수신번호 수신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 수신번호
ReceiverName	string	30	N	수신자명 수신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 수신자명
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
Title	string	100	N	팩스제목
RequestNum	string	36	N	요청번호 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

2.8. ResendFAXRN - 팩스 재전송 (요청번호 동보전송)

파트너가 할당한 요청번호를 통해 다수건의 팩스를 재전송합니다. (최대 전송파일 개수: 20개) (최대 1,000건)
발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

faxService.resendFAXRN(CorpNum, OrgRequestNum, Sender, SenderName, Receiver, ReceiverName, ReserveDT, Title, RequestNum, UserID, success, error)

변환실패 사유로 전송실패한 팩스 접수건은 재전송이 불가합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
OrgRequestNum	string	36	Y	원본 팩스 전송시 할당한 요청번호(requestNum)
Sender	string	20	N	발신번호 발신번호를 변경해야할 경우 사용 기본값 : 원본 팩스 발신번호
SenderName	string	30	N	발신자명 발신자명을 변경해야할 경우 사용 기본값 : 원본 팩스 발신자명
Receiver	FaxReceiver[ ]		N	수신자 정보 수신자 정보를 변경해야할 경우 사용 최대 : 1,000건 기본값 : 원본 팩스 수신자 정보
ReceiverName	string	30	N	수신자명
ReserveDT	string	14	N	전송 예약일시 형식 : yyyyMMddHHmmss 기본값 : 즉시전송
Title	string	100	Y	팩스제목
RequestNum	string	36	Y	원본 팩스 전송시 파트너가 할당한 요청번호(requestNum)
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

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

Throws

PopbillException

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

팝빌에서 반환받은 접수번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)

faxService.cancelReserve(CorpNum, ReceiptNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
ReceiptNum	string	18	Y	예약팩스 전송요청시 팝빌로부터 반환 받은 접수번호
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

Response

Throws

PopbillException

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

파트너가 할당한 요청번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)

faxService.cancelReserveRN(CorpNum, RequestNum, UserID, success, error)

Parameters

변수명	타입	길이	필수	설명
CorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
RequestNum	string	36	Y	예약팩스 전송요청시 파트너가 할당한 요청번호
UserID	string	50	N	팝빌회원 아이디
success	function	-	Y	성공에 대한 콜백 함수
error	function	-	Y	실패에 대한 콜백 함수

Return

Response

Throws

PopbillException