Listings

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	Type	Description
id	string	The primary identifier for the listing.
product	product	A reference to the Product object.
authorization	authorization	A reference to the Authorization object.
seller	seller	A reference to the Seller object.
priceList	pricelist	A reference to the Price List 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	listingStatistics	The system calculated metrics about the listing.
audit	audit	A reference to the Audit object.

Listing Statistics

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

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