SoftLayer Billing Item

From SoftLayer Development Network Wiki

Jump to: navigation, search

This page refers to the SoftLayer_Billing_Item service. For information on the SoftLayer_Billing_Item data type please see SoftLayer_Billing_Item (type).

Contents

Overview

Every individual item that a SoftLayer customer is billed for is recorded in the SoftLayer_Billing_Item data type. Billing items range from server chassis to hard drives to control panels, bandwidth quota upgrades and port upgrade charges. Softlayer invoices are generated from the cost of a customer's billing items. Billing items are copied from the product catalog as they're ordered by customers to create a reference between an account and the billable items they own.

Billing items exist in a tree relationship. Items are associated with each other by parent/child relationships. Component items such as CPU's, RAM, and software each have a parent billing item for the server chassis they're associated with. Billing Items with a null parent item do not have an associated parent item.

Endpoints

SOAP WSDL http://api.service.softlayer.com/soap/v3/SoftLayer_Billing_Item?wsdl
XML-RPC http://api.service.softlayer.com/xmlrpc/v3/SoftLayer_Billing_Item

Methods

cancelService

Cancel a service or resource

  • returns
boolean
  • parameters
None



cancelServiceOnAnniversaryDate

Cancel a service or resource on the next bill date

  • returns
boolean
  • parameters
None



getAccount

Retrieve the account that a billing item belongs to.

  • returns
SoftLayer_Account
  • parameters
None



getActiveAssociatedChildren

Retrieve a billing item's active associated child billing items. This includes "floating" items that are not necessarily child items of this billing item.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getActiveBundledItems

Retrieve a Billing Item's active bundled billing items.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getActiveChildren

Retrieve a Billing Item's active child billing items.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getAssociatedBillingItem

Retrieve a billing item's associated parent. This is to be used for billing items that are "floating", and therefore are not child items of any parent billing item. If it is desired to associate an item to another, populate this with the SoftLayer_Billing_Item ID of that associated parent item.

  • returns
SoftLayer_Billing_Item
  • parameters
None



getAssociatedBillingItemHistory

Retrieve a history of billing items which a billing item has been associated with.

  • returns
SoftLayer_Billing_Item_Association_HistoryArray
  • parameters
None



getAssociatedChildren

Retrieve a Billing Item's associated child billing items. This includes "floating" items that are not necessarily child billing items of this billing item.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getBillableChildren

Retrieve a billing item's recurring child items that have once been billed and are scheduled to be billed in the future.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getBundleItems

Retrieve a Billing Item's bundled billing items

  • returns
SoftLayer_Product_Item_BundlesArray
  • parameters
None



getBundledItems

Retrieve a Billing Item's bundled billing items'

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getCanceledChildren

Retrieve a Billing Item's active child billing items.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getCategory

Retrieve the item category to which the billing item's item belongs.

  • returns
SoftLayer_Product_Item_Category
  • parameters
None



getChildren

Retrieve a Billing Item's child billing items'

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getDowngradeItems

Retrieve for product items which have a downgrade path defined, this will return those product items.

  • returns
SoftLayer_Product_ItemArray
  • parameters
None



getInvoiceItem

Retrieve invoice items associated with this billing item

  • returns
SoftLayer_Billing_Invoice_Item
  • parameters
None



getItem

Retrieve the entry in the SoftLayer product catalog that a billing item is based upon.

  • returns
SoftLayer_Product_Item
  • parameters
None



getLocation

Retrieve the location of the billing item. Some billing items have physical properties such as the server itself. For items such as these, we provide location information.

  • returns
SoftLayer_Location
  • parameters
None



getNextInvoiceChildren

Retrieve a Billing Item's child billing items and associated items'

  • returns
SoftLayer_Billing_ItemArray
  • parameters
None



getNextInvoiceTotalOneTimeAmount

Retrieve a Billing Item's total, including any child billing items if they exist.'

  • returns
float
  • parameters
None



getNextInvoiceTotalOneTimeTaxAmount

Retrieve a Billing Item's total, including any child billing items if they exist.'

  • returns
float
  • parameters
None



getNextInvoiceTotalRecurringAmount

Retrieve a Billing Item's total, including any child billing items and associated billing items if they exist.'

  • returns
float
  • parameters
None



getNextInvoiceTotalRecurringTaxAmount

Retrieve a Billing Item's total, including any child billing items if they exist.'

  • returns
float
  • parameters
None



getObject

Retrieve a SoftLayer_Billing_Item record.

  • returns
SoftLayer_Billing_Item
  • parameters
None



getOrderItem

Retrieve a billing item's original order item. Simply a reference to the original order from which this billing item was created.

  • returns
SoftLayer_Billing_Order_Item
  • parameters
None



getOriginalLocation

Retrieve the original physical location for this billing item--may differ from current.

  • returns
SoftLayer_Location
  • parameters
None



getPackage

Retrieve the package under which this billing item was sold. A Package is the general grouping of products as seen on our order forms.

  • returns
SoftLayer_Product_Package
  • parameters
None



getParent

Retrieve a billing item's parent item. If a billing item has no parent item then this value is null.

  • returns
SoftLayer_Billing_Item
  • parameters
None



getParentVirtualGuestBillingItem

Retrieve a billing item's parent item. If a billing item has no parent item then this value is null.

  • returns
SoftLayer_Billing_Item
  • parameters
None



getPendingCancellationFlag

Retrieve this flag indicates whether a billing item is scheduled to be canceled or not.

  • returns
boolean
  • parameters
None



getPendingOrderItem

Retrieve the new order item that will replace this billing item.

  • returns
SoftLayer_Billing_Order_Item
  • parameters
None



getProvisionTransaction

Retrieve provisioning transaction for this billing item

  • returns
SoftLayer_Provisioning_Version1_Transaction
  • parameters
None



getServiceBillingItemsByCategory

Returns billing item in a given category code. Use this method to retrieve service billing items that you wish to cancel.

  • returns
SoftLayer_Billing_ItemArray
  • parameters
string categoryCode
boolean includeZeroRecurringFee



getSoftwareDescription

Retrieve a friendly description of software component

  • returns
SoftLayer_Software_Description
  • parameters
None



getUpgradeItem

Retrieve billing items whose product item has an upgrade path defined in our system will return the next product item in the upgrade path.

  • returns
SoftLayer_Product_Item
  • parameters
None



getUpgradeItems

Retrieve billing items whose product item has an upgrade path defined in our system will return all the product items in the upgrade path.

  • returns
SoftLayer_Product_ItemArray
  • parameters
None



removeAssociationId

Remove an association from an orphan billing item.

  • returns
boolean
  • parameters
None



setAssociationId

Set the associated billing item for an orphan billing item.

  • returns
boolean
  • parameters
integer associatedId



voidCancelService

Void a service cancellation that was previously made.

  • returns
boolean
  • parameters
None
Personal tools