Authorizations

Authorization object

The Authorization object represents a business object that positions a Product within the purview of a particular SoftwareOne seller, characterized by a specific Authorization and an assigned Price List. Listings play a crucial role in controlling the visibility and availability of Products in various markets and managing their lifecycle in a scalable and efficient manner.

FieldTypeDescription

id

string

Authorization identifier.

Example: "AUT-1234-4678"

href

string

Relative reference to object on API (always /authorization/{id})

Example: "/v1/authorizations/AUT-1234-4678"

name

string

Name of the authorization.

Example: "Salesforce Enterprise License"

externalIds

Example:

{
  "vendor": "ven-1233-3222",
  "operations": "op-322-322",
}

currency

string

Authorization currency.

Example: "EUR"

notes

string

Optional notes

product

The Product that the Authorization belongs to.

Example:

{    
  "id": "PRD-1111-1111",
  "href": "/products/PRD-1111-1111",
  "name": "Microsoft Office 365 NCE",
  "icon": "/static/PRD-1111-1111/logo.png"
}

vendor

The Vendor that the Authorization belongs to.

Example:

{
  "id": "ACC-1234-1234",
  "href": "/accounts/accounts/ACC-1234-1234",
  "name": "Microsoft",
  "icon": "/static/ACC-1234-1234/account.png"
}

owner

SoftwareOne seller entity.

Example:

{
  "id": "SEL-1234-4567",
  "href": "/seller/SEL-1234-4567",
  "name": "SoftwareOne, Inc."
}

statistics

Statistics about authorization.

Example:

{
  "subscriptions": 5,
  "agreements": 10,
  "listings": 3,
  "sellers": 2
}

audit

Audit

Authorization last audit events.

Example:

{
  "created": { 
    "at": "2023-12-14T17:28:57Z", 
    "by": { ... }
  },
  "updated": { 
    "at": "2023-12-14T17:28:57Z", 
    "by": { ... }
  }
}

ExternalIds

ExternalIds contain any external identifier

FieldTypeDescription

operations

string

This external ID will be the unique identifier between vendor and SoftwareOne.

AuthorizationStatistics

FieldTypeDescription

subscriptions

integer

Number of Subscriptions that are assigned to Authorization.

Example: "5"

agreements

integer

Number of Agreements that are assigned to Authorization.

Example: "10"

listings

integer

Number of Listings that are referring to Authorization.

Example: "3"

sellers

integer

Number of Sellers that are referring to Authorization.

Example: "1"

Example

{
  "id": "AUT-1234-4678",
  "href": "/v1/authorization/AUT-1234-4678",
  "name": "Salesforce Enterprise License",
  "externalId": "WW-1001111",
  "currency": "EUR",
  "notes": "Notes about given authorization",
  "partnerProgram": true,
  "product": {
      "id": "PRD-1111-1111",
      "href": "/products/PRD-1111-1111",
      "name": "Microsoft Office 365 NCE",
      "icon": "/static/PRD-1111-1111/logo.png"
  },
  "vendor": {
    "id": "ACC-1234-1234",
    "href": "/accounts/accounts/ACC-1234-1234",
    "name": "Microsoft",
    "icon": "/static/ACC-1234-1234/account.png"
  },
  "owner": {
      "id": "SEL-1234-4567",    
      "href": "/seller/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"
      }
    }
  }
}

Last updated

SoftwareOne is a trademark of SoftwareOne, Inc. "The Software Licensing Experts" is a service mark of SoftwareOne, Inc. VAR assist is a trademark of SoftwareOne, Inc. "It pays to partner" is a service mark of SoftwareOne, Incorporated.