Asset

An asset is a one-time purchase item or a perpetual license within the Marketplace Platform. Assets assist vendors and SoftwareOne in differentiating each one-time item in the agreement.

The Asset object stores the fulfillment parameters provided by the vendor for these one-time items. This enables vendors to effectively identify and manage their one-time items by utilising the parameters stored during the fulfillment phase.

This object contains the following attributes:

Field Name	Data Type	Example
id	string	The ID of the asset. Example: AST-2876-9782-1823
name	string	The name of the asset. Example: Access LTSC 2024 for Stark
status	string	The status of the asset. Example: Active
lines	object (line)	[ { "id": "ALI-1234-1234-1234-0001", "item": { "id": "ITM-1234-1234-1234-0021", "name": "Adobe Illustrator" }, "quantity": 10, "price": { ... }, "subscription": { "id": "SUB-1234-1234-1234" } }, { "id": "ALI-1234-1234-1234-0002", "item": { "id": "ITM-4444-4444-4444-0031", "name": "Adobe Photoshop" }, "quantity": 1, "price": { ... } } ]
price	(object) price	{ "PPx1": 150, "SPx1": 165, "markup": 0.10, "margin": 0.11, "defaultMarkup": 5.0, "currency": "USD" }
externalIDs	(object) externalIDs	{ "client": "12345678", "vendor": "ABC-2023-C07-dbeee0b302c0" }
template	(object) template	{ "id": "TPL-2434-7545", "name": "Successful Deployment" }
parameters.fulfillment	(object) orderParameter	{ "name": "Order ID", "value": "ORD-2378-8237-9182", "constraints": { "readonly": false, "hidden": false, "required": true, "unique": false } }
audit	(object) audit	{ "created": { "at": "...", "by": { } }, "updated": { "at": "...", "by": { } }, "terminated": { "at": "...", "by": { } } }
agreement	(object) agreement	{ "id": "AGR-2634-1298-0221", "name": "Microsoft Agr for Stark Industries" }
product	(object) product	{ "id": "PRD-7562-8393-0192", "name": "Microsoft Perpetual" }
licensee	(object) licensee	{ "id": "LCE-7562-8393-0192", "name": "Stark Industries" }
listing	(object) listing	{ "id": "LST-1234-1234" }
priceList	(object) priceList	{ "id": "PRC-1234-5678-9012" }

Example response

{
  "id": "AST-2876-9782-1823", 
  "name": "Access LTSC 2024 for Stark",
  "status": "Active",
  "lines": [
   {
      "id": "ALI-1234-1234-1234-0001",
      "item": {
        "id": "ITM-1234-1234-1234-0021",
        "name": "Adobe Illustrator"
      },
      "quantity": 10,
      "price": { ... },
      "subscription": { "id": "SUB-1234-1234-1234" }
    },
    {
      "id": "ALI-1234-1234-1234-0002",
      "item": {
        "id": "ITM-4444-4444-4444-0031",
        "name": "Adobe Photoshop"
      },
      "quantity": 1,
      "price": { ... }
    }
  ],
  "price": {  
    "PPx1": 150,
    "SPx1": 165,
    "markup": 0.10,  
    "margin": 0.11,
    "defaultMarkup": 5.0,
    "currency": "USD"
  },
  "externalIDs": {
    "client": "12345678",
    "vendor": "ABC-2023-C07-dbeee0b302c0"
  },
  "template": {
      "id": "TPL-2434-7545",    
      "name": "Successful Deployment"
  },
  "parameters": {
    "fulfillment": {
        "name": "Order ID",
        "value": "ORD-2378-8237-9182",
        "constraints": {
            "readonly": false,
            "hidden": false,
            "required": true,
            "unique": false
        }
    }
  },
  "agreement": {
    "id": "AGR-2634-1298-0221",
    "name": "Microsoft Agr for Stark Industries"
  },
  "product": {
    "id": "PRD-7562-8393-0192",
    "name": "Microsoft Perpetual"
  },
  "licensee": {
    "id": "LCE-7562-8393-0192",
    "name": "Stark Industries"
  },
  "listing": {
    "id": "LST-1234-1234"
  },
  "priceList": {
    "id": "PRC-1234-5678-9012"
  },
  "audit": {
    "created": { "at": "...", "by": { } },
    "updated": { "at": "...", "by": { } }
  }
}