Authorization

The Authorization object represents a business entity that associates a product with a specific SoftwareOne seller. It is defined by a certain authorization level and an assigned price list. Listings are essential for managing the visibility and availability of products across different markets, as well as for effectively handling their lifecycle in a scalable manner.

The Authorization object contains the following attributes:

Field	Type	Description
id	string	Identifier for the authorization. Example: AUT-1234-4678
name	string	Name of the authorization. Example: Salesforce Enterprise License
externalIds	externalIds	Example: { "id": "ACC-1234-1234", "href": "/accounts/accounts/ACC-1234-1234", "name": "Microsoft", "icon": "/static/ACC-1234-1234/account.png" }
eligibility	boolean	Indicates if authorization is enabled for the tier 1 program
tier2	boolean	Indicates if authorization is enabled for tier 2 program
currency	string	Authorization currency.
notes	string	Optional notes.
product	product	The product that the authorization belongs to. Example: { "id": "PRD-1111-1111", "name": "Microsoft Office 365 NCE", "icon": "/static/PRD-1111-1111/logo.png" }
vendor	account	The vendor to which the authorization belongs. Example: { "id": "ACC-1234-1234", "name": "Microsoft", "icon": "/static/ACC-1234-1234/account.png" }
owner	seller	SoftwareOne seller entity. Example: { "id": "SEL-1234-4567", "name": "SoftwareOne, Inc." }
statistics	authorizationstatistics	Statistics about authorization. Example: { "subscriptions": 5, "agreements": 10, "listings": 3, "sellers": 2 }
audit	auditObject	Authorization of the last audit events. Example: { "created": { "at": "2023-12-14T17:28:57Z", "by": { ... } }, "updated": { "at": "2023-12-14T17:28:57Z", "by": { ... } } }

Example

AUTHORIZATION OBJECT

{
  "id": "AUT-1234-4678",
  "name": "Salesforce Enterprise License",
  "externalId": "WW-1001111",
  "currency": "EUR",
  "notes": "Notes about given authorization",
  "partnerProgram": true,
  "tier1": true,
  "tier2": false,
  "product": {
      "id": "PRD-1111-1111",    
      "name": "Microsoft Office 365 NCE",
      "icon": "/static/PRD-1111-1111/logo.png"
  },
  "vendor": {
    "id": "ACC-1234-1234",  
    "name": "Microsoft",
    "icon": "/static/ACC-1234-1234/account.png"
  },
  "owner": {
      "id": "SEL-1234-4567",        
      "name": "SoftwareOne, Inc."
  },
  "statistics": {
      "subscriptions" : 5,
      "agreements": 10,
      "listings": 4,
      "sellers": 1
  },
  "audit": {
    "created": { 
      "at": "2023-12-14T17:28:57Z", 
      "by": {
        "id": "UR-1234-1234-1234",
        "name": "John Smith",
        "icon": "/static/users/UR-1234-1234-1234.icon.svg"
      }
    },
    "updated": { 
      "at": "2023-12-14T17:28:57Z", 
      "by": {
        "id": "UR-1234-1234-1234",
        "name": "John Smith",
        "icon": "/static/users/UR-1234-1234-1234.icon.svg"
      }
    }
  }
}