SoftLayer Billing Invoice::getPDF

From SoftLayer Development Network Wiki

getPDF is a member of the SoftLayer_Billing_Invoice service.

Contents 1 Overview 2 Return Type 3 Headers 3.1 Required Headers 4 Error Handling 5 External Links

Overview

Retrieve a PDF record of a SoftLayer invoice. SoftLayer keeps PDF records of all closed invoices for customer retrieval from the portal and API. You must have a PDF reader installed in order to view these invoice files.

Return Type

getPDF returns the binary data type.

Headers

Required Headers

getPDF requires the following headers set:

• authenticate
• SoftLayer_Billing_InvoiceInitParamater

Error Handling

getPDF throws the following exceptions:

• SoftLayer_Exception.

Throw the exception "PDF does not exist: invoice has not yet been closed." when trying to retrieve an open invoice. Open invoices do not have PDF records.

• SoftLayer_Exception.

Throw the exception "PDF does not exist: file not found" if the API is unable to locate the PDF File for the invoice.

• SoftLayer_Exception.

Throw the exception "Unable to load a valid invoice PDF." if the PDF for this invoice is a corrupted.

External Links

• Portable Document Format at Wikipedia