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.

The Listings object contains the following attributes:

Field	Type	Description
id	string	The primary identifier for the listing.
product	product	Reference to Product object.
authorization	authorization	Reference to Authorization object.
seller	seller	Reference to Seller object.
priceList	Pricelist	Reference to 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	Any user notes about the Listing.
statistics	listingStatistics	The system calculated metrics about the listing.
audit	auditObject	Reference to the Audit object.

Listing Statistics

Field	Type	Description
subscriptions	integer	Number of associated subscriptions. Example: 10
agreements	integer	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 region.",
  "statistics": {
    "subscriptions": 10,
    "agreements": 5
  },
  "audit": {
    "created": { "at": "...", "by": { } },
    "updated": { "at": "...", "by": { } }
  },
}