Listing

The Listing object represents a business entity that aligns a product with a specific SoftwareOne seller. It is defined by an authorization and an assigned price list. Listings are essential for managing the visibility and availability of products across different markets and for overseeing their lifecycle in an efficient and scalable way.

This object contains the following attributes:

Field Name	Data Type	Description
id	string	The primary identifier for the listing.
product	object	A reference to the product object.
authorization	object	A reference to the authorization object.
seller	object	A reference to the seller object.
priceList	object	A reference to the pricelist object.
primary	boolean	If the product has more associated listings with the same seller, the primary flag indicates the listing used in the purchase wizard.
notes	string	The user notes about the listing.
statistics	object (listingStatistics)	The system calculated metrics about the listing.
audit	object	A reference to the audit object.

Listing Statistics object

Field Name	Data Type	Description
subscriptions	integer	The number of associated subscriptions. Example: 10
agreements	integer	The number of associated agreements. Example: 5

Example response

{
  "id": "LST-1234-4678",  
  "product": {
    "id": "PRD-1111-1111",
    "name": "Microsoft Office 365 NCE",
    "icon": "/static/PRD-1111-1111/logo.png"
  },
  "authorization": {
    "id": "AUT-1234-4567",   
    "name": "Salesforce Enterprise License"
  }, 
  "seller": {
    "id": "SEL-1234-45678",   
    "name": "SoftwareOne, Inc."
  },
  "priceList": {
    "id": "PRC-1234-5678-1234"   
  },
  "primary": true,
  "notes": "This is the primary Listing for the EU.",
  "statistics": {
    "subscriptions": 10,
    "agreements": 5
  },
  "audit": {
    "created": { "at": "...", "by": { } },
    "updated": { "at": "...", "by": { } }
  },
}