Fax confirmation formats

When you send faxes through the ExtraFax Cloud email-to-fax service, you may choose to receive feedback confirmations.
You can select to receive confirmations on success of a transaction, on failure, always, or never.
To change this setting, please log in to your ExtraFax Cloud account.

These confirmations are standard email messages which are returned to the original sender address, different formats of these confirmations are available and will be defined below.

Confirmation Option: Plain Text

This returns a human-readable message with no HTML formatting. See the field descriptions below for an explanation of fields.

Confirmation Option: HTML - Local Language

This returns a human-readable email with both a text part and an HTML part. HTML-capable email programs will display only the HTML part. The content will be in the default language of the ExtraFax Cloud partner handling your account.

See the field descriptions below for an explanation of fields.

Confirmation Option: HTML - English

This returns a human-readable email with both a text part and an HTML part. HTML-capable email programs will display only the HTML part. The content will be in the English. See the field descriptions below for an explanation of fields.

Confirmation Option: CSV

This returns a machine-readable email, with details of your transaction as comma-separated values. The content fields are: TransactionID, CSID, PagesSent, Status, OriginalSubject, DestinationFax, Duration, SubmitTime, CompletionTime, Contact. See the field descriptions below for an explanation of fields.

Confirmation Option: XML

This returns a machine-readable email, with details of your transaction as an XML structure. An example structure is given below. See the field descriptions below for an explanation of tags.




   12345678
   PRODI'S PIZZA
   1
   0
   Online Pizza Order #5696523
   0013447974477
   52
   2005-12-07 13:45:01
   2005-12-07 13:47:41
   John Moore

When submitting a fax broadcast, a slightly more complex structure is returned, with the following format:



 
    TransactionID
    CSID
    PagesSent
    Status
    OriginalSubject
    DestinationFax
    Duration
    CompletionTime
    CompletionTime
    Contact
 
 
    TransactionID
    CSID
    PagesSent
    Status
    OriginalSubject
    DestinationFax
    Duration
    CompletionTime
    CompletionTime
    Contact
 
 
    TransactionID
    CSID
    PagesSent
    Status
    OriginalSubject
    DestinationFax
    Duration
    CompletionTime
    CompletionTime
    Contact
 
...

Field Descriptions

Field/Tag Description
TransactionID The transaction ID of the fax in the ExtraFax Cloud system. This is a unique identifier. Note that individual faxes sent to recipients in a fax broadcast each have a distinct transaction ID.
CSID Calling Station Identifier. This is the identifier set on the destination fax machine. Every fax machine can be programmed with its own identifier which includes up to 23 letters and digits.
PagesSent The number of complete pages successfully sent. Partially-sent faxes will display a number smaller than the number of pages originally submitted.
Status The result of the fax transmission. In human-readable confirmations, this will be spelled out in words. In machine-readable confirmations, see the list of ExtraFax Cloud Error Codes.
OriginalSubject The text inserted into the subject line of the outgoing email-to-fax. This is for reference only and is not used by ExtraFax Cloud. Note that advanced modifiers, such as /b, are removed from the information returned here.
DestinationFax The destination fax number in international canonical format.
Duration The duration in seconds of the outgoing fax.
SubmitTime The date and time at which ExtraFax Cloud received this fax for transmission. In ISO 8601 date/time format, i.e. yyyy-mm-dd hh:mm:ss.
CompletionTime The date and time at which ExtraFax Cloud completed handling of this fax, whether succesfully transmitted or not. In ISO 8601 date/time format, i.e. yyyy-mm-dd hh:mm:ss.