1. Overview
2. Security
2.1. oauth2_password
Type : oauth2
Flow : password
Token URL : https://regression-utils.prod.tro.b2c.ydev.hybris.com:9002/authorizationserver/oauth/token
Name |
---|
basic |
2.2. oauth2_client_credentials
Type : oauth2
Flow : application
Token URL : https://regression-utils.prod.tro.b2c.ydev.hybris.com:9002/authorizationserver/oauth/token
Name |
---|
extended |
3. Resources
3.1. Agreement Specifications
Agr Agreements Specifications Controller
3.1.1. Creates a AgreementSpecification
POST /agreementSpecification
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Body |
agreementSpecification |
The AgreementSpecification to be created |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
No Content |
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.2. List or find AgreementSpecification objects
GET /agreementSpecification
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Query |
fields |
Comma-separated properties to be provided in response |
string |
Query |
lifecycleStatus |
Lifecycle status value |
string |
Query |
limit |
Requested number of resources to be provided in response |
integer(int32) |
Query |
offset |
Requested index for start of resources to be provided in response |
integer(int32) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
< AgreementSpecification > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.3. Retrieves a AgreementSpecification by ID
GET /agreementSpecification/{id}
Description
This operation retrieves a AgreementSpecification entity. Attribute selection is enabled for all first level attributes.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the AgreementSpecification |
string |
Query |
fields |
Comma-separated properties to provide in response |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.4. Deletes a AgreementSpecification
DELETE /agreementSpecification/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the AgreementSpecification |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
204 |
Deleted |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.5. Updates partially a AgreementSpecification
PATCH /agreementSpecification/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the AgreementSpecification |
string |
Body |
agreementSpecification |
The AgreementSpecification to be updated |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Updated |
|
204 |
No Content |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.2. Agreements
Agr Agreements Controller
3.2.1. Creates a Agreement
POST /agreement
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
No Content |
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.2.2. List or find Agreement objects
GET /agreement
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Query |
fields |
Comma-separated properties to be provided in response |
string |
Query |
limit |
Requested number of resources to be provided in response |
integer(int32) |
Query |
offset |
Requested index for start of resources to be provided in response |
integer(int32) |
Query |
status |
Status value |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
< Agreement > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.2.3. Retrieves a Agreement by ID
GET /agreement/{id}
Description
This operation retrieves a Agreement entity. Attribute selection is enabled for all first level attributes.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the Agreement |
string |
Query |
fields |
Comma-separated properties to provide in response |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.2.4. Deletes a Agreement
DELETE /agreement/{id}
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
204 |
Deleted |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.2.5. Updates partially a Agreement
PATCH /agreement/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the Agreement |
string |
Body |
agreement |
The Agreement to be updated |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Updated |
|
204 |
No Content |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3. Agreements Notification Listeners
Agr Listener Controller
3.3.1. Client listener for entity AgreementAttributeValueChangeEvent
POST /listener/agreementAttributeValueChangeEvent
Description
Example of a client listener for receiving the notification AgreementAttributeValueChangeEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Notified |
No Content |
201 |
Created |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.2. Client listener for entity AgreementCreateEvent
POST /listener/agreementCreateEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
201 |
Notified |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.3. Client listener for entity AgreementDeleteEvent
POST /listener/agreementDeleteEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
201 |
Created |
No Content |
204 |
Notified |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.4. Client listener for entity AgreementSpecificationAttributeValueChangeEvent
POST /listener/agreementSpecificationAttributeValueChangeEvent
Description
Example of a client listener for receiving the notification AgreementSpecificationAttributeValueChangeEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
No Content |
201 |
Created |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.5. Client listener for entity AgreementSpecificationCreateEvent
POST /listener/agreementSpecificationCreateEvent
Description
Example of a client listener for receiving the notification AgreementSpecificationCreateEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
201 |
Notified |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.6. Client listener for entity AgreementSpecificationDeleteEvent
POST /listener/agreementSpecificationDeleteEvent
Description
Example of a client listener for receiving the notification AgreementSpecificationDeleteEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
201 |
Created |
No Content |
204 |
Deleted |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.7. Client listener for entity AgreementSpecificationStateChangeEvent
POST /listener/agreementSpecificationStateChangeEvent
Description
Example of a client listener for receiving the notification AgreementSpecificationStateChangeEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
No Content |
201 |
Created |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.3.8. Client listener for entity AgreementStateChangeEvent
POST /listener/agreementStateChangeEvent
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Notified |
No Content |
201 |
Created |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
4. Definitions
4.1. Agreement
An agreement represents a contract or arrangement, either written or verbal and sometimes enforceable by law, such as a service level agreement or a customer price agreement. An agreement involves a number of other business entities, such as products, services, and resources and/or their specifications.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
agreementAuthorization |
< AgreementAuthorization > array |
|
agreementItem |
< AgreementItem > array |
|
agreementPeriod |
The time period during which the Agreement is in effect. |
|
agreementSpecification |
||
agreementType |
The type of the agreement. For example commercial |
string |
associatedAgreement |
< AgreementRef > array |
|
characteristic |
< Characteristic > array |
|
completionDate |
Date at which the agreement is completed |
|
description |
Narrative that explains the agreement and details about the it , such as why the agreement is taking place. |
string |
documentNumber |
A reference number assigned to an Agreement that follows a prescribed numbering system. |
integer(int32) |
engagedParty |
< RelatedParty > array |
|
href |
Unique url identifying the agreement as a resource |
string |
id |
Unique identifier for the agreement |
string |
initialDate |
Date at which the agreement was initialized |
string(date-time) |
name |
A human-readable name for the agreement |
string |
statementOfIntent |
An overview and goals of the Agreement |
string |
status |
The current status of the agreement. Typical values are: in process, approved and rejected |
string |
version |
A string identifying the version of the agreement |
string |
4.2. AgreementAttributeValueChangeEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
fieldPath |
The path identifying the object field concerned by this notification. |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.3. AgreementAttributeValueChangeEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreement |
The involved resource data for the event |
4.4. AgreementAuthorization
A business participant that is responsible for approving the agreement.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
date |
The date associated with the authorization state. |
string(date-time) |
signatureRepresentation |
Indication that represents whether the signature is a physical paper signature or a digital signature. |
string |
state |
Current status of the authorization, for example in process, approved, rejected. |
string |
4.5. AgreementCreateEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.6. AgreementCreateEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreement |
The involved resource data for the event |
4.7. AgreementDeleteEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.8. AgreementDeleteEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreement |
The involved resource data for the event |
4.9. AgreementItem
A part of the agreement expressed in terms of a product offering and possibly including specific terms and conditions.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
product |
The list of products indirectly referred by this agreement item (since an agreement item refers primarily to product offerings) |
< ProductRef > array |
productOffering |
The list of product offerings referred by this agreement item |
< ProductOfferingRef > array |
termOrCondition |
< AgreementTermOrCondition > array |
4.10. AgreementRef
Agreement reference. An agreement represents a contract or arrangement, either written or verbal and sometimes enforceable by law, such as a service level agreement or a customer price agreement. An agreement involves a number of other business entities, such as products, services, and resources and/or their specifications.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the agreement |
string |
4.11. AgreementSpecCharacteristic
A characteristic quality or distinctive feature of an agreement.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
configurable |
If true, the Boolean indicates that the characteristic is configurable |
boolean |
description |
A narrative that explains in detail what the characteristic is |
string |
name |
Name of the characteristic being specified. |
string |
specCharacteristicValue |
< AgreementSpecCharacteristicValue > array |
|
validFor |
The period for which the specification characteristic is valid |
|
valueType |
A kind of value that the characteristic can take on, such as numeric, text and so forth |
string |
4.12. AgreementSpecCharacteristicValue
A number or text that can be assigned to an agreement specification characteristic.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
default |
Indicates if the value is the default value for a characteristic |
boolean |
unitOfMeasure |
Unit of measure for the characteristic, such as minutes, gigabytes (GB) and so on. |
string |
validFor |
The period of time for which a value is applicable |
|
value |
A discrete value that the characteristic can take on |
object |
valueFrom |
The low range value that a characteristic can take on |
string |
valueTo |
The upper range value that a characteristic can take on |
string |
valueType |
A kind of value that the characteristic can take on, such as numeric, text, and so forth |
string |
4.13. AgreementSpecification
A template of an agreement that can be used when establishing partnerships
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
attachment |
< AttachmentRefOrValue > array |
|
description |
A narrative that explains in detail what the agreement specification is about |
string |
href |
Reference of the agreement specification |
string |
id |
Unique identifier of the agreement specification |
string |
isBundle |
If true, this agreement specification is a grouping of other agreement specifications. The list of bundled agreement specifications is provided by the specificationRelationship property |
boolean |
lastUpdate |
Date and time of the last update |
string(date-time) |
lifecycleStatus |
Indicates the current lifecycle status |
string |
name |
Name of the agreement specification |
string |
relatedParty |
< RelatedParty > array |
|
serviceCategory |
||
specificationCharacteristic |
< AgreementSpecCharacteristic > array |
|
specificationRelationship |
< AgreementSpecificationRelationship > array |
|
validFor |
The period for which the agreement specification is valid |
|
version |
Agreement specification version |
string |
4.14. AgreementSpecificationAttributeValueChangeEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
fieldPath |
The path identifying the object field concerned by this notification. |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.15. AgreementSpecificationAttributeValueChangeEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreementSpecification |
The involved resource data for the event |
4.16. AgreementSpecificationCreateEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.17. AgreementSpecificationCreateEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreementSpecification |
The involved resource data for the event |
4.18. AgreementSpecificationDeleteEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.19. AgreementSpecificationDeleteEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreementSpecification |
The involved resource data for the event |
4.20. AgreementSpecificationRef
AgreementSpecification reference. An AgreementSpecification represents a template of an agreement that can be used when establishing partnerships.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
description |
A narrative that explains in detail what the agreement specification is about. |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the agreement specification |
string |
4.21. AgreementSpecificationRelationship
A relationship between agreement specifications. Typical relationships are substitution and dependency.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
relationshipType |
Type of relationship such as, substitution or dependency. |
string |
validFor |
The period for which the relationship is valid |
4.22. AgreementSpecificationStateChangeEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.23. AgreementSpecificationStateChangeEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreementSpecification |
The involved resource data for the event |
4.24. AgreementStateChangeEvent
The notification data structure
Name | Description | Schema |
---|---|---|
correlationId |
The correlation id for this event. |
string |
description |
An explanatory of the event. |
string |
domain |
The domain of the event. |
string |
event |
The event payload linked to the involved resource object |
|
eventId |
The identifier of the notification. |
string |
eventTime |
Time of the event occurrence. |
string(date-time) |
eventType |
The type of the notification. |
string |
href |
Reference of the resource involved in the event |
string |
id |
Identifier of the resource involved in the event |
string |
priority |
A priority. |
string |
timeOcurred |
The time the event occured. |
string(date-time) |
title |
The title of the event. |
string |
4.25. AgreementStateChangeEventPayload
The event data structure
Name | Description | Schema |
---|---|---|
agreement |
The involved resource data for the event |
4.26. AgreementTermOrCondition
Aspects of the agreement not formally specified elsewhere in the agreement and that cannot be captured elsewhere in a formal notation, or automatically monitored and require a more human level of management.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
description |
Text that explains the term or condition of the agreement. |
string |
id |
Unique number assigned for reference. |
string |
validFor |
The period of time during which the term or condition of the agreement applies. |
4.27. AttachmentRefOrValue
An attachment by value or by reference. An attachment complements the description of an element, for example through a document, a video, a picture.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
attachmentType |
Attachment type such as video, picture |
string |
content |
The actual contents of the attachment object, if embedded, encoded as base64 |
string |
description |
A narrative text describing the content of the attachment |
string |
href |
URI for this Attachment |
string |
id |
Unique identifier for this particular attachment |
string |
mimeType |
Attachment mime type such as extension file for video, picture and document |
string |
name |
The name of the attachment |
string |
size |
The size of the attachment. |
|
url |
Uniform Resource Locator, is a web page address (a subset of URI) |
string |
validFor |
The period of time for which the attachment is valid |
4.28. CategoryRef
The category for grouping recommendations
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
version |
Category version |
string |
4.29. Characteristic
Describes a given characteristic of an object or entity through a name/value pair.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
name |
Name of the characteristic |
string |
value |
The value of the characteristic |
|
valueType |
Data type of the value of the characteristic |
string |
4.30. Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name. |
string |
code |
Application relevant detail, defined in the API or a common list. |
string |
message |
More details and corrective actions related to the error which can be shown to a client user. |
string |
reason |
Explanation of the reason for the error which can be shown to a client user. |
string |
referenceError |
URI of documentation describing the error. |
string |
status |
HTTP Error code extension |
string |
4.31. ProductOfferingRef
ProductOffering reference. A product offering represents entities that are orderable from the provider of the catalog, this resource includes pricing information.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
4.32. ProductRef
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
4.33. Quantity
An amount in a given unit
Name | Description | Schema |
---|---|---|
amount |
Numeric value in a given unit |
number(float) |
units |
Unit |
string |
4.34. RelatedParty
Related Entity reference. A related party defines party or party role linked to a specific entity.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
role |
Role played by the related party |
string |
4.35. TimePeriod
A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
Name | Description | Schema |
---|---|---|
endDateTime |
End of the time period, using IETC-RFC-3339 format |
string(date-time) |
startDateTime |
Start of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an end |
string(date-time) |