Skip to main content
Skip table of contents

Method deleteFaxReport

This method is used to delete a fax job’s report data. The length of time report data can be stored in the Retarus infrastructure can be individually configured for each time the Webservice is accessed. The default value is 3 days. Once this period elapses, the report data is automatically deleted.

If you sent the fax job requests via a high availability URL, you have to send a delete request to both included data centers. Else, it will be likely that the job was not processed in the data center you referenced and hence cannot be deleted there. Please do not send a delete request directly to an HA URL but use the specific ones for the data centers.

Input parameter: DeleteReportRequest

Output parameter: DeleteReportResponse

DeleteReportRequest

Field name

Data type

Required

Multiple possible

jobId

String

Yes

No

jobId
Job ID for the job whose report is to be deleted

DeleteReportResponse

Field name

Data type

Required

Multiple possible

jobId

String

Yes

No

deleted

Boolean

Yes

No

jobId
Job ID for which the deletion of report data has been requested

deleted
true is displayed when the deletion has successfully occurred, otherwise false is displayed

Java sample code

JAVA
DeleteReportRequest deleteReportRequest = this.objectFactory.createDeleteReportRequest();

// Authentication:
deleteReportRequest.setUsername(_USERNAME_);
deleteReportRequest.setPassword(_PASSWORD_);

// Specify job:
deleteReportRequest.setJobId(_A_JOB_ID_);

// Fire request:
DeleteReportResponse deleteReportResponse = this.servicePort.deleteFaxReport(deleteReportRequest);

System.out.println("Report data for job " + deleteReportResponse.getJobId() + " was deleted successfully");

Request XML

XML
<ns2:DeleteReportRequest xmlns:ns2="http://retarus.com/fax4ba/faxws/3/0">
	<username>faxws@example.com</username>
	<password>faxws</password>
	<jobId>FJHAL0RNBW0AZ82ZX5FCET</jobId>
</ns2:DeleteReportRequest>

Response XML

XML
<ns2:DeleteReportResponse xmlns:ns2="http://retarus.com/fax4ba/faxws/3/0">
	<jobId>FJHAL0RNBW0AZ82ZX5FCET</jobId>
	<deleted>true</deleted>
</ns2:DeleteReportResponse>

Exceptions

TemporaryFailure
appears when the request currently cannot be processed due to an internal Webservice error.

WrongUserPassword
appears when the request contains invalid authentication data.

NotAvailable
appears when there is no report in the system for the job whose ID you specified.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.