ASO Event Entity Service (EES) version v23.3.0.0
https://ees.aso-api.jaggaer.com/
Async Status
Retrieve status and status-specific data for an asynchronous file process.
Returns the status of the asynchronous process associated with the specificed process ID.
get /asyncStatus/{encoded-async-pid}
Returns the status of the asynchronous process associated with the specificed process ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- encoded-async-pid: required(string)
Encoded async PID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns an ASO async status entity for the specified encoded async process ID.
When the process reaches a status of completed
the response will also contain a resultUrl
-- a pre-signed URL used to download the file.
Working With the Result URL (Pre-Signed URL)
The resultUrl
that is returned in the response of a completed
async process status is used to download the file. The resultUrl
will expire when resultUrlExpiresInSeconds
reaches 0. Once expired the value returned for resultUrlExpiresInSeconds
will be -1.
Pre-Signed URL -- 200 OK
The file streams to the client.
Pre-Signed URL -- 403 Forbidden
If the pre-signed URL has expired, the pre-signed URL will return 403 Forbidden with the following entity-body response:
<Error>
<Code>AccessDenied</Code>
<Message>Request has expired</Message>
<X-Amz-Expires>300</X-Amz-Expires>
<Expires>2020-09-08T20:05:05Z</Expires>
<ServerTime>2020-09-09T17:06:17Z</ServerTime>
<RequestId>XXXXXXXXXXXXXXXX</RequestId>
<HostId>
1HRM4RGKorg/xr1zG3f4tE3RyYU23ElyCc9Ih5YwxYcilUcElHWFXtY9OoIeUYiaggboFvRze1k=
</HostId>
</Error>
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- status: required(one of processing, cancelled, failed, completed)
Example:
processing
- resultUrl: (string)
URL used to download file once async process is in
completed
state. (Max length: 65k)NOTE: This field is only visible when status is
completed
- resultUrlExpiresInSeconds: (integer)
Number of seconds before
resultUrl
expires.NOTE: This field is only visible when status is
completed
Example:
165
Examples:
completed:
{
"status": "completed",
"resultUrl": "https://s3.us-east-2.amazonaws.com/us-east-2.aso.qa.api.async-downloads/258_22534_50a0a503-a029-4316-894f-3a7fdcf07ab2?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210716T154359Z&X-Amz-SignedHeaders=host&X-Amz-Expires=300&X-Amz-Credential=AKIA5HYMQXHER7KSSZTN%2F20210716%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Signature=7cdbc913ef900e2eef7b5f6bed6a592d056e52d611053976a11e3175d92eb674",
"resultUrlExpiresInSeconds": 289
}
processing:
{
"status": "processing"
}
failed:
{
"status": "failed"
}
cancelled:
{
"status": "cancelled"
}
HTTP status code 400
Invalid encoded async process ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"INVALID_URL_PARAM": [
{
"asyncStatus": "MTYyNjQ3MTAxODQwNzoyMjg1MDoxOmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng=="
}
]
}
}
HTTP status code 403
Request expired; Invalid or unauthorized encoded async process ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
requestExpired:
{
"statuses": {
"REQUEST_EXPIRED": [
{
"expiresSeconds": "1800",
"elapsedSeconds": "1863"
}
]
}
}
authenticationForbidden1:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"msg": "Invalid or missing event-id"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Attribute
Retrieve, edit, and delete an ASO attribute by attribute ID.
Returns an ASO attribute entity for the specified attribute ID.
Updates an existing ASO attribute entity. Can be used to update any subset of the entity's writable fields.
Deletes an ASO attribute entity by the specified attribute ID.
get /event/{event-id}/apiAttribute/{attribute-id}
Returns an ASO attribute entity for the specified attribute ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- attribute-id: required(integer)
ASO attribute ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns a single event attribute matching the specified attribute ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- attributeId: (integer)
Attribute ID.
Example:
1
- name: required(string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: required(one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: required(one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- apiField: (union of string or nil)
Name of static API entity field to which this attribute maps. For dynamic API entity fields this value would by null.
Example:
itemId
- isNormalized: required(boolean)
Denotes whether an attribute is normalized; requires an attribute
type
ofstring
orselect-one
.Example:
true
- selectOneValues: (array of string)
List of valid select-one values. Included only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- normalizedValues: (array of string)
List of normalized-string values. Included only when
type
isstring
andisNormalized
istrue
.Example:
[ "value 1", "value 2", "value 3", "another normalized-string value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: required(boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: required(boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: required(boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: required(boolean)
Is historic attribute.
Example:
false
- isLocked: required(boolean)
Is attribute locked.
Example:
false
Example:
{
"attributeId": 1,
"name": "Test Item Attr",
"description": "Test item attr description.",
"attributeType": "item",
"type": "select-one",
"apiField": null,
"isNormalized": true,
"selectOneValues": [
"value 1",
"value 2",
"value 3",
"another select-one value"
],
"fractionalPrecision": 2,
"isRequired": false,
"lowValue": 1,
"highValue": 100,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Item Attrs",
"nameMix": "Test Item Attr(s)",
"isHistoric": false,
"isLocked": false
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Attribute ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
attributeNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"attributeId": "99"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
patch /event/{event-id}/apiAttribute/{attribute-id}
Updates an existing ASO attribute entity. Can be used to update any subset of the entity's writable fields.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- attribute-id: required(integer)
ASO attribute ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Content-Type: required(string)
Informs the server of the mediatype of the entity-body to be sent in the request.
Example:
application/vnd.sciquest.com.ees+json
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- attributeId: (integer)
Attribute ID. Required when updating multiple attribute entities in one request.
Example:
1
- name: (string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: (one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: (one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- selectOneValues: (array of string)
List of valid select-one values. Used only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: (boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: (boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: (boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: (boolean)
Is historic attribute.
Example:
false
- isLocked: (boolean)
Is attribute locked.
Example:
false
Example:
{
"name": "Test Supplier Attr 1 - Patched"
}
HTTP status code 200
Success; A 200 Success response indicates that the request was processed and that the entity was successfully updated.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Attribute updated in ASO without error. |
attributeId | Identifier of the updated attribute. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"SUCCESS": [
{
"attributeId": "1"
}
]
}
}
HTTP status code 400
Badly formed or missing entity-body in request.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"NULL_PAYLOAD": [
{
"payload": null
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Attribute ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
attributeNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"attributeId": "99"
}
]
}
}
HTTP status code 409
A 409 Conflict response indicates that there was a problem updating the entity. The reasons for the failure will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
ID_MISMATCH | --- | Attribute ID in path param does not match attributeId in entity-body. |
pathParamId | Attribute ID in path param. | |
entityBodyId | Attribute ID in entity-body. | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced attribute contains a value that exceeds a field's established character limit. |
attributeId | Attribute identifier. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
UNABLE_TO_UPDATE_ENTITY | --- | The referenced entity is not able to be updated. |
attributeId | Attribute identifier. | |
reason | Reason that attribute cannot be updated -- ATTRIBUTE_IS_PURPOSED, ATTRIBUTE_IN_CONSOLIDATION, ATTRIBUTE_IN_FEEDBACK, ATTRIBUTE_IN_EXPRESSION_OR_COST_MODEL, ATTRIBUTE_IN_SCENARIO | |
CANNOT_UPDATE_READONLY_FIELD | --- | The referenced attribute contains read-only fields that are not able to be updated. |
attributeId | Attribute identifier. | |
field | Name of the read-only field. | |
readonlyValue | Current/existing value of the read-only field. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ID_MISMATCH": [
{
"pathParamId": "1",
"entityBodyId": "2"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
delete /event/{event-id}/apiAttribute/{attribute-id}
Deletes an ASO attribute entity by the specified attribute ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- attribute-id: required(integer)
ASO attribute ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 204
Success; No content is returned.
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Attribute ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
attributeNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"attributeId": "99"
}
]
}
}
HTTP status code 409
A 409 Conflict response indicates that there was a problem deleting the entity. The reasons for the failure will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
UNABLE_TO_DELETE_ENTITY | --- | The referenced entity is not able to be deleted. |
attributeId | Attribute identifier. | |
reason | Reason that attribute cannot be deleted -- ATTRIBUTE_IS_PURPOSED, ATTRIBUTE_IN_CONSOLIDATION, ATTRIBUTE_IN_FEEDBACK, ATTRIBUTE_IN_EXPRESSION_OR_COST_MODEL, ATTRIBUTE_IN_SCENARIO | |
INVALID_ATTRIBUTE_TYPE | --- | Only bid, item, and supplier attributes are eligible for deletion. |
attributeId | Attribute identifier. | |
attributeType | Attribute type |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"UNABLE_TO_DELETE_ENTITY": [
{
"attributeId": "1",
"reason": "ATTRIBUTE_IS_PURPOSED"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Attributes
Retrieve, create, and edit one or more ASO attributes.
Returns all ASO attribute entities within the given event.
Creates one or more ASO event attribute entities.
Updates one or more existing ASO attribute entities. Can be used to update any subset of the entities' writable fields.
get /event/{event-id}/apiAttributes
Returns all ASO attribute entities within the given event.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns zero or more event attributes.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiAttribute
- attributeId: (integer)
Attribute ID.
Example:
1
- name: required(string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: required(one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: required(one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- apiField: (union of string or nil)
Name of static API entity field to which this attribute maps. For dynamic API entity fields this value would by null.
Example:
itemId
- isNormalized: required(boolean)
Denotes whether an attribute is normalized; requires an attribute
type
ofstring
orselect-one
.Example:
true
- selectOneValues: (array of string)
List of valid select-one values. Included only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- normalizedValues: (array of string)
List of normalized-string values. Included only when
type
isstring
andisNormalized
istrue
.Example:
[ "value 1", "value 2", "value 3", "another normalized-string value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: required(boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: required(boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: required(boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: required(boolean)
Is historic attribute.
Example:
false
- isLocked: required(boolean)
Is attribute locked.
Example:
false
Example:
[
{
"attributeId": 1,
"name": "Test Item Attr",
"description": "Test item attr description.",
"attributeType": "item",
"type": "select-one",
"apiField": null,
"isNormalized": true,
"selectOneValues": [
"value 1",
"value 2",
"value 3",
"another select-one value"
],
"fractionalPrecision": 2,
"isRequired": false,
"lowValue": 1,
"highValue": 100,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Item Attrs",
"nameMix": "Test Item Attr(s)",
"isHistoric": false,
"isLocked": false
},
{
"attributeId": 2,
"name": "Test Item Attr 2",
"description": "Test item attr description 2.",
"attributeType": "item",
"type": "string",
"apiField": null,
"isNormalized": false,
"fractionalPrecision": null,
"isRequired": false,
"lowValue": null,
"highValue": null,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Item Attr 2's",
"nameMix": "Test Item Attr 2(s)",
"isHistoric": false,
"isLocked": false
}
]
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
post /event/{event-id}/apiAttributes
Creates one or more ASO event attribute entities.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Content-Type: required(string)
Informs the server of the mediatype of the entity-body to be sent in the request.
Example:
application/vnd.sciquest.com.ees+json
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiAttribute
- attributeCode: required(string)
Unique attribute identifier. (Max length: 75)
NOTE: Used during POST requests only to track uniqueness of attributes in entity-body before ASO attrribute ID's are assigned. Not returned by GET requests or supported in PATCH or PUT requests.
Example:
attr-1
- name: required(string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: required(one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: required(one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- isNormalized: required(boolean)
Determines whether a
string
attribute is normalized; requires attributetype
ofstring
.Example:
true
- selectOneValues: (array of string)
List of valid select-one values. Used only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: required(boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: required(boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: required(boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: required(boolean)
Is historic attribute.
Example:
false
- isLocked: required(boolean)
Is attribute locked.
Example:
false
Example:
[
{
"attributeCode": "attr1",
"name": "Test Supplier Attr 1",
"description": "Test supplier attr 1 description.",
"attributeType": "supplier",
"type": "number",
"isNormalized": false,
"fractionalPrecision": 2,
"isRequired": false,
"lowValue": 1.55,
"highValue": 100,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Supplier Attributes 1",
"nameMix": "Test Supplier Attribute 1(s)",
"isHistoric": false,
"isLocked": false
},
{
"attributeCode": "attr2",
"name": "Test Supplier Attr2",
"description": "Test Supplier Attr 2 description.",
"attributeType": "supplier",
"type": "select-one",
"isNormalized": true,
"selectOneValues": [
"something",
"something else",
"again",
"and again"
],
"isRequired": true,
"visibleToBidder": true,
"visibleInManagement": true,
"isHistoric": false,
"isLocked": false
}
]
HTTP status code 207
Multi-Status; A 207 Multi-Status response indicates that the request was processed and that the response should be parsed to determine the status of each Attribute contained within the entity-body. An Attribute will have been created successfully or failed to create for any number of error conditions which will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Attribute created in ASO without error. |
attributeId | Auto-generated ID for the newly added attribute. | |
attributeCode | Transient code to identity the attribute. | |
DUPLICATE_VALUE | --- | Duplicate attributeCode found within the attributes making up the entity-body of the request. |
attributeCode | Transient code to identity the attribute. | |
field | Name of the field that is giving the duplicate value. | |
MISSING_REQUIRED_FIELD | --- | The referenced attribute is missing a required field in the request entity-body. |
attributeCode | Transient code to identity the attribute. | |
field | Name of the missing/required field. | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced attribute contains a value that exceeds a field's established character limit. |
attributeCode | Transient code to identity the attribute. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
INVALID_ENUM_VALUE | --- | A value was input for an enumerated field that does not match any of the valid options. Refer to the specific field's documentation for a list of acceptable values. |
attributeCode | Transient code to identity the attribute. | |
field | Name of the enum field. | |
value | Value that was attempted to be put into the field. | |
MISSING_SELECT_ONE_VALUES | --- | An attribute 'type' of 'select-one' was given, but the 'selectOneValues' array was not also populated. This is required for attributes of type 'select-one'. |
attributeCode | Transient code to identity the attribute. | |
field | Name of field that is missing. | |
ATTR_ERR_CAN_ONLY_NORMALIZE_STRINGS | --- | The field 'isNormalized' can only be set to 'true' for an attribute of type 'string'. |
attributeCode | Transient code to identity the attribute. | |
field | Name of the field that caused the error. | |
value | Value that was attempted to be put into the field. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
success:
{
"statuses": {
"SUCCESS": [
{
"attributeId": "1",
"attributeCode": "attr1"
},
{
"attributeId": "2",
"attributeCode": "attr2"
}
]
}
}
mixed:
{
"statuses": {
"SUCCESS": [
{
"attributeId": "1",
"attributeCode": "attr1"
}
],
"MISSING_REQUIRED_FIELD": [
{
"attributeCode": "attr3",
"field": "isHistoric"
},
{
"attributeCode": "attr3",
"field": "isLocked"
},
{
"attributeCode": "attr3",
"field": "name"
}
],
"MISSING_SELECT_ONE_VALUES": [
{
"attributeCode": "attr4",
"field": "selectOneValues"
}
],
"INVALID_ENUM_VALUE": [
{
"attributeCode": "attr2",
"field": "type",
"value": "select-none"
}
]
}
}
HTTP status code 400
Badly formed or missing entity-body in request.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"NULL_PAYLOAD": [
{
"payload": null
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
patch /event/{event-id}/apiAttributes
Updates one or more existing ASO attribute entities. Can be used to update any subset of the entities' writable fields.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Content-Type: required(string)
Informs the server of the mediatype of the entity-body to be sent in the request.
Example:
application/vnd.sciquest.com.ees+json
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiAttribute
- attributeId: (integer)
Attribute ID. Required when updating multiple attribute entities in one request.
Example:
1
- name: (string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: (one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: (one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- selectOneValues: (array of string)
List of valid select-one values. Used only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: (boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: (boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: (boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: (boolean)
Is historic attribute.
Example:
false
- isLocked: (boolean)
Is attribute locked.
Example:
false
Example:
[
{
"attributeId": 1,
"selectOneValues": [
"something",
"something else",
"something patched"
]
},
{
"attributeId": 2,
"name": "Test Supplier Attr 2 - Patched",
"description": "Test Supplier Attr 2 description - Patched."
}
]
HTTP status code 207
Multi-Status; A 207 Multi-Status response indicates that the request was processed and that the response should be parsed to determine the status of each Attribute contained within the entity-body. An Attribute will have been updated successfully or failed to update for any number of error conditions which will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Attribute updated in ASO without error. |
attributeId | Attribute ID of updated attribute. | |
ENTITY_NOT_FOUND | --- | Attribute with given ID could not be found. |
attributeId | Attribute identifier. | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced attribute contains a value that exceeds a field's established character limit. |
attributeId | Attribute identifier. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
UNABLE_TO_UPDATE_ENTITY | --- | The referenced entity is not able to be updated. |
attributeId | Attribute identifier. | |
reason | Reason that attribute cannot be updated -- ATTRIBUTE_IS_PURPOSED, ATTRIBUTE_IN_CONSOLIDATION, ATTRIBUTE_IN_FEEDBACK, ATTRIBUTE_IN_EXPRESSION_OR_COST_MODEL, ATTRIBUTE_IN_SCENARIO | |
CANNOT_UPDATE_READONLY_FIELD | --- | The referenced attribute contains read-only fields that are not able to be updated. |
attributeId | Attribute identifier. | |
field | Name of the read-only field. | |
readonlyValue | Current/existing value of the read-only field. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
success:
{
"statuses": {
"SUCCESS": [
{
"attributeId": "1"
},
{
"attributeId": "2"
}
]
}
}
mixed:
{
"statuses": {
"CANNOT_UPDATE_READONLY_FIELD": [
{
"attributeId": "39",
"field": "fractionalPrecision",
"readonlyValue": "2"
},
{
"attributeId": "39",
"field": "type",
"readonlyValue": "select-one"
}
],
"UNABLE_TO_UPDATE_ENTITY": [
{
"attributeId": "4",
"reason": "ATTRIBUTE_IS_PURPOSED"
}
]
}
}
HTTP status code 400
Badly formed or missing entity-body in request.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"NULL_PAYLOAD": [
{
"payload": null
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Attributes by Type
Retrieve one or more ASO attributes by attribute type.
Returns all ASO attribute entities with the specified attribute type.
get /event/{event-id}/attributeType/{attribute-type}/apiAttributes
Returns all ASO attribute entities with the specified attribute type.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- attribute-type: required(one of bid, item, supplier, supplier_contact)
ASO attribute type.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns zero or more event attributes of the specified attribute type.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiAttribute
- attributeId: (integer)
Attribute ID.
Example:
1
- name: required(string)
Attribute name. (Max length: 80)
Example:
Test Attribute
- description: (union of string or nil)
Attribute description. (Max length: 65,535)
Example:
Test attribute
- attributeType: required(one of bid, item, supplier, supplier_contact, rate)
Attribute type.
Example:
item
- type: required(one of string, memo, currency, integer, number, money, percent, date, time, date-time, yes-no, select-one)
Attribute value-type.
Type Description string String data. memo Extended string data. currency Three character currency code. E.g. 'USD' integer Whole number. number Floating point number. money Floating point number; displayed in ASO with a currency symbol. percent Multiplied by 100 when displayed in ASO. date Day, month and year; represented by UNIX Epoch time in milliseconds. time Hour, minute, second; represented by UNIX Epoch time in milliseconds. date-time Complete timestamp; represented by UNIX Epoch time in milliseconds. yes-no True/false flag. select-one Values can only be chosen from a predefined list. Example:
string
- apiField: (union of string or nil)
Name of static API entity field to which this attribute maps. For dynamic API entity fields this value would by null.
Example:
itemId
- isNormalized: required(boolean)
Denotes whether an attribute is normalized; requires an attribute
type
ofstring
orselect-one
.Example:
true
- selectOneValues: (array of string)
List of valid select-one values. Included only when
type
isselect-one
.Example:
[ "value 1", "value 2", "value 3", "another select-one value" ]
- normalizedValues: (array of string)
List of normalized-string values. Included only when
type
isstring
andisNormalized
istrue
.Example:
[ "value 1", "value 2", "value 3", "another normalized-string value" ]
- fractionalPrecision: (union of integer or nil)
Number of decimal places for value.
Example:
2
- isRequired: required(boolean)
Is attribute required.
Example:
false
- lowValue: (union of number or nil)
Used for validating value's lower limit. Applied only to numeric types-- integer, number, money.
Example:
2.5
- highValue: (union of number or nil)
Used for validating value's upper limit. Applied only to numeric types-- integer, number, money.
Example:
100
- visibleToBidder: required(boolean)
Is attribute visible to bidder.
Example:
true
- visibleInManagement: required(boolean)
Is attribute visible in management.
Example:
true
- namePlural: (union of string or nil)
Plural form of attribute name. (Max length: 80)
Example:
Test Attributes
- nameMix: (union of string or nil)
Mixed form of attribute name.
Example:
Test Attribute(s)
- isHistoric: required(boolean)
Is historic attribute.
Example:
false
- isLocked: required(boolean)
Is attribute locked.
Example:
false
Example:
[
{
"attributeId": 1,
"name": "Test Item Attr",
"description": "Test item attr description.",
"attributeType": "item",
"type": "select-one",
"apiField": null,
"isNormalized": true,
"selectOneValues": [
"value 1",
"value 2",
"value 3",
"another select-one value"
],
"fractionalPrecision": 2,
"isRequired": false,
"lowValue": 1,
"highValue": 100,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Item Attrs",
"nameMix": "Test Item Attr(s)",
"isHistoric": false,
"isLocked": false
},
{
"attributeId": 2,
"name": "Test Item Attr 2",
"description": "Test item attr description 2.",
"attributeType": "item",
"type": "string",
"apiField": null,
"isNormalized": false,
"fractionalPrecision": null,
"isRequired": false,
"lowValue": null,
"highValue": null,
"visibleToBidder": true,
"visibleInManagement": true,
"namePlural": "Test Item Attr 2's",
"nameMix": "Test Item Attr 2(s)",
"isHistoric": false,
"isLocked": false
}
]
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot not found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
attributeTypeNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"attributeType": "itemss"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Awards by Preferred Scenario (Asynchronous)
Initiate asynchronous process to retrieve ASO awards by preferred scenario.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/scenario/preferred/apiAwards/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The statusUrl
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiAwards model data in JSON format.
ApiAward Model:
Field | Type | Parent | Description |
---|---|---|---|
allocationId | integer | root | Allocation ID |
scenarioId | integer | root | Scenario ID |
bid | object | root | Award bid |
bidId | integer | bid | Bid ID |
supplierId | integer | bid | Supplier ID |
itemId | integer | bid | Item ID |
bidRound | integer | bid | Bid round bid was placed during |
bidRoundName | string | bid | Bid round name |
bidCurrency | string | bid | Currency code for bid |
capacity | number | bid | Bid capacity |
alternate | integer | bid | Bid alternate |
packageId | integer | bid | Package ID of parent package |
valid | boolean | bid | Is item valid |
approval | enum | bid | Bid approval status [approved, disapproved, not reviewed] |
createdDate | integer | bid | Bid creation date; 13-digit unix/epoch time |
lastModifiedDate | integer | bid | Date when this rate was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | bid | ASO user ID of user who last modified this rate |
attributes | array | bid | List of bid attributes (see below for attribute field details) |
item | object | root | Award item |
itemId | integer | item | Item ID |
itemCode | string | item | Item code; unique identifier |
name | string | item | Item name |
description | strnig | item | Item description |
itemClassNameId | integer | item | Item-class name ID |
avgHistoricPrice | number | item | Item average historic price |
quantity | number | item | Itme quantity |
valid | boolean | item | Is item valid |
uomName | string | item | UOM name (singular) |
itemCurrency | string | item | Item currency code |
attributes | array | item | List of item attributes (see below for attribute field details) |
supplier | object | root | Award supplier |
supplierId | integer | supplier | Supplier ID |
supplierCode | string | supplier | Supplier code; unique identifier |
name | string | supplier | Supplier name |
decription | string | supplier | Supplier description |
street1 | string | supplier | Supplier street1 address |
street2 | string | supplier | Supplier street2 address |
city | string | supplier | Supplier city |
state | string | supplier | Supplier state |
postalCode | string | supplier | Supplier postal code |
countryCode | string | supplier | Supplier country code |
valid | boolean | supplier | Is supplier valid |
contacts | array | supplier | List of supplier contacts (see below for contact field details) |
attributes | array | supplier | List of supplier attributes (see below for attribute field details) |
packageId | integer | root | Package ID of parent package |
bidRound | integer | root | Bid round bid was placed during |
quantity | integer | root | Item quantity |
basePrice | number | root | Base price |
scenarioProce | number | root | Scenario price |
discount | number | root | Discount |
price | number | root | Price |
historicPrice | number | root | Historic price |
isTailored | boolean | root | Is scenario/allocation tailored |
isAssignedAward | boolean | root | Is award asigned |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiContact Model:
Field | Type | Parent | Description |
---|---|---|---|
contactId | integer | contacts | Contact ID |
contactCode | string | contacts | Contact code; unique identifier |
string | contacts | Contact email address | |
name | string | contacts | Concatenation of contact firstName + ' ' + lastName. |
firstName | string | contacts | Contact first name |
lastName | string | contacts | Contact last name |
isPrimary | boolean | contacts | Is this the primary supplier contact |
prefix | string | contacts | Prefix for contact name |
suffix | string | contacts | Suffix for contact name |
jobTitle | string | contacts | Contact job title |
phone | string | contacts | Contact phone number |
fax | string | contacts | Contact fax number |
mobile | string | contacts | Contact mobile number |
pager | string | contacts | Contact pager number |
web | string | contacts | Contact web URL |
ApiAwards Data Example:
[
{
"allocationId":1,
"scenarioId":2,
"bid":{
"bidId":1,
"supplierId":2,
"itemId":1,
"bidRound":1,
"bidRoundName":"Bid Round 1",
"bidCurrency":"USD",
"capacity":1,
"alternate":0,
"packageId":0,
"valid":true,
"approval":"not reviewed",
"createdDate":1549996351000,
"attributes":[
{
"id":"1",
"name":"Item Price",
"value":"12.10"
}
]
},
"item":{
"itemId":1,
"itemCode":"1",
"name":"Item 1",
"description":"Item 1 description",
"itemClassNameId":1,
"avgHistoricPrice":1000,
"quantity":100,
"valid":true,
"uomName":"unit",
"itemCurrency":"USD",
"attributes":[
{
"id":"1",
"name":"Reserve Price",
"value":"10000.00"
}
]
},
"supplier":{
"supplierId":2,
"supplierCode":"scode3333",
"name":"Test Supplier",
"description":"Test supplier description.",
"street1":"100 Washington Rd.",
"street2":"Building 1",
"city":"Pittsburgh",
"state":"PA",
"postalCode":"15212",
"countryCode":"US",
"valid":true,
"attributes":[
{
"id":"1",
"name":"Test Supplier Attr",
"value":"10.00"
}
],
"contacts":null
},
"packageId":0,
"bidRound":1,
"quantity":50,
"basePrice":2200,
"scenarioPrice":2203.5,
"discount":0,
"price":2203.5,
"historicPrice":2274.94,
"isTailored":false,
"isAssignedAward":false
},
{
"allocationId":2,
"scenarioId":2,
"bid":{
"bidId":2,
"supplierId":3,
"itemId":2,
"bidRound":1,
"bidRoundName":"Bid Round 1",
"bidCurrency":"USD",
"capacity":1,
"alternate":0,
"packageId":0,
"valid":true,
"approval":"not reviewed",
"createdDate":1549996351000,
"attributes":[
{
"id":"1",
"name":"Item Price",
"value":"94.50"
}
]
},
"item":{
"itemId":2,
"itemCode":"2",
"name":"Item 2",
"description":"Item 2 description",
"itemClassNameId":1,
"avgHistoricPrice":2000,
"quantity":10,
"valid":true,
"uomName":"unit",
"itemCurrency":"USD",
"attributes":[
{
"id":"1",
"name":"Reserve Price",
"value":"1000.00"
}
]
},
"supplier":{
"supplierId":3,
"supplierCode":"scode3333",
"name":"Test Supplier",
"description":"Test supplier description.",
"street1":"100 Liberty Ave.",
"street2":"Building 2",
"city":"Pittsburgh",
"state":"PA",
"postalCode":"15212",
"countryCode":"US",
"valid":true,
"attributes":[
{
"id":"1",
"name":"Test Supplier Attr",
"value":"1000"
}
],
"contacts":null
},
"packageId":0,
"bidRound":1,
"quantity":35,
"basePrice":1200,
"scenarioPrice":3403.5,
"discount":0,
"price":3400.5,
"historicPrice":3374.94,
"isTailored":false,
"isAssignedAward":false
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found or preferred scenario does not currently exist in the event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
preferredScenarioNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"reason": "MISSING_PREFERRED_SCENARIO"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Awards by Scenario (Asynchronous)
Initiate asynchronous process to retrieve one or more ASO awards by scenario ID.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/scenario/{scenario-id}/apiAwards/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- scenario-id: required(integer)
ASO scenario ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The status
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiAwards model data in JSON format.
ApiAward Model:
Field | Type | Parent | Description |
---|---|---|---|
allocationId | integer | root | Allocation ID |
scenarioId | integer | root | Scenario ID |
bid | object | root | Award bid |
bidId | integer | bid | Bid ID |
supplierId | integer | bid | Supplier ID |
itemId | integer | bid | Item ID |
bidRound | integer | bid | Bid round bid was placed during |
bidRoundName | string | bid | Bid round name |
bidCurrency | string | bid | Currency code for bid |
capacity | number | bid | Bid capacity |
alternate | integer | bid | Bid alternate |
packageId | integer | bid | Package ID of parent package |
valid | boolean | bid | Is item valid |
approval | enum | bid | Bid approval status [approved, disapproved, not reviewed] |
createdDate | integer | bid | Bid creation date; 13-digit unix/epoch time |
lastModifiedDate | integer | bid | Date when this rate was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | bid | ASO user ID of user who last modified this rate |
attributes | array | bid | List of bid attributes (see below for attribute field details) |
item | object | root | Award item |
itemId | integer | item | Item ID |
itemCode | string | item | Item code; unique identifier |
name | string | item | Item name |
description | strnig | item | Item description |
itemClassNameId | integer | item | Item-class name ID |
avgHistoricPrice | number | item | Item average historic price |
quantity | number | item | Itme quantity |
valid | boolean | item | Is item valid |
uomName | string | item | UOM name (singular) |
itemCurrency | string | item | Item currency code |
attributes | array | item | List of item attributes (see below for attribute field details) |
supplier | object | root | Award supplier |
supplierId | integer | supplier | Supplier ID |
supplierCode | string | supplier | Supplier code; unique identifier |
name | string | supplier | Supplier name |
decription | string | supplier | Supplier description |
street1 | string | supplier | Supplier street1 address |
street2 | string | supplier | Supplier street2 address |
city | string | supplier | Supplier city |
state | string | supplier | Supplier state |
postalCode | string | supplier | Supplier postal code |
countryCode | string | supplier | Supplier country code |
valid | boolean | supplier | Is supplier valid |
contacts | array | supplier | List of supplier contacts (see below for contact field details) |
attributes | array | supplier | List of supplier attributes (see below for attribute field details) |
packageId | integer | root | Package ID of parent package |
bidRound | integer | root | Bid round bid was placed during |
quantity | integer | root | Item quantity |
basePrice | number | root | Base price |
scenarioProce | number | root | Scenario price |
discount | number | root | Discount |
price | number | root | Price |
historicPrice | number | root | Historic price |
isTailored | boolean | root | Is scenario/allocation tailored |
isAssignedAward | boolean | root | Is award asigned |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiContact Model:
Field | Type | Parent | Description |
---|---|---|---|
contactId | integer | contacts | Contact ID |
contactCode | string | contacts | Contact code; unique identifier |
string | contacts | Contact email address | |
name | string | contacts | Concatenation of contact firstName + ' ' + lastName. |
firstName | string | contacts | Contact first name |
lastName | string | contacts | Contact last name |
isPrimary | boolean | contacts | Is this the primary supplier contact |
prefix | string | contacts | Prefix for contact name |
suffix | string | contacts | Suffix for contact name |
jobTitle | string | contacts | Contact job title |
phone | string | contacts | Contact phone number |
fax | string | contacts | Contact fax number |
mobile | string | contacts | Contact mobile number |
pager | string | contacts | Contact pager number |
web | string | contacts | Contact web URL |
ApiAwards Data Example:
[
{
"allocationId":1,
"scenarioId":2,
"bid":{
"bidId":1,
"supplierId":2,
"itemId":1,
"bidRound":1,
"bidRoundName":"Bid Round 1",
"bidCurrency":"USD",
"capacity":1,
"alternate":0,
"packageId":0,
"valid":true,
"approval":"not reviewed",
"createdDate":1549996351000,
"attributes":[
{
"id":"1",
"name":"Item Price",
"value":"12.10"
}
]
},
"item":{
"itemId":1,
"itemCode":"1",
"name":"Item 1",
"description":"Item 1 description",
"itemClassNameId":1,
"avgHistoricPrice":1000,
"quantity":100,
"valid":true,
"uomName":"unit",
"itemCurrency":"USD",
"attributes":[
{
"id":"1",
"name":"Reserve Price",
"value":"10000.00"
}
]
},
"supplier":{
"supplierId":2,
"supplierCode":"scode3333",
"name":"Test Supplier",
"description":"Test supplier description.",
"street1":"100 Washington Rd.",
"street2":"Building 1",
"city":"Pittsburgh",
"state":"PA",
"postalCode":"15212",
"countryCode":"US",
"valid":true,
"attributes":[
{
"id":"1",
"name":"Test Supplier Attr",
"value":"10.00"
}
],
"contacts":null
},
"packageId":0,
"bidRound":1,
"quantity":50,
"basePrice":2200,
"scenarioPrice":2203.5,
"discount":0,
"price":2203.5,
"historicPrice":2274.94,
"isTailored":false,
"isAssignedAward":false
},
{
"allocationId":2,
"scenarioId":2,
"bid":{
"bidId":2,
"supplierId":3,
"itemId":2,
"bidRound":1,
"bidRoundName":"Bid Round 1",
"bidCurrency":"USD",
"capacity":1,
"alternate":0,
"packageId":0,
"valid":true,
"approval":"not reviewed",
"createdDate":1549996351000,
"attributes":[
{
"id":"1",
"name":"Item Price",
"value":"94.50"
}
]
},
"item":{
"itemId":2,
"itemCode":"2",
"name":"Item 2",
"description":"Item 2 description",
"itemClassNameId":1,
"avgHistoricPrice":2000,
"quantity":10,
"valid":true,
"uomName":"unit",
"itemCurrency":"USD",
"attributes":[
{
"id":"1",
"name":"Reserve Price",
"value":"1000.00"
}
]
},
"supplier":{
"supplierId":3,
"supplierCode":"scode3333",
"name":"Test Supplier",
"description":"Test supplier description.",
"street1":"100 Liberty Ave.",
"street2":"Building 2",
"city":"Pittsburgh",
"state":"PA",
"postalCode":"15212",
"countryCode":"US",
"valid":true,
"attributes":[
{
"id":"1",
"name":"Test Supplier Attr",
"value":"1000"
}
],
"contacts":null
},
"packageId":0,
"bidRound":1,
"quantity":35,
"basePrice":1200,
"scenarioPrice":3403.5,
"discount":0,
"price":3400.5,
"historicPrice":3374.94,
"isTailored":false,
"isAssignedAward":false
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Scenario ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
scenarioNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"scenarioId": "99"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Bids (Asynchronous)
Initiate asynchronous process to retrieve one or more ASO bids.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/apiBids/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The statusUrl
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiBids model data in JSON format.
ApiBid Model:
Field | Type | Parent | Description |
---|---|---|---|
bidId | integer | root | Bid ID |
supplierId | integer | root | Supplier ID |
itemId | integer | root | Item ID |
bidRound | integer | root | Bid round bid was placed during |
bidRoundName | string | root | Bid round name |
bidCurrency | string | root | Currency code for bid |
capacity | number | root | Bid capacity |
alternate | integer | root | Bid alternate |
packageId | integer | root | Package ID of parent package |
valid | boolean | root | Is item valid |
approval | enum | root | Bid approval status [approved, disapproved, not reviewed] |
createdDate | integer | root | Bid creation date; 13-digit unix/epoch time |
lastModifiedDate | integer | root | Date when this bid was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | root | ASO user ID of user who last modified this bid; 13-digit unix/epoch time |
attributes | array | root | List of bid attributes (see below for attribute field details) |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiBids Data Example:
[
{
"bidId": 101,
"supplierId": 1,
"itemId": 1,
"bidRound": 1,
"bidRoundName": "Round 1",
"bidCurrency": "USD",
"capacity": null,
"alternate": 0,
"packageId": 0,
"valid": true,
"approval": "not reviewed",
"createdDate": 1565730063000,
"lastModifiedDate":1683665883000,
"lastModifiedUserId":155375,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "99.09"
},
{
"id": "19",
"name": "Test Bid Attr",
"value": "Under"
}
]
},
{
"bidId": 102,
"supplierId": 1,
"itemId": 2,
"bidRound": 1,
"bidRoundName": "Round 1",
"bidCurrency": "USD",
"capacity": null,
"alternate": 0,
"packageId": 0,
"valid": true,
"approval": "not reviewed",
"createdDate": 1565730063000,
"lastModifiedDate":1683665883000,
"lastModifiedUserId":155375,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "11.01"
},
{
"id": "19",
"name": "Test Bid Attr",
"value": "Under"
}
]
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Bids by Bid Round (Asynchronous)
Initiate asynchronous process to retrieve one or more ASO bids by bid round.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/bidRound/{bid-round}/apiBids/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- bid-round: required(integer)
ASO bid round.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The statusUrl
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiBids model data in JSON format.
ApiBid Model:
Field | Type | Parent | Description |
---|---|---|---|
bidId | integer | root | Bid ID |
supplierId | integer | root | Supplier ID |
itemId | integer | root | Item ID |
bidRound | integer | root | Bid round bid was placed during |
bidRoundName | string | root | Bid round name |
bidCurrency | string | root | Currency code for bid |
capacity | number | root | Bid capacity |
alternate | integer | root | Bid alternate |
packageId | integer | root | Package ID of parent package |
valid | boolean | root | Is item valid |
approval | enum | root | Bid approval status [approved, disapproved, not reviewed] |
createdDate | integer | root | Bid creation date; 13-digit unix/epoch time |
lastModifiedDate | integer | root | Date when this bid was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | root | ASO user ID of user who last modified this bid; 13-digit unix/epoch time |
attributes | array | root | List of bid attributes (see below for attribute field details) |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiBids Data Example:
[
{
"bidId": 101,
"supplierId": 1,
"itemId": 1,
"bidRound": 1,
"bidRoundName": "Round 1",
"bidCurrency": "USD",
"capacity": null,
"alternate": 0,
"packageId": 0,
"valid": true,
"approval": "not reviewed",
"createdDate": 1565730063000,
"lastModifiedDate":1683665883000,
"lastModifiedUserId":155375,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "99.09"
},
{
"id": "19",
"name": "Test Bid Attr",
"value": "Under"
}
]
},
{
"bidId": 102,
"supplierId": 1,
"itemId": 2,
"bidRound": 1,
"bidRoundName": "Round 1",
"bidCurrency": "USD",
"capacity": null,
"alternate": 0,
"packageId": 0,
"valid": true,
"approval": "not reviewed",
"createdDate": 1565730063000,
"lastModifiedDate":1683665883000,
"lastModifiedUserId":155375,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "11.01"
},
{
"id": "19",
"name": "Test Bid Attr",
"value": "Under"
}
]
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Bid Round cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
bidRoundNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"bidRound": "99"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Item
Retrieve an ASO item by item ID.
Returns an ASO item entity by the specified item ID.
get /event/{event-id}/apiItem/{item-id}
Returns an ASO item entity by the specified item ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- item-id: required(integer)
ASO item ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns a single item matching the specified item ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- itemId: required(integer)
Item ID.
Example:
1
- itemCode: required(string)
Item code. Unique identifier. (Max length: 255)
Example:
itemcode-1
- name: required(union of string or nil)
Item name. (Max length: 65,535)
Example:
Test Item
- description: required(union of string or nil)
Item description. (Max length: 65,535)
Example:
Test item description.
- itemClassNameId: required(union of integer or nil)
Item-class name ID.
Example:
1
- avgHistoricPrice: (union of number or nil)
Item average historic price.
Example:
100
- quantity: required(union of number or nil)
Item quantity.
Example:
2
- valid: required(boolean)
Is item valid.
Example:
true
- uomName: required(union of string or nil)
UOM name (singular).
Example:
unit
- itemCurrency: required(union of string or nil)
Currency code for this item. (Max length: 3)
Example:
USD
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "name": "Test Item Attr", "value": "10.00" }, { "id": "2", "name": "Test Item Attr 2", "value": "Below" } ]
Example:
{
"itemId": 1,
"itemCode": "1",
"name": "Item 1",
"description": "Item 1 description",
"itemClassNameId": 1,
"avgHistoricPrice": 1000,
"quantity": 100,
"valid": true,
"uomName": "unit",
"itemCurrency": "USD",
"attributes": [
{
"id": "1",
"name": "Reserve Price",
"value": "10000.00"
},
{
"id": "2",
"name": "Bid Increment",
"value": "1000.00"
},
{
"id": "3",
"name": "Bid Increment Policy Range",
"value": "Below"
}
]
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Item ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
itemNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"itemId": "999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Items (Asynchronous)
Initiate asynchronous process to retrieve one or more ASO items.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/apiItems/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The statusUrl
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiItems model data in JSON format.
ApiItem Model:
Field | Type | Parent | Description |
---|---|---|---|
itemId | integer | root | Item ID |
itemCode | string | root | Item code; unique identifier |
name | string | root | Item name |
description | strnig | root | Item description |
itemClassNameId | integer | root | Item-class name ID |
avgHistoricPrice | number | root | Item average historic price |
quantity | number | root | Itme quantity |
valid | boolean | root | Is item valid |
uomName | string | root | UOM name (singular) |
itemCurrency | string | root | Item currency code |
attributes | array | root | List of item attributes (see below for attribute field details) |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiItems Data Example:
[
{
"itemId": 101,
"itemCode": "BPX101",
"name": "10 Count Blister Pack Extra Strength",
"description": null,
"itemClassNameId": 1,
"avgHistoricPrice": 800,
"quantity": null,
"valid": true,
"uomName": null,
"itemCurrency": true,
"attributes": [
{
"id": "74",
"name": "Unit",
"value": "EA"
}
]
},
{
"itemId": 102,
"itemCode": "BPR102",
"name": "10 Count Blister Pack Reg Strength",
"description": null,
"itemClassNameId": 1,
"avgHistoricPrice": null,
"quantity": null,
"valid": true,
"uomName": null,
"itemCurrency": true,
"attributes": [
{
"id": "74",
"name": "Unit",
"value": "EA"
}
]
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Items by User
Create one or more ASO items.
Creates one or more ASO item entities.
post /event/{event-id}/user/{user-id}/apiItems
Creates one or more ASO item entities.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- user-id: required(integer)
ASO user ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Content-Type: required(string)
Informs the server of the mediatype of the entity-body to be sent in the request.
Example:
application/vnd.sciquest.com.ees+json
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiItem
- itemCode: required(string)
Item code. Unique identifier. (Max length: 255)
Example:
itemcode-1
- name: required(string)
Item name. (Max length: 65,535)
Example:
Test Item
- description: required(union of string or nil)
Item description. (Max length: 65,535)
Example:
Test item description.
- itemClassNameId: required(union of integer or nil)
Item-class name ID.
Example:
1
- quantity: required(union of number or nil)
Item quantity.
Example:
2
- valid: required(boolean)
Is item valid.
Example:
true
- uomName: required(string)
UOM name (singular).
Example:
unit
- itemCurrency: required(union of string or nil)
Currency code for this item. (Max length: 3)
Example:
USD
- attributes: (union of array or nil)
List of attribute key, and values.
Example:
[ { "id": "1", "value": "10.00" }, { "id": "2", "value": "Below" } ]
Example:
[
{
"itemCode": "I-code1",
"name": "Item name 1",
"description": "Item description 1",
"itemClassNameId": 1,
"quantity": 2,
"valid": true,
"uomName": "unit",
"itemCurrency": "USD",
"attributes": [
{
"id": "26",
"value": "10000.00"
},
{
"id": "27",
"value": "10.00"
},
{
"id": "28",
"value": "Below"
},
{
"id": "29",
"value": "true"
}
]
},
{
"itemCode": "I-code2",
"name": "Item name 2",
"description": "Item description 2",
"itemClassNameId": 1,
"quantity": 2,
"valid": true,
"uomName": "unit",
"itemCurrency": "USD",
"attributes": [
{
"id": "26",
"value": "12000.00"
},
{
"id": "27",
"value": "12.00"
},
{
"id": "28",
"value": "Above"
},
{
"id": "29",
"value": "true"
}
]
}
]
HTTP status code 207
Success; A 207 Multi-Status response indicates that the request was processed and that the response should be parsed to determine the status of each Item contained within the entity-body. An Item will have been created successfully or failed to create for any number of error conditions which will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Item created in ASO without error. |
itemId | Identifier of the created item. | |
itemCode | Unique code to identify the created item. | |
ALREADY_EXISTS | --- | Item code already exists in this event. |
itemCode | ItemCode that was found to already exist. | |
DUPLICATE_VALUE | --- | Duplicate itemCode found within event or other items making up entity-body of the request. |
itemCode | ItemCode that was found to be a duplicate. | |
MISSING_REQUIRED_FIELD | --- | The referenced entity is missing a required field in the request entity-body. |
itemCode | Item identifier. | |
field | Name of the missing/required field. | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced entity contains a value that exceeds a field's established character limit. |
itemCode | Item identifier. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
INVALID_UOM_VALUE | --- | Invalid UOM name given in entity body. |
itemCode | Item identifier. | |
uomName | UOM name given. | |
ATTR_ERR_INVALID | --- | The referenced entity contains an invalid attribute definition. |
id | Attribute ID. | |
ATTR_ERR_UNKNOWN | --- | The referenced entity contains an unknown attribute ID. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_MISSING | --- | The referenced entity is missing a required attribute. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_NULL | --- | The referenced entity is passing NULL for a required attribute. |
id | Attribute ID. | |
ATTR_ERR_NUMERICAL_HIGH_RANGE | --- | The referenced entity contains an attribute value that exceeds the attributes configured highValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
highValue | Attribute configured highValue ceiling. | |
ATTR_ERR_NUMERICAL_LOW_RANGE | --- | The referenced entity contains an attribute value that falls below the attributes configured lowValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
lowValue | Attribute configured lowValue floor. | |
ATTR_ERR_NUMERICAL_PRECISION | --- | The referenced entity contains an attribute value that does not match the attribute's configured fractionalPrecision. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
actualPrecision | Precision of the value supplied in entity-body. | |
expectedPrecision | Attribute configured fractionalPrecision. | |
ATTR_ERR_NUMERICAL_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate numerical format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_DATE_TIME_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate date format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
format | Expected format. | |
ATTR_ERR_BOOLEAN_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate boolean format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
expected | Expected values. | |
ATTR_ERR_CURRENCY_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate currency code format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_SELECT_ONE_NOT_FOUND | --- | The referenced entity contains an attribute value that does match a valid select-one value. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_EXCEEDED_CHARACTER_LIMIT | --- | The referenced entity contains an attribute value that exceeds the character limit. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
limit | Character limit. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
success:
{
"statuses": {
"SUCCESS": [
{
"itemId": "1",
"itemCode": "I-code1"
},
{
"itemId": "2",
"itemCode": "I-code2"
}
]
}
}
mixed:
{
"statuses": {
"ATTR_ERR_SELECT_ONE_NOT_FOUND": [
{
"itemCode": "I-code3",
"id": "28",
"value": "Under"
}
],
"ALREADY_EXISTS": [
{
"itemCode": "I-code2"
}
],
"ATTR_ERR_REQUIRED_MISSING": [
{
"itemCode": "I-code3",
"id": "26"
},
{
"itemCode": "I-code3",
"id": "27"
}
]
}
}
HTTP status code 400
Badly formed request.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
noPayload:
{
"statuses": {
"NULL_PAYLOAD": [
{
"payload": null
}
]
}
}
noPerms:
{
"statuses": {
"INSUFFICIENT_PERMISSIONS": [
{
"userId": "999999"
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or User ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
userNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"userId": "999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Rate
Retrieve an ASO rate by rate ID.
Returns the ASO rate entity for the specified rate ID.
get /event/{event-id}/apiRate/{rate-id}
Returns the ASO rate entity for the specified rate ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- rate-id: required(integer)
ASO rate ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns the rate for the specified rate ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- rate: required(object)
Rate
- rateId: required(integer)
Rate ID.
Example:
1
- supplierId: required(integer)
Supplier ID.
Example:
1
- itemId: required(integer)
Item ID.
Example:
1
- alternate: required(integer)
Rate alternate.
Example:
0
- rateCurrency: required(union of string or nil)
Currency code for rate. (Max length: 3)
Example:
USD
- createdDate: required(union of integer or nil)
Rate creation date. 13-digit unix/epoch time.
Example:
1549996351000
- contractId: required(string)
Contract ID.
Example:
c123
- contractName: required(string)
Contract name.
Example:
Test Contract
- rateEffectiveDate: required(union of integer or nil)
Date rate takes effect. 13-digit unix/epoch time.
Example:
1549996351000
- rateExpirationDate: required(union of integer or nil)
Date rate expires. 13-digit unix/epoch time.
Example:
1549996351000
- rateDesignation: required(union of string or nil)
Identifies a rate's intended use. Allowed values are specific to each event.
Example:
Primary
- lastModifiedDate: required(integer)
Date when this rate was last modified. 13-digit unix/epoch time.
Example:
1549996351000
- lastModifiedUserId: required(union of integer or nil)
ASO user ID of user who last modified this rate.
Example:
1
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "name": "Test Rate Attr", "value": "10.00" }, { "id": "2", "name": "Test Rate Attr 2", "value": "Below" } ]
Example:
{ "rateId": 5, "supplierId": 6, "itemId": 4, "alternate": 0, "rateCurrency": "USD", "createdDate": 1683664445000, "contractId": "c630", "contractName": "Rate-C630", "rateEffectiveDate": 1663992000000, "rateExpirationDate": 1695528000000, "rateDesignation": "Primary", "lastModifiedDate": 1683665883000, "lastModifiedUserId": 155375, "attributes": [ { "id": "17", "name": "Item Price", "value": "630.00" }, { "id": "42", "name": "Origin Zip", "value": "Pittsburgh" }, { "id": "43", "name": "Destination Zip", "value": "Finland" } ] }
- rateId: required(integer)
- item: required(object)
Item
- itemId: required(integer)
Item ID.
Example:
1
- itemCode: required(string)
Item code. Unique identifier. (Max length: 255)
Example:
itemcode-1
- name: required(union of string or nil)
Item name. (Max length: 65,535)
Example:
Test Item
- description: required(union of string or nil)
Item description. (Max length: 65,535)
Example:
Test item description.
- itemClassNameId: required(union of integer or nil)
Item-class name ID.
Example:
1
- avgHistoricPrice: (union of number or nil)
Item average historic price.
Example:
100
- quantity: required(union of number or nil)
Item quantity.
Example:
2
- valid: required(boolean)
Is item valid.
Example:
true
- uomName: required(union of string or nil)
UOM name (singular).
Example:
unit
- itemCurrency: required(union of string or nil)
Currency code for this item. (Max length: 3)
Example:
USD
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "name": "Test Item Attr", "value": "10.00" }, { "id": "2", "name": "Test Item Attr 2", "value": "Below" } ]
Example:
{ "itemId": 4, "itemCode": "3-300", "name": "MN/MO", "description": null, "itemClassNameId": null, "avgHistoricPrice": null, "quantity": 1379, "valid": true, "uomName": null, "itemCurrency": null, "attributes": [ { "id": "40", "name": "Origin State", "value": "MN" }, { "id": "41", "name": "Destination State", "value": "MO" }, { "id": "44", "name": "Document", "value": null } ] }
- itemId: required(integer)
- supplier: required(object)
Supplier
- supplierId: required(integer)
Supplier ID.
Example:
1
- supplierCode: required(string)
Supplier code. Unique identifier. (Max length: 255)
Example:
suppcode-1
- name: required(string)
Supplier name. (Max length: 65,535)
Example:
Test Supplier
- description: (union of string or nil)
Supplier description. (Max length: 65,535)
Example:
Test supplier description.
- street1: (union of string or nil)
Supplier street1 address. (Max length: 250)
Example:
100 Washington Rd.
- street2: (union of string or nil)
Supplier street2 address. (Max length: 250)
Example:
Building 1
- city: (union of string or nil)
Supplier city. (Max length: 250)
Example:
Pittsburgh
- state: (union of string or nil)
Supplier state. (Max length: 2)
Example:
PA
- postalCode: (union of string or nil)
Supplier postal code. (Max length: 10)
Example:
15212
- countryCode: (union of string or nil)
Supplier country code. (Max length: 10)
Example:
US
- valid: required(boolean)
Is supplier valid.
Example:
true
- contacts: (union of array or nil)
List of supplier contacts.
Example:
[ { "contactId": 1, "contactCode": "concode555", "email": "mnauman@jaggaer.com", "name": "Matthew Nauman", "firstName": "Matthew", "lastName": "Nauman", "isPrimary": true, "prefix": "Dr.", "suffix": "III", "jobTitle": "salesman", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "name": "Test Contact Attribute", "value": "2" }, { "id": "2", "name": "Another Contact Attr", "value": "some value" } ] }, { "contactId": 2, "contactCode": "concode6", "email": "rnauman@jaggaer.com", "name": "Ronald Nauman", "firstName": "Ronald", "lastName": "Nauman", "isPrimary": false, "prefix": "Mr.", "suffix": "Jr.", "jobTitle": "Engineer", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "name": "Test Contact Attribute", "value": "4" }, { "id": "2", "name": "Another Contact Attr", "value": "some other value" } ] } ]
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "name": "Test Supplier Attr", "value": "10.00" }, { "id": "2", "name": "Test Supplier Attr 2", "value": "Below" } ]
Example:
{ "supplierId": 6, "supplierCode": "C01", "name": "Carrier 01", "description": "", "street1": null, "street2": null, "city": null, "state": null, "postalCode": null, "countryCode": null, "valid": true, "attributes": [], "contacts": null }
- supplierId: required(integer)
Example:
{
"rate": {
"rateId": 5,
"supplierId": 6,
"itemId": 4,
"alternate": 0,
"rateCurrency": "USD",
"createdDate": 1683664445000,
"contractId": "c630",
"contractName": "Rate-C630",
"rateEffectiveDate": 1663992000000,
"rateExpirationDate": 1695528000000,
"rateDesignation": "Primary",
"lastModifiedDate": 1683665883000,
"lastModifiedUserId": 155375,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "630.00"
},
{
"id": "42",
"name": "Origin Zip",
"value": "Pittsburgh"
},
{
"id": "43",
"name": "Destination Zip",
"value": "Finland"
}
]
},
"item": {
"itemId": 4,
"itemCode": "3-300",
"name": "MN/MO",
"description": null,
"itemClassNameId": null,
"avgHistoricPrice": null,
"quantity": 1379,
"valid": true,
"uomName": null,
"itemCurrency": null,
"attributes": [
{
"id": "40",
"name": "Origin State",
"value": "MN"
},
{
"id": "41",
"name": "Destination State",
"value": "MO"
},
{
"id": "44",
"name": "Document",
"value": null
}
]
},
"supplier": {
"supplierId": 6,
"supplierCode": "C01",
"name": "Carrier 01",
"description": "",
"street1": null,
"street2": null,
"city": null,
"state": null,
"postalCode": null,
"countryCode": null,
"valid": true,
"attributes": [],
"contacts": null
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or Attribute ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
rateNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"rateId": "999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Rates (Asynchronous)
Initiate asynchronous process to retrieve one or more ASO rates.
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
get /event/{event-id}/apiRates/async
Returns a URL that can be used to check the status of the asynchronous process and when the process has completed download the resulting file. For a comprehensive introduction to the ASO asynchronous download process see Working With Asynchronous Download Endpoints.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 202
Success; Returns a URL to poll the asynchronous process status and retrieve file.
Working With Status URL
The statusUrl
that is returned in the response allows the client to both poll for the availability of the generated file, and once available, allows the client access to download the file. For complete details see GET Async Status.
The generated file will contain the requested ApiRates model data in JSON format.
ApiRate Model:
Field | Type | Parent | Description |
---|---|---|---|
rateId | integer | root | Rate ID |
supplierId | integer | root | Supplier ID |
itemId | integer | root | Item ID |
alternate | integer | root | Rate alternate |
rateCurrency | string | root | Currency code for rate |
createdDate | integer | root | Rate creation date; 13-digit unix/epoch time |
contractId | string | root | Contract ID |
contractName | string | root | Contract name |
rateEffectiveDate | integer | root | Date rate takes effect; 13-digit unix/epoch time |
rateExpirationDate | integer | root | Date rate expires; 13-digit unix/epoch time |
rateDesignation | enum | root | Identifies a rate's intended use; allowed values specific to each event |
lastModifiedDate | integer | root | Date when this rate was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | root | ASO user ID of user who last modified this rate |
attributes | array | root | List of rate attributes (see below for attribute field details) |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
ApiRates Data Example:
[
{
"rate": {
"rateId": 2,
"supplierId": 6,
"itemId": 1,
"alternate": 0,
"rateCurrency": "USD",
"createdDate": 1683034761000,
"contractId": "C100",
"contractName": "C100",
"rateEffectiveDate": 1672549200000,
"rateExpirationDate": 1704085200000,
"rateDesignation": "Primary",
"lastModifiedDate": 1683035098000,
"lastModifiedUserId": 155429,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "350.00"
},
{
"id": "42",
"name": "Origin Zip",
"value": "300"
},
{
"id": "43",
"name": "Destination Zip",
"value": "383"
}
]
},
"item": {
"itemId": 1,
"itemCode": "1-100",
"name": "GA/TN",
"description": null,
"itemClassNameId": null,
"avgHistoricPrice": null,
"quantity": 825,
"valid": true,
"uomName": null,
"itemCurrency": null,
"attributes": [
{
"id": "40",
"name": "Origin State",
"value": "GA"
},
{
"id": "41",
"name": "Destination State",
"value": "TN"
},
{
"id": "44",
"name": "Document",
"value": null
}
]
},
"supplier": {
"supplierId": 6,
"supplierCode": "C01",
"name": "Carrier 01",
"description": "",
"street1": null,
"street2": null,
"city": null,
"state": null,
"postalCode": null,
"countryCode": null,
"valid": true,
"attributes": [],
"contacts": null
}
},
{
"rate": {
"rateId": 3,
"supplierId": 6,
"itemId": 2,
"alternate": 0,
"rateCurrency": "USD",
"createdDate": 1683035098000,
"contractId": "C200",
"contractName": "C200",
"rateEffectiveDate": 1672549200000,
"rateExpirationDate": 1672549200000,
"rateDesignation": "Primary",
"lastModifiedDate": 1683035098000,
"lastModifiedUserId": 155429,
"attributes": [
{
"id": "17",
"name": "Item Price",
"value": "550.00"
},
{
"id": "42",
"name": "Origin Zip",
"value": "244"
},
{
"id": "43",
"name": "Destination Zip",
"value": null
}
]
},
"item": {
"itemId": 2,
"itemCode": "2-200",
"name": "VA/NC",
"description": null,
"itemClassNameId": null,
"avgHistoricPrice": null,
"quantity": 1191,
"valid": true,
"uomName": null,
"itemCurrency": null,
"attributes": [
{
"id": "40",
"name": "Origin State",
"value": "VA"
},
{
"id": "41",
"name": "Destination State",
"value": "NC"
},
{
"id": "44",
"name": "Document",
"value": null
}
]
},
"supplier": {
"supplierId": 6,
"supplierCode": "C01",
"name": "Carrier 01",
"description": "",
"street1": null,
"street2": null,
"city": null,
"state": null,
"postalCode": null,
"countryCode": null,
"valid": true,
"attributes": [],
"contacts": null
}
}
]
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- statusUrl: required(string)
Status URL that can be used to check the status of an asynchronous process and if the process has completed download the resulting file.
Example:
https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==
- statusUrlExpiresInSeconds: required(integer)
Time in seconds before URL expires.
Example:
1800
Example:
{
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTYyNjQ2MDY4ODQwNzoyMjg1MDo5OmIyMjI5NmQyLTA3ODYtNDUwZi1iNzg3LTFmYzQ4MjAwOTU4Ng==",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Scenarios
Retrieve one or more ASO scenarios.
Returns all ASO scenario entities for the specified Event ID.
get /event/{event-id}/apiScenarios
Returns all ASO scenario entities for the specified Event ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns all scenarios matching the specified event ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiScenario
- scenarioId: (union of integer or nil)
Scenario ID.
Example:
1
- name: required(union of string or nil)
Scenario name.
Example:
Scenario 1
- comments: required(union of string or nil)
Scenario comments.
Example:
Award each item to the supplier with the lowest bid for that item.
- status: required(one of New - Unoptimized, Dirty - Unoptimized, Queued, Optimizing, Retrieving Results, Reports Available, Failed - Infeasible, Failed - Please review these Scenario Rules, Failed - Bad Input, Failed, Failed - Job Submission Failed, Reports Available - Stale Data, Awaiting Notification, Consolidation)
Scenario status.
Example:
Reports Available
- locked: required(boolean)
Whether or not scenario is locked.
Example:
false
- awarded: required(boolean)
Whether or not scenario has been awarded.
Example:
true
- preferred: required(boolean)
Whether or not this is the preferred scenario for the event.
Example:
false
- tailored: required(boolean)
Whether or not this scenario is tailored.
Example:
false
- timeSubmitted: required(union of number or nil)
Time that the optimization was submitted. 13-digit unix/epoch time.
Example:
1536245950000
- timeCompleted: required(union of number or nil)
Time that the optimization was completed. 13-digit unix/epoch time.
Example:
1536245970000
Example:
[
{
"scenarioId": 1,
"name": "Lowest Bid",
"comments": "Award each item to the supplier with the lowest bid for that item",
"status": "Reports Available",
"locked": false,
"awarded": false,
"preferred": false,
"tailored": false,
"timeSubmitted": 1536245950000,
"timeCompleted": 1536245970000
},
{
"scenarioId": 2,
"name": "Single Supplier",
"comments": "Award all items to one supplier with the lowest total bid price across all items",
"status": "Optimizing",
"locked": false,
"awarded": false,
"preferred": false,
"tailored": false,
"timeSubmitted": 1536245950000,
"timeCompleted": 1536245970000
}
]
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Suppliers
Retrieve one or more ASO suppliers.
Returns all ASO supplier entities for specified Event ID.
get /event/{event-id}/apiSuppliers
Returns all ASO supplier entities for specified Event ID.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Returns all suppliers matching the specified event ID.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiSupplier
- supplierId: required(integer)
Supplier ID.
Example:
1
- supplierCode: required(string)
Supplier code. Unique identifier. (Max length: 255)
Example:
suppcode-1
- name: required(string)
Supplier name. (Max length: 65,535)
Example:
Test Supplier
- description: (union of string or nil)
Supplier description. (Max length: 65,535)
Example:
Test supplier description.
- street1: (union of string or nil)
Supplier street1 address. (Max length: 250)
Example:
100 Washington Rd.
- street2: (union of string or nil)
Supplier street2 address. (Max length: 250)
Example:
Building 1
- city: (union of string or nil)
Supplier city. (Max length: 250)
Example:
Pittsburgh
- state: (union of string or nil)
Supplier state. (Max length: 2)
Example:
PA
- postalCode: (union of string or nil)
Supplier postal code. (Max length: 10)
Example:
15212
- countryCode: (union of string or nil)
Supplier country code. (Max length: 10)
Example:
US
- valid: required(boolean)
Is supplier valid.
Example:
true
- contacts: (union of array or nil)
List of supplier contacts.
Example:
[ { "contactId": 1, "contactCode": "concode555", "email": "mnauman@jaggaer.com", "name": "Matthew Nauman", "firstName": "Matthew", "lastName": "Nauman", "isPrimary": true, "prefix": "Dr.", "suffix": "III", "jobTitle": "salesman", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "name": "Test Contact Attribute", "value": "2" }, { "id": "2", "name": "Another Contact Attr", "value": "some value" } ] }, { "contactId": 2, "contactCode": "concode6", "email": "rnauman@jaggaer.com", "name": "Ronald Nauman", "firstName": "Ronald", "lastName": "Nauman", "isPrimary": false, "prefix": "Mr.", "suffix": "Jr.", "jobTitle": "Engineer", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "name": "Test Contact Attribute", "value": "4" }, { "id": "2", "name": "Another Contact Attr", "value": "some other value" } ] } ]
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "name": "Test Supplier Attr", "value": "10.00" }, { "id": "2", "name": "Test Supplier Attr 2", "value": "Below" } ]
Example:
[
{
"supplierId": 1,
"supplierCode": "supp-code-1",
"name": "Some Company",
"description": "Description of a some company.",
"street1": "2200 Liberty Ave.",
"street2": "Building 2",
"city": "Pittsburgh",
"state": "PA",
"postalCode": "15212",
"countryCode": "US",
"valid": true,
"attributes": [
{
"id": "1",
"name": "Test Supplier Attr1",
"value": "10.00"
},
{
"id": "2",
"name": "Test Supplier Attr2",
"value": "Below"
}
],
"contacts": [
{
"contactId": 1,
"contactCode": "con-code-1",
"email": "bsmith@cure.com",
"name": "robert smith",
"firstName": "robert",
"lastName": "smith",
"isPrimary": true,
"prefix": "Mr.",
"suffix": "III",
"jobTitle": "Guitarist",
"phone": "412-555-1111",
"mobile": "412-555-1111",
"fax": null,
"pager": null,
"web": "www.test.com",
"attributes": [
{
"id": "1",
"name": "Test Contact Attr1",
"value": "Never"
},
{
"id": "2",
"name": "Test Contact Attr2",
"value": "1000"
}
]
},
{
"contactId": 2,
"contactCode": "concode2",
"email": "mnauman@jaggaer.com",
"name": "matthew nauman",
"firstName": "matthew",
"lastName": "nauman",
"isPrimary": false,
"prefix": null,
"suffix": null,
"jobTitle": "Technical Architect",
"phone": "412-555-1111",
"mobile": null,
"fax": null,
"pager": null,
"web": "www.jaggaer.com",
"attributes": [
{
"id": "1",
"name": "Test Contact Attr1",
"value": "Sometimes"
},
{
"id": "2",
"name": "Test Contact Attr2",
"value": "3500"
}
]
}
]
},
{
"supplierId": 2,
"supplierCode": "supp-code-2",
"name": "Another Company",
"description": "Description of another company.",
"street1": "218 Smithfield St.",
"street2": null,
"city": "Pittsburgh",
"state": "PA",
"postalCode": "15212",
"countryCode": "US",
"valid": true,
"attributes": [
{
"id": "1",
"name": "Test Supplier Attr1",
"value": "1.50"
},
{
"id": "2",
"name": "Test Supplier Attr2",
"value": "Above"
}
],
"contacts": null
}
]
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Suppliers by User
Create one or more ASO suppliers.
Creates one or more ASO supplier entities.
post /event/{event-id}/user/{user-id}/apiSuppliers
Creates one or more ASO supplier entities.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- user-id: required(integer)
ASO user ID.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Content-Type: required(string)
Informs the server of the mediatype of the entity-body to be sent in the request.
Example:
application/vnd.sciquest.com.ees+json
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
Body
Media type: application/vnd.sciquest.com.ees+json
Type: array of object
Items: ApiSupplier
- supplierCode: required(string)
Supplier code. Unique identifier. (Max length: 255)
Example:
suppcode-1
- name: required(string)
Supplier name. (Max length: 65,535)
Example:
Test Supplier
- description: (union of string or nil)
Supplier description. (Max length: 65,535)
Example:
Test supplier description.
- street1: (union of string or nil)
Supplier street1 address. (Max length: 250)
Example:
100 Washington Rd.
- street2: (union of string or nil)
Supplier street2 address. (Max length: 250)
Example:
Building 1
- city: (union of string or nil)
Supplier city. (Max length: 250)
Example:
Pittsburgh
- state: (union of string or nil)
Supplier state. (Max length: 2)
Example:
PA
- postalCode: (union of string or nil)
Supplier postal code. (Max length: 10)
Example:
15212
- countryCode: (union of string or nil)
Supplier country code. (Max length: 10)
Example:
US
- valid: required(boolean)
Is supplier valid.
Example:
true
- contacts: (union of array or nil)
List of supplier contacts.
Example:
[ { "contactId": 1, "contactCode": "concode555", "email": "mnauman@jaggaer.com", "firstName": "Matthew", "lastName": "Nauman", "isPrimary": true, "prefix": "Dr.", "suffix": "III", "jobTitle": "salesman", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "value": "2" }, { "id": "2", "value": "some value" } ] }, { "contactId": 2, "contactCode": "concode6", "email": "rnauman@jaggaer.com", "firstName": "Ronald", "lastName": "Nauman", "isPrimary": false, "prefix": "Mr.", "suffix": "Jr.", "jobTitle": "Engineer", "phone": "412-555-1111", "mobile": "412-555-1111", "fax": "412-555-1111", "pager": "412-555-1111", "web": "www.jaggaer.com", "attributes": [ { "id": "1", "value": "4" }, { "id": "2", "value": "some other value" } ] } ]
- attributes: (union of array or nil)
List of attribute key, name, and values.
Example:
[ { "id": "1", "value": "10.00" }, { "id": "2", "value": "Below" } ]
Example:
[
{
"supplierCode": "supp-code-1",
"name": "Some Company",
"description": "Description of a some company.",
"street1": "2200 Liberty Ave.",
"street2": "Building 2",
"city": "Pittsburgh",
"state": "PA",
"postalCode": "15212",
"countryCode": "US",
"valid": true,
"attributes": [
{
"id": "1",
"value": "10.00"
},
{
"id": "2",
"value": "Below"
}
],
"contacts": [
{
"contactCode": "con-code-1",
"email": "bsmith@cure.com",
"firstName": "robert",
"lastName": "smith",
"isPrimary": true,
"prefix": "Mr.",
"suffix": "III",
"jobTitle": "Guitarist",
"phone": "412-555-1111",
"mobile": "412-555-1111",
"fax": null,
"pager": null,
"web": "www.test.com",
"attributes": [
{
"id": "1",
"value": "Never"
},
{
"id": "2",
"value": "1000"
}
]
},
{
"contactCode": "concode2",
"email": "mnauman@jaggaer.com",
"firstName": "matthew",
"lastName": "nauman",
"isPrimary": false,
"jobTitle": "Technical Architect",
"phone": "412-555-1111",
"web": "www.jaggaer.com",
"attributes": [
{
"id": "1",
"value": "Sometimes"
},
{
"id": "2",
"value": "3500"
}
]
}
]
},
{
"supplierCode": "supp-code-2",
"name": "Another Company",
"street1": "218 Smithfield St.",
"city": "Pittsburgh",
"state": "PA",
"postalCode": "15212",
"countryCode": "US",
"valid": true,
"attributes": [
{
"id": "1",
"value": "1.50"
},
{
"id": "2",
"value": "Above"
}
]
}
]
HTTP status code 207
Success; A 207 Multi-Status response indicates that the request was processed and that the response should be parsed to determine the status of each Supplier contained within the entity-body. A Supplier will have been created successfully or failed to create for any number of error conditions which will be detailed in the response and are defined in the table below.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Supplier/Contacts created in ASO without error. |
supplierId | Identifier of the created supplier. | |
supplierCode | Supplier identifier. | |
ALREADY_EXISTS | --- | Supplier code already exists in this event. |
supplierCode | Supplier code that was found to already exist. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Indicates the field that triggered the already exists validation failure. | |
ALREADY_EXISTS | --- | Contact code already exists in this event. |
supplierCode | Supplier identifier. | |
contactCode | Contact code that was found to already exist. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Indicates the field that triggered the already exists validation failure. | |
ALREADY_EXISTS | --- | Contact email already exists in this event. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
Contact email that was found to already exist. | ||
field | Indicates the field that triggered the already exists validation failure. | |
DUPLICATE_VALUE | --- | Duplicate supplier code found within suppliers making up the entity-body of the request. |
supplierCode | Supplier code that was found to be a duplicate. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Indicates the field that triggered the duplicate value validation failure. | |
DUPLICATE_VALUE | --- | Duplicate contact code found within contacts making up the entity-body of the request. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Indicates the field that triggered the duplicate value validation failure. | |
DUPLICATE_VALUE | --- | Duplicate contact email found within contacts making up the entity-body of the request. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
Contact email that was found to be a duplicate. | ||
field | Indicates the field that triggered the duplicate value validation failure. | |
MISSING_REQUIRED_FIELD | --- | The referenced entity is missing a required field in the request entity-body. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Name of the missing/required field. | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced entity contains a value that exceeds a field's established character limit. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
AUTO_REGISTER_MISCONFIGURED | --- | Auto-register is enabled but misconfigured. |
customerHostId | ASO customer host ID. | |
CONTACT_USER_NOT_FOUND | --- | When using auto-register the ASO user associated with the contact does not exist. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
CONTACT_USER_NOT_ENROLLED_IN_SSO | --- | When using auto-register the ASO user associated with the contact is not enrolled in SSO. |
supplierCode | Supplier identifier. | |
contactCode | Contact identifier. | |
entity | Entity that the error has occurred for -- suppplier or contact. | |
ATTR_ERR_INVALID | --- | The referenced entity contains an invalid attribute definition. |
id | Attribute ID. | |
ATTR_ERR_UNKNOWN | --- | The referenced entity contains an unknown attribute ID. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_MISSING | --- | The referenced entity is missing a required attribute. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_NULL | --- | The referenced entity is passing NULL for a required attribute. |
id | Attribute ID. | |
ATTR_ERR_NUMERICAL_HIGH_RANGE | --- | The referenced entity contains an attribute value that exceeds the attributes configured highValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
highValue | Attribute configured highValue ceiling. | |
ATTR_ERR_NUMERICAL_LOW_RANGE | --- | The referenced entity contains an attribute value that falls below the attributes configured lowValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
lowValue | Attribute configured lowValue floor. | |
ATTR_ERR_NUMERICAL_PRECISION | --- | The referenced entity contains an attribute value that does not match the attribute's configured fractionalPrecision. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
actualPrecision | Precision of the value supplied in entity-body. | |
expectedPrecision | Attribute configured fractionalPrecision. | |
ATTR_ERR_NUMERICAL_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate numerical format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_DATE_TIME_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate date format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
format | Expected format. | |
ATTR_ERR_BOOLEAN_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate boolean format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
expected | Expected values. | |
ATTR_ERR_CURRENCY_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate currency code format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_SELECT_ONE_NOT_FOUND | --- | The referenced entity contains an attribute value that does match a valid select-one value. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_EXCEEDED_CHARACTER_LIMIT | --- | The referenced entity contains an attribute value that exceeds the character limit. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
limit | Character limit. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
success:
{
"statuses": {
"SUCCESS": [
{
"supplierId": "1",
"supplierCode": "supp-code-1"
},
{
"supplierId": "2",
"supplierCode": "supp-code-2"
}
]
}
}
mixed:
{
"statuses": {
"EXCEEDED_CHARACTER_LIMIT": [
{
"field": "countryCode",
"limit": "2",
"supplierCode": "s-code-3",
"value": "usa",
"entity": "supplier"
}
],
"ATTRIBUTE_ERROR_UNKNOWN": [
{
"supplierCode": "s-code-4",
"id": "999"
}
],
"ATTRIBUTE_ERROR_REQUIRED_MISSING": [
{
"supplierCode": "s-code-4",
"id": "32"
}
],
"MISSING_REQUIRED_FIELD": [
{
"field": "valid",
"supplierCode": "s-code-3",
"entity": "supplier"
}
]
}
}
HTTP status code 400
Badly formed request.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
noPayload:
{
"statuses": {
"NULL_PAYLOAD": [
{
"payload": null
}
]
}
}
noPerms:
{
"statuses": {
"INSUFFICIENT_PERMISSIONS": [
{
"userId": "999999"
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID or User ID cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
userNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"userId": "999"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.
Upload Entity URL
Initiate the asynchronous entity import process.
Initiates the asynchronous entity import process. For a comprehensive introduction to the ASO asynchronous entity import process see Working With Asynchronous Entity Imports.
get /event/{event-id}/user/{user-id}/entity/{entity}/uploadUrl
Initiates the asynchronous entity import process. For a comprehensive introduction to the ASO asynchronous entity import process see Working With Asynchronous Entity Imports.
ASO requires OAuth 2.0 for authorizing endpoint requests.
URI Parameters
- event-id: required(integer)
ASO event ID.
- user-id: required(integer)
ASO user ID.
- entity: required(rate)
ASO entity.
Headers
- X-API-Key: required(string)
API key.
Example:
7BpB136Rfj75IOabv55iQ6ACgLu9AKpWn3FG0gxd
- Authorization: required(string)
System-to-system OAuth 2.0 bearer access token.
Example:
Bearer 76ac929c-f90b-4a35-85d6-53f6a0904f7f
- Accept: required(string)
Informs the server about which mediatypes are acceptable in the response.
Example:
application/vnd.sciquest.com.ees+json
HTTP status code 200
Success; Initiates the asynchronous entity import process and returns an Uplooad URL and Status URL.
Upload URL
The uploadUrl
is a presigned AWS PUT URL used to upload entity import files into ASO.
Rate Import File Details
Field | Type | Parent | Description |
---|---|---|---|
rateCode | integer | root | Unique code to identify rate |
supplierId | integer | root | Supplier ID |
itemId | integer | root | Item ID |
alternate | integer | root | Rate alternate |
rateCurrency | string | root | Currency code for rate |
createdDate | integer | root | Rate creation date; 13-digit unix/epoch time |
contractId | string | root | Contract ID |
contractName | string | root | Contract name |
rateEffectiveDate | integer | root | Date rate takes effect; 13-digit unix/epoch time |
rateExpirationDate | integer | root | Date rate expires; 13-digit unix/epoch time |
rateDesignation | enum | root | Identifies a rate's intended use; allowed values specific to each event |
lastModifiedDate | integer | root | Date when this rate was last modified; 13-digit unix/epoch time |
lastModifiedUserId | integer | root | ASO user ID of user who last modified this rate |
attributes | array | root | List of rate attributes (see below for attribute field details) |
Attribute Model:
Field | Type | Parent | Description |
---|---|---|---|
id | string | attributes | Attribute ID |
name | string | attributes | Attribute name |
value | string | attributes | Attribute value |
Rate Import File Example:
[
{
"rateCode": "rate-1",
"supplierId": 1,
"itemId": 1,
"alternate": 0,
"rateCurrency": "USD",
"contractId": 123,
"contractName": "Test Name",
"rateEffectiveDate": 1663992000000,
"rateExpirationDate": 1695528000000,
"rateDesignation": "Primary",
"attributes": [
{
"id": "17",
"value": "1.00"
},
{
"id": "41",
"value": "Pittsburgh"
}
]
},
{
"rateCode": "rate-2",
"supplierId": 2,
"itemId": 2,
"alternate": 0,
"rateCurrency": "USD",
"contractId": 123,
"contractName": "Test Name",
"rateEffectiveDate": 1663992000000,
"rateExpirationDate": 1695528000000,
"rateDesignation": "Primary",
"attributes": [
{
"id": "17",
"value": "2.00"
},
{
"id": "41",
"value": "New York"
}
]
}
]
Status URL
The statusUrl
is an ASO status URL that allows the client to both poll the status of the import process, and once completed, allows the client access to download the import process result file. For complete details see GET Async Status.
Rate Import Result File Details
An import result file indicates that the import was processed and that the result file should be parsed to determine the status of each entity (rate, bid) contained within the import file. An entity will have been created successfully or failed to create for any number of error conditions which will be detailed in the result file and are defined in the table below.
Status | Key | Description |
---|---|---|
SUCCESS | --- | Rate created in ASO without error. |
rateId | Identifier of the created rate. | |
rateCode | Unique code to identify the created entity. | |
ALREADY_EXISTS | --- | Rate already exists in this event. |
rateCode | Identifier of the failed rate. | |
itemId | Item ID. | |
suppleirId | Supplier ID. | |
alternate | Rate alternate. | |
ENTITY_NOT_FOUND | --- | Entity referenced in key could not be found. |
rateCode | Identifier of the failed rate. | |
itemId or supplierId | ID of entity that could not be found. | |
FOR_FIRST_RATE_0_ALTERNATE_REQUIRED | --- | The referenced entity is missing a required field in the request entity-body. |
rateCode | Identifier of the failed rate. | |
field | Value will always be set to alternate . | |
EXCEEDED_MAX_ALTERNATES | --- | The allowed number of rates has been exceeded. |
rateCode | Identifier of the failed rate. | |
maxAlternates | Maximum number of rates allowed. | |
ALTERNATE_OUT_OF_RANGE | --- | Alternate value does not fall within alternate range. |
rateCode | Identifier of the failed rate. | |
field | Value will always be set to alternate . | |
EXCEEDED_CHARACTER_LIMIT | --- | The referenced rate contains a value that exceeds a field's established character limit. |
rateCode | Identifier of the failed rate. | |
field | Name of the field that exceeded the character limit. | |
value | Value that was attempted to be put into the field. | |
limit | Character limit of the field. | |
CURRENCY_DOES_NOT_MATCH_DEFAULT_BID_CURRENCY | --- | The event is configured to use the default bidding currency, but the rateCurrency value does not match default bidding currency. |
rateCode | Identifier of the failed rate. | |
rateCurrency | The submitted rateCurrency. | |
defaultBiddingCurrency | Default bidding currency configured in the event. | |
CURRENCY_DOES_NOT_MATCH_ITEM_CURRENCY | --- | The event is configured to use the currency configured for each item, but the rateCurrency value does not match item currency for the given rate. |
rateCode | Identifier of the failed rate. | |
rateCurrency | The submitted rateCurrency. | |
itemCurrency | Item currency configured for this rate. | |
CURRENCY_NOT_FOUND | --- | The bidCurrency in the request is not a configured currency option for the event. |
rateCode | Identifier of the failed rate. | |
rateCurrency | The submitted rateCurrency that is not configured in the event. | |
ATTR_ERR_INVALID | --- | The referenced entity contains an invalid attribute definition. |
id | Attribute ID. | |
ATTR_ERR_UNKNOWN | --- | The referenced entity contains an unknown attribute ID. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_MISSING | --- | The referenced entity is missing a required attribute. |
id | Attribute ID. | |
ATTR_ERR_REQUIRED_NULL | --- | The referenced entity is passing NULL for a required attribute. |
id | Attribute ID. | |
ATTR_ERR_NUMERICAL_HIGH_RANGE | --- | The referenced entity contains an attribute value that exceeds the attributes configured highValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
highValue | Attribute configured highValue ceiling. | |
ATTR_ERR_NUMERICAL_LOW_RANGE | --- | The referenced entity contains an attribute value that falls below the attributes configured lowValue. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
lowValue | Attribute configured lowValue floor. | |
ATTR_ERR_NUMERICAL_PRECISION | --- | The referenced entity contains an attribute value that does not match the attribute's configured fractionalPrecision. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
actualPrecision | Precision of the value supplied in entity-body. | |
expectedPrecision | Attribute configured fractionalPrecision. | |
ATTR_ERR_NUMERICAL_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate numerical format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_DATE_TIME_FORMAT | --- | The referenced entity contains an attribute value that does not fit the appropriate date format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
format | Expected format. | |
ATTR_ERR_BOOLEAN_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate boolean format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
expected | Expected values. | |
ATTR_ERR_CURRENCY_NOT_FOUND | --- | The referenced entity contains an attribute value that does not fit the appropriate currency code format. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_SELECT_ONE_NOT_FOUND | --- | The referenced entity contains an attribute value that does match a valid select-one value. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
ATTR_ERR_EXCEEDED_CHARACTER_LIMIT | --- | The referenced entity contains an attribute value that exceeds the character limit. |
id | Attribute ID. | |
value | Value that was supplied in entity-body. | |
limit | Character limit. |
Body
Media type: application/vnd.sciquest.com.ees+json
Type: object
Properties- uploadUrl: required(string)
Pre-signed URL used to upload entity import file
- uploadUrlExpiresInSeconds: required(integer)
Seconds remaining before
uploadUrl
expires.Example:
165
- statusUrl: required(string)
URL for polling status of async entity import process.
- statusUrlExpiresInSeconds: required(integer)
Seconds remaining before
statusUrl
expires.Example:
165
Example:
{
"uploadUrl": "https://s3.amazonaws.com/us-east-1.aso.prod.api.async-uploads-import/275_37109_prod_rate_17648e99-1274-44e4-a385-7ae54b8a7414?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230913T181316Z&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Expires=300&X-Amz-Credential=AKIAXROTDM7TZFHQXJMJ%2F20230913%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=69d70c7f7b66425551ee1b542c41f374d9056fd364fc727e1e0bca40e1b071b7",
"uploadUrlExpiresInSeconds": 300,
"statusUrl": "https://ees.api.combinenet.com/asyncStatus/MTY5NDYyODc5NjI3NjozNzEwOTo4OjE3NjQ4ZTk5LTEyNzQtNDRlNC1hMzg1LTdhZTU0YjhhNzQxNDp1cGxvYWQ=",
"statusUrlExpiresInSeconds": 1800
}
HTTP status code 400
User does not have sufficient permissions to perform desired action on event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"INSUFFICIENT_PERMISSIONS": [
{
"userId": "999999"
}
]
}
}
HTTP status code 403
Customer host does not have access to event.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Example:
{
"statuses": {
"AUTHENTICATION_FORBIDDEN": [
{
"chost": "275"
}
]
}
}
HTTP status code 404
Event ID, User ID or Entity cannot be found.
Body
Media type: application/vnd.sciquest.com.ees+json
Type: json
Content:
{"statuses":{"STATUS_CODE":[{"statusKey":"statusValue"}]}}
Examples:
eventNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"eventId": "99999"
}
]
}
}
userNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"userId": "999"
}
]
}
}
entityNotFound:
{
"statuses": {
"ENTITY_NOT_FOUND": [
{
"entity": "rat"
}
]
}
}
Secured by oauth_2_0
Headers
- Authorization: required(string)
Used to send a valid OAuth 2 access token. Do not use with the "access_token" query string parameter.
- X-API-Key: required(string)
API key.
HTTP status code 400
Invalid request; invalid client ID; invalid scope; unsupported grant type
HTTP status code 403
Invalid credentials.
Bearer access token not found.
Missing or invalid API key.