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

A reference to the Product object.

authorization

A reference to the Authorization object.

seller

A reference to the Seller object.

priceList

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

The system calculated metrics about the listing.

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

{
  "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": { } }
  },
}

Last updated

Was this helpful?