팩스전송

1. SendFAX - 팩스 전송

팩스 1건을 전송합니다.

function SendFAX(CorpNum : String; sendnum : String; sendname : String; receiveNum : String; receiveName : String; filePath : String; reserveDT : String; UserID:String; adsYN:Boolean; Title:String; requestNum : String) : String;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	sendnum	String	20	Y	발신번호 → 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
3	sendname	String	70	N	발신자명
4	receiveNum	String	20	Y	수신번호
5	receiveName	String	70	N	수신자명
6	filePath	String	-	Y	전송파일 경로 → [참고] 권장 파일 확장자
7	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
8	UserID	String	50	N	팝빌회원 아이디
9	adsYN	Boolean	-	N	광고팩스 전송 여부 true 광고 false 일반 : 기본값
10	Title	String	100	N	팩스제목
11	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

2. SendFAX - 팩스 전송 (다중파일 전송)

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

function SendFAX(CorpNum : String; sendnum : String; sendname : String; receiveNum : String; receiveName : String; filePaths : Array Of String; reserveDT : String; UserID:String; adsYN:Boolean; title:String; requestNum : String) : String;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	sendnum	String	20	Y	발신번호 → 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
3	sendname	String	70	N	발신자명
4	receiveNum	String	20	Y	수신번호
5	receiveName	String	70	N	수신자명
6	filePaths	Array Of String	30	Y	파일 목록 → [참고] 권장 파일 확장자 최대 : 30개
7	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
8	UserID	String	50	N	팝빌회원 아이디
9	adsYN	Boolean	-	N	광고팩스 전송 여부 true 광고 false 일반 : 기본값
10	title	String	100	N	팩스제목
11	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

3. SendFAXSame - 팩스 전송 (동보전송)

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

function SendFAX(CorpNum : String; sendnum : String; sendname : String; receivers : TReceiverList; filePath : String; reserveDT : String; UserID:String; adsYN:Boolean; title:String; requestNum : String) : String;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	sendnum	String	20	Y	발신번호 → 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
3	sendname	String	70	N	발신자명
4	receivers	TReceiverList	-	Y	수신자 정보 → 최대 : 1,000건
TReceiverList 순번 변수명 타입 길이 필수 설명 1 receiveNum String 20 Y 팩스 단말기 번호 또는 인터넷 팩스 번호 2 receiveName String 30 N 수신자명 3 interOPRefKey String 20 N 파트너 지정키 → 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
5	filePaths	String	-	Y	전송파일 경로 → [참고] 권장 파일 확장자
6	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	UserID	String	50	N	팝빌회원 아이디
8	adsYN	Boolean	-	N	광고팩스 전송 여부 true 광고 false 일반 : 기본값
9	title	String	100	N	팩스제목
10	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

4. SendFAXMultiSame - 팩스 전송 (다중파일 동보전송)

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

function SendFAX(CorpNum : String; sendnum : String; sendname : String; receivers : TReceiverList; filePaths : Array Of String; reserveDT : String; UserID:String; adsYN:Boolean; title:String; requestNum : String) : String;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	sendnum	String	20	Y	발신번호 → 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
3	sendname	String	70	N	발신자명
4	receivers	TReceiverList	-	Y	수신자 정보 → 최대 : 1,000건
TReceiverList 순번 변수명 타입 길이 필수 설명 1 receiveNum String 20 Y 팩스 단말기 번호 또는 인터넷 팩스 번호 2 receiveName String 30 N 수신자명 3 interOPRefKey String 20 N 파트너 지정키 → 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
5	filePaths	Array Of String	30	Y	파일 목록 → [참고] 권장 파일 확장자 최대 : 30개
6	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	UserID	String	50	N	팝빌회원 아이디
8	adsYN	Boolean	-	N	광고팩스 전송 여부 true 광고 false 일반 : 기본값
9	title	String	100	N	팩스제목
10	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

팝빌에서 반환받은 접수번호를 통해 팩스 1건을 재전송합니다.

• 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

function ResendFAX(CorpNum : String; ReceiptNum : String; sendnum : Variant; sendname : String; receiveNum : String; receiveName : String; reserveDT : String; UserID:String = ''; title:String = ''; requestNum : String = '') : String;

팩스 재전송이 가능한 상태는 다음과 같습니다.

1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우

재전송이 가능한 변환 실패 코드는 아래와 같습니다.

• 414 : 팩스 변환 실패
• 415 : 팩스 변환 시간 초과
• 416 : 팩스 파일 처리 중 오류
• 498 : 기타 오류로 인한 변환 실패

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ReceiptNum	String	18	Y	원본 팩스 접수번호
3	sendnum	Variant	20	N	발신번호 → 발신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신번호
4	sendname	String	30	N	발신자명 → 발신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신자명
5	receiveNum	String	20	N	수신번호 → 수신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 수신번호
6	receiveName	String	70	N	수신자명 → 수신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 수신자명
7	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
8	UserID	String	50	N	팝빌회원 아이디
9	title	String	100	N	팩스제목
10	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

6. ResendFAXSame - 팩스 재전송 (접수번호 동보전송)

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

• 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

function ResendFAX(CorpNum : String; ReceiptNum : String; sendnum : Variant; sendname : String; receivers : TReceiverList; reserveDT : String; UserID:String = ''; title:String=''; requestNum : String = '') : String;

팩스 재전송이 가능한 상태는 다음과 같습니다.

1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우

재전송이 가능한 변환 실패 코드는 아래와 같습니다.

• 414 : 팩스 변환 실패
• 415 : 팩스 변환 시간 초과
• 416 : 팩스 파일 처리 중 오류
• 498 : 기타 오류로 인한 변환 실패

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ReceiptNum	String	18	Y	원본 팩스 접수번호
3	sendnum	Variant	20	N	발신번호 → 발신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신번호
4	sendname	String	30	N	발신자명 → 발신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신자명
5	receivers	TReceiverList	-	Y	수신자 정보 → 최대 : 1,000건
TReceiverList 순번 변수명 타입 길이 필수 설명 1 receiveNum String 20 Y 팩스 단말기 번호 또는 인터넷 팩스 번호 2 receiveName String 30 N 수신자명 3 interOPRefKey String 20 N 파트너 지정키 → 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
6	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	UserID	String	50	N	팝빌회원 아이디
8	title	String	100	N	팩스제목
9	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

파트너가 할당한 요청번호를 통해 팩스 1건을 재전송합니다.

• 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

function ResendFAXRN(CorpNum : String; requestNum : String; sendnum : Variant; sendname : String; receiveNum : String; receiveName : String; reserveDT : String; originalRequestNum : String; UserID:String = ''; title:String = '') : String;

팩스 재전송이 가능한 상태는 다음과 같습니다.

1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우

재전송이 가능한 변환 실패 코드는 아래와 같습니다.

• 414 : 팩스 변환 실패
• 415 : 팩스 변환 시간 초과
• 416 : 팩스 파일 처리 중 오류
• 498 : 기타 오류로 인한 변환 실패

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
3	sendnum	String	20	N	발신번호 → 발신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신번호
4	senderName	String	100	N	발신자명 → 발신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신자명
5	receiveNum	String	20	N	수신번호 → 수신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 수신번호
6	receiveName	String	70	N	수신자명 → 수신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 수신자명
7	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
8	originalRequestNum	String	36	Y	원본 팩스 요청번호
9	UserID	String	50	N	팝빌회원 아이디
10	title	String	100	N	팩스제목

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

8. ResendFAXRNSame - 팩스 재전송 (요청번호 동보전송)

파트너가 할당한 요청번호를 통해 다수건의 팩스를 재전송합니다. (최대 1,000건)

• 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

function ResendFAXRN(CorpNum : String; requestNum : String; sendnum : Variant; sendname : String; receivers : TReceiverList; reserveDT : String; originalRequestNum : String; UserID:String = ''; title:String='') : String;

팩스 재전송이 가능한 상태는 다음과 같습니다.

1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우

재전송이 가능한 변환 실패 코드는 아래와 같습니다.

• 414 : 팩스 변환 실패
• 415 : 팩스 변환 시간 초과
• 416 : 팩스 파일 처리 중 오류
• 498 : 기타 오류로 인한 변환 실패

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
3	sendnum	Variant	20	N	발신번호 → 발신번호를 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신번호
4	sendname	String	30	N	발신자명 → 발신자명을 변경해야할 경우 사용 ※ 기본값 : 원본 팩스 발신자명
5	receivers	TReceiverList	-	N	수신자 정보 → 수신자 정보를 변경해야할 경우 사용 최대 : 1,000건 ※ 기본값 : 원본 팩스 수신자 정보
TReceiverList 순번 변수명 타입 길이 필수 설명 1 receiveNum String 20 Y 팩스 단말기 번호 또는 인터넷 팩스 번호 2 receiveName String 30 N 수신자명 3 interOPRefKey String 20 N 파트너 지정키 → 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
6	reserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	originalRequestNum	String	36	Y	원본 팩스 요청번호
8	UserID	String	50	N	팝빌회원 아이디
9	title	String	100	N	팩스제목

응답

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

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

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

function CancelReserve(CorpNum : String; receiptNum : String; UserID : String = '') : TResponse;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	receiptNum	String	18	Y	팝빌에서 할당한 접수번호 → 팩스 예약전송 요청의 반환값
3	UserID	String	50	N	팝빌회원 아이디

응답

TResponse

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

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

function CancelReserveRN(CorpNum : String; requestNum : String; UserID : String = '') : TResponse;

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	requestNum	String	36	Y	파트너가 할당한 요청번호
3	UserID	String	50	N	팝빌회원 아이디

응답

TResponse

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

EPopbillException

순번	변수명	타입	길이	설명
1	code	LongInt	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지