Example: Cancel a Lifecycle-Managed Asset

Review an example of using Connect REST API to cancel an asset to reflect an early cancellation.

A lifecycle-managed asset must have at least one asset state period at least 24 hours long.

On 12/01, your customer wants to cancel all 25 of their licenses for the rest of the year. The cancel order results in the following order product.

ID: 1250

Date of Cancellation: 12/01/20 9:00:00am PST

Start Date: 12/01/20 9:00:00am PST

End Date: 12/31/20 8:59:59am PST

Amount: –$250

Quantity: –25

To represent the cancellation, create an asset state period running from 10/01 through 11/30, but use the same quantity, monthly recurring revenue, and amount as the period that originally ended on 12/31. Because the latest period now runs through 11/30, Customer Asset Lifecycle Management removes all 25 licenses in December from the asset’s total amount. The asset’s Amount field reflects the –$250 in canceled licenses.

/services/data/v50.0/asset-management/assets/02iB00000007bZ6IAI/actions/cancel

API output for a sample canceled asset.

  • Cancel Asset