API Documentation > SOAP API > Outbound Fax Reference > SOAP Method Reference > Deprecated Methods > SendfaxEx

SendfaxEx

Description

[Retained for backward-compatibility; replaced by SendfaxEx_2]

Formal Definition

https://ws.interfax.net/dfs.asmx?op=SendfaxEx

Input

Please note that this method is retained for backward-compatibility only. We encourage new development to use the SendfaxEx_2 method.

Parameters:

Name Type Comments
Username String The name of the user authenticating to the API
Password String The password for the Username
FaxNumbers String A single fax number or a list of semicolon-separated fax numbers, e.g: 1-212-3456789;+44161-9998888;01132-45 45 45 45. Maximum number of fax numbers: 500.If multiple fax numbers are provided, multiple transactions with consecutive TransactionID’s will be created. All such transactions will share a single ParentTransactionID, whose value is the TransactionID of the FIRST transaction in the batch.
FilesData base64Binary

Binary data of the document(s). If two or more documents are uploaded, concatenate their binary data. The total length of this parameter is the sum of all items in the FileSizes parameter.

If an uploaded file’s size is greater than 250KB, or if experiencing timeouts, consider using the Chunk Data Upload methods. If referencing a file uploaded by these methods (using its SessionID in parameter FileSizes below), this parameter is ignored. Send a zero-size buffer.
FileTypes String List of FileType, semicolon-separated, e.g:DOC;HTML;HTML. Number of items in the list should match number of documents, even if all documents are of the same type.
FileSizes String List of numbers, semicolon-separated, each defining the length of a document. Example: 12034;8888;18478
If the file(s) were uploaded with the Chunk Data Upload method, add the string /sessionID=[session ID]. The SessionID is the one returned by the StartFileUpload call. Example: 12034;8888;18478/sessionID=123456
Postpone DateTime Time to schedule the transmission. In case no scheduling is required (i.e. ASAP), use any date in the past, like '2000-01-01'.
IsHighResolution Boolean True ==> Fine, False ==> Standard. True renders documents more finely but takes longer to transmit (may therefore be more costly).
CSID String Sender CSID (up to 20 characters). If not provided, user’s default CSID is used.
Subject String Up to 60 characters, to be used as a reference only. The Subject parameter can be obtained by status query, but is not included in the transmitted fax message.
ReplyAddress String An optional e-mail address to which feedback messages will be sent. If not provided, user’s default reply address is used.

Output

Name Type Comments
SendfaxExResult Long In case of successful submission – the value contains a Transaction ID. In case of a failure, a negative value is returned. List of return codes is shown on Appendix A.

Error Codes

Value Description
-111 Attempting to fax to a number that is not the designated fax number in a developer account.
-112 No valid recipients added or missing fax number.
-123 No valid documents attached.
-150 Internal System Error. An exception occurred at any point in the execution of the web service method.
-310 The logged in user in context is not a primary user. User is not authorized to operate actions on requested UserID.
-666 The user is configured in another switch group.
-677 The user does not have any TX service registered.
-710 At least one of the two parameters ReturnItems and ReturnStats should be set to true.
-1002 Number of types does not match number of document sizes string.
-1003 Authentication error: the user cannot be authenticated when either the username or the password is incorrect OR any other last error occurred when authenticating the user.
-1004 Missing file type.
-1007 Size value is not numeric or not greater than 0.
-1008 Total sizes does not match filesdata length.
-1010 Invalid file type parameter.
-1011 Too many data requests from the Username. (The maximum frequency of polling for fax status is defined under “System Limitations“.)
-1059 The required number of chunks does not match the total size.
-2003 The request from the IP of the machine is not in a valid IP address range.