Requests

Request object

Field
Type
Description

id

string

Primary Request identifier

Example: "REQ-1671-0642"

href

string

Relative reference to object on API (always /v1/commerce/requests/{id})

Example: "/v1/commerce/requests/REQ-1671-0642"

status

string

Status of the request.

Example: "Querying"

client

Reference to client Account object.

Example:

{ 
  "id": "ACC-1234-4444",
  "name": "stark industries"
}

vendor

Reference to vendor Account object.

Example:

{ 
  "id": "ACC-1234-1111",
  "name": "Microsoft"
}

requester

User of requester, in client account.

Example:

{ 
  "id": "USR-1234-4444",
  "name": "John Smith"
}

assignee

User of vendor who is responsible to processing request.

Example:

{ 
  "id": "USR-1234-1111",
  "name": "Santa Claus"
}

product

Product

Example:

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

externalIds

ExternalIdsObject

Set of external IDs identifiers.

Example:

{
  "client": "12345678",
  "operations":	"07bf766b-c767-4293-9ab3",
  "vendor": "ABC-2023-C07-dbeee0b302c0"
}

parameters.order

ParameterValue[]

Request ordering parameters values

Example:

[
  {
    "id": "PRM-1234-1234-1234-1234",
    "name": "Tennant Id",
    "externalId": "tennant_id",
    "constraints": { ... },
    "value": "69b73824-ce76-4866-ad47-b615ae9d8998",
  }
]

error

ErrorObject

Error reported by validation procedure.

Example:

{
     "id": "E001234",
     "message": "Agreement provisioning failed due to unavailability of the item"
}

audit

AuditObject

Audit object with possible entries: created, updated, activated, terminated, according to lifecycle of the object.

Possible audit events: Created, Updated, and Querying.

Example:

{
  "created": { "at": "...", "by": { } },
  "updated": { "at": "...", "by": { } }
}

Example

{
  "id": "REQ-1671-0642",
  "href": "/commerce/requests/REQ-1671-0642",
  "status": "Querying",
  "client": { 
    "id": "ACC-1234-4444",
    "name": "Stark-industries"
  },
  "vendor": { 
    "id": "ACC-1234-1111",
    "name": "Microsoft"
  },
  "requester": { 
    "id": "USR-1234-4444",
    "name": "John Smith"
  },
  "assignee": { 
    "id": "USR-1234-1111",
    "name": "Santa Claus"
  },
  "product": {
    "id": "PRD-1111-1111-1111",
    "href": "/catalog/products/PRD-1111-1111-1111",
    "name": "Microsoft Office 365 NCE",
    "icon": "/static/PRD-1111-1111-1111/logo.png"
  }
}

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.