Example: Generate a Lifecycle-Managed Asset

Review examples of using Connect REST API to create an asset and start tracking its quantity, amount, and monthly recurring revenue over its lifecycle.

Your sales rep sold a collection of mobile device management subscriptions to a local school district. The order product for the sale has the following values.

ID: 1234

Date of Sale: 09/05/19 4:00:00pm PST

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

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

Amount: $1,200

Quantity: 10

Build an integration that calls the Generate Asset API to generate an asset, asset action source, asset action, and asset state period.

/services/data/v50.0/asset-management/assets/actions/generate

Asset creation 1

Your sales rep sold a ramped deal for mobile device management subscriptions. The customer has 10 licenses for 01/01 through 06/30 and 20 licenses for 07/01 through 12/31. You want to recognize all the transactions as one asset.

ID: 1234

Date of Sale: 09/05/19 4:00:00pm PST

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

End Date: 06/30/20 8:59:59am PST

Amount: $600

Quantity: 10

ID: 1235

Date of Sale: 09/05/19 4:00:00pm PST

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

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

Amount: $1,200

Quantity: 20

In this case, you make one Generate Asset API call that passes in data for two asset state periods. The first asset state period represents the period from 01/01 through 06/30, with a quantity of 10. The second asset state period represents the period from 07/01 through 12/31, with a quantity of 20.

/services/data/v50.0/asset-management/assets/actions/generate

Asset creation 2

  • Generate Asset