Listing

The Listing object represents a business entity that aligns a product with a specific SoftwareOne seller. It's defined by an authorization and an assigned price list.

Listings are essential for managing the visibility and availability of products across markets.

This object contains the following attributes:

Field	Type	Description
id	string	(Read-only) The primary identifier for the listing.
product	object	(Read-only) Represents the product object.
eligibility	object, core	Represents the Listing Eligibility object, which defines the eligibility status.
authorization	object	(Read-only) Represents the authorization object.
vendor		The vendor that the listing belongs to.
seller	object	(Read-only) Represents the seller object.
priceList	object	Represents the pricelist object.
primary	boolean	Indicates the listing used in the purchase wizard. If the product has multiple associated listings from the same seller, the primary flag identifies which one is selected.
notes	string	(Optional) The user notes about the listing.
statistics	object	(Read-only) Represents the Listing Statistics object, containing system-calculated metrics about the listing.
audit	object	(Read-only) Represents the audit object.

Listing Statistics object

Field	Type	Description
subscriptions	integer	(Read-only) Number of associated subscriptions.
agreements	integer	(Read-only) Number of associated agreements.

Listing Eligibility object

Field	Type	Description
client	integer	Indicates direct client.
partner	integer	Indicates indirect client, also called partners.

Example

LISTING OBJECT

{
  "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 region.",
   "eligibility": {
    "client": true,
    "partner": true
  },
  "statistics": {
    "subscriptions": 10,
    "agreements": 5
  },
  "audit": {
    "created": { "at": "...", "by": { } },
    "updated": { "at": "...", "by": { } }
  },
}