1. Overview

agreementtmfwebservices Documentation

1.1. Version information

Version : 1.0.0

1.2. URI scheme

Host : hostname
BasePath : /agreementtmfwebservices/v1

1.3. Tags

  • Agreement Specifications : Agr Agreements Specifications Controller

  • Agreements : Agr Agreements Controller

  • Agreements Notification Listeners : Agr Listener Controller

1.4. Produces

  • application/json

2. Security

2.1. oauth2_password

Name

basic

2.2. oauth2_client_credentials

Name

extended

3. Resources

3.1. Agreement Specifications

Agr Agreements Specifications Controller

3.1.1. Creates a AgreementSpecification

POST /agreementSpecification
Description

This operation creates a AgreementSpecification entity.

Parameters
Type Name Description Schema

Body

agreementSpecification
required

The AgreementSpecification to be created

AgreementSpecification

Responses
HTTP Code Description Schema

200

OK

AgreementSpecification

201

Created

AgreementSpecification

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

No Content

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.2. List or find AgreementSpecification objects

GET /agreementSpecification
Description

This operation list or find AgreementSpecification entities

Parameters
Type Name Description Schema

Query

fields
optional

Comma-separated properties to be provided in response

string

Query

lifecycleStatus
optional

Lifecycle status value

string

Query

limit
optional

Requested number of resources to be provided in response

integer(int32)

Query

offset
optional

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

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

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
required

Identifier of the AgreementSpecification

string

Query

fields
optional

Comma-separated properties to provide in response

string

Responses
HTTP Code Description Schema

200

Success

AgreementSpecification

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.4. Deletes a AgreementSpecification

DELETE /agreementSpecification/{id}
Description

This operation deletes a AgreementSpecification entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the AgreementSpecification

string

Responses
HTTP Code Description Schema

200

OK

No Content

204

Deleted

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.1.5. Updates partially a AgreementSpecification

PATCH /agreementSpecification/{id}
Description

This operation updates partially a AgreementSpecification entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the AgreementSpecification

string

Body

agreementSpecification
required

The AgreementSpecification to be updated

AgreementSpecification

Responses
HTTP Code Description Schema

200

Updated

AgreementSpecification

204

No Content

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.2. Agreements

Agr Agreements Controller

3.2.1. Creates a Agreement

POST /agreement
Description

This operation creates a Agreement entity.

Parameters
Type Name Description Schema

Body

agreement
required

The Agreement to be created

Agreement

Responses
HTTP Code Description Schema

200

OK

Agreement

201

Created

Agreement

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

No Content

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.2.2. List or find Agreement objects

GET /agreement
Description

This operation list or find Agreement entities

Parameters
Type Name Description Schema

Query

fields
optional

Comma-separated properties to be provided in response

string

Query

limit
optional

Requested number of resources to be provided in response

integer(int32)

Query

offset
optional

Requested index for start of resources to be provided in response

integer(int32)

Query

status
optional

Status value

string

Responses
HTTP Code Description Schema

200

Success

< Agreement > array

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

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
required

Identifier of the Agreement

string

Query

fields
optional

Comma-separated properties to provide in response

string

Responses
HTTP Code Description Schema

200

Success

Agreement

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.2.4. Deletes a Agreement

DELETE /agreement/{id}
Description

This operation deletes a Agreement entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the Agreement

string

Responses
HTTP Code Description Schema

200

OK

No Content

204

Deleted

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.2.5. Updates partially a Agreement

PATCH /agreement/{id}
Description

This operation updates partially a Agreement entity.

Parameters
Type Name Description Schema

Path

id
required

Identifier of the Agreement

string

Body

agreement
required

The Agreement to be updated

Agreement

Responses
HTTP Code Description Schema

200

Updated

Agreement

204

No Content

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

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

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementAttributeValueChangeEvent

Responses
HTTP Code Description Schema

200

Notified

No Content

201

Created

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.2. Client listener for entity AgreementCreateEvent

POST /listener/agreementCreateEvent
Description

Example of a client listener for receiving the notification AgreementCreateEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementCreateEvent

Responses
HTTP Code Description Schema

200

OK

No Content

201

Notified

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.3. Client listener for entity AgreementDeleteEvent

POST /listener/agreementDeleteEvent
Description

Example of a client listener for receiving the notification AgreementDeleteEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementDeleteEvent

Responses
HTTP Code Description Schema

200

OK

No Content

201

Created

No Content

204

Notified

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.4. Client listener for entity AgreementSpecificationAttributeValueChangeEvent

POST /listener/agreementSpecificationAttributeValueChangeEvent
Description

Example of a client listener for receiving the notification AgreementSpecificationAttributeValueChangeEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementSpecificationAttributeValueChangeEvent

Responses
HTTP Code Description Schema

200

Success

No Content

201

Created

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.5. Client listener for entity AgreementSpecificationCreateEvent

POST /listener/agreementSpecificationCreateEvent
Description

Example of a client listener for receiving the notification AgreementSpecificationCreateEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementSpecificationCreateEvent

Responses
HTTP Code Description Schema

200

OK

No Content

201

Notified

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.6. Client listener for entity AgreementSpecificationDeleteEvent

POST /listener/agreementSpecificationDeleteEvent
Description

Example of a client listener for receiving the notification AgreementSpecificationDeleteEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementSpecificationDeleteEvent

Responses
HTTP Code Description Schema

200

OK

No Content

201

Created

No Content

204

Deleted

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.7. Client listener for entity AgreementSpecificationStateChangeEvent

POST /listener/agreementSpecificationStateChangeEvent
Description

Example of a client listener for receiving the notification AgreementSpecificationStateChangeEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementSpecificationStateChangeEvent

Responses
HTTP Code Description Schema

200

Success

No Content

201

Created

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

3.3.8. Client listener for entity AgreementStateChangeEvent

POST /listener/agreementStateChangeEvent
Description

Example of a client listener for receiving the notification AgreementStateChangeEvent

Parameters
Type Name Description Schema

Body

data
required

The event data

AgreementStateChangeEvent

Responses
HTTP Code Description Schema

200

Notified

No Content

201

Created

No Content

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

405

Method Not allowed

Error

409

Conflict

Error

500

Internal Server Error

Error

Consumes
  • application/json;charset=utf-8

Produces
  • application/json;charset=utf-8

Security
Type Name

oauth2

oauth2_client_credentials

oauth2

oauth2_password

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
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

agreementAuthorization
optional

< AgreementAuthorization > array

agreementItem
optional

< AgreementItem > array

agreementPeriod
optional

The time period during which the Agreement is in effect.

TimePeriod

agreementSpecification
optional

AgreementSpecificationRef

agreementType
optional

The type of the agreement. For example commercial

string

associatedAgreement
optional

< AgreementRef > array

characteristic
optional

< Characteristic > array

completionDate
optional

Date at which the agreement is completed

TimePeriod

description
optional

Narrative that explains the agreement and details about the it , such as why the agreement is taking place.

string

documentNumber
optional

A reference number assigned to an Agreement that follows a prescribed numbering system.

integer(int32)

engagedParty
optional

< RelatedParty > array

href
optional

Unique url identifying the agreement as a resource

string

id
optional

Unique identifier for the agreement

string

initialDate
optional

Date at which the agreement was initialized

string(date-time)

name
required

A human-readable name for the agreement

string

statementOfIntent
optional

An overview and goals of the Agreement

string

status
optional

The current status of the agreement. Typical values are: in process, approved and rejected

string

version
optional

A string identifying the version of the agreement

string

4.2. AgreementAttributeValueChangeEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementAttributeValueChangeEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

fieldPath
optional

The path identifying the object field concerned by this notification.

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.3. AgreementAttributeValueChangeEventPayload

The event data structure

Name Description Schema

agreement
optional

The involved resource data for the event

Agreement

4.4. AgreementAuthorization

A business participant that is responsible for approving the agreement.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

date
optional

The date associated with the authorization state.

string(date-time)

signatureRepresentation
optional

Indication that represents whether the signature is a physical paper signature or a digital signature.

string

state
optional

Current status of the authorization, for example in process, approved, rejected.

string

4.5. AgreementCreateEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementCreateEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.6. AgreementCreateEventPayload

The event data structure

Name Description Schema

agreement
optional

The involved resource data for the event

Agreement

4.7. AgreementDeleteEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementDeleteEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.8. AgreementDeleteEventPayload

The event data structure

Name Description Schema

agreement
optional

The involved resource data for the event

Agreement

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
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

product
optional

The list of products indirectly referred by this agreement item (since an agreement item refers primarily to product offerings)

< ProductRef > array

productOffering
optional

The list of product offerings referred by this agreement item

< ProductOfferingRef > array

termOrCondition
optional

< 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
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the agreement

string

4.11. AgreementSpecCharacteristic

A characteristic quality or distinctive feature of an agreement.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

configurable
optional

If true, the Boolean indicates that the characteristic is configurable

boolean

description
optional

A narrative that explains in detail what the characteristic is

string

name
optional

Name of the characteristic being specified.

string

specCharacteristicValue
optional

< AgreementSpecCharacteristicValue > array

validFor
optional

The period for which the specification characteristic is valid

TimePeriod

valueType
optional

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
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

default
optional

Indicates if the value is the default value for a characteristic

boolean

unitOfMeasure
optional

Unit of measure for the characteristic, such as minutes, gigabytes (GB) and so on.

string

validFor
optional

The period of time for which a value is applicable

TimePeriod

value
optional

A discrete value that the characteristic can take on

object

valueFrom
optional

The low range value that a characteristic can take on

string

valueTo
optional

The upper range value that a characteristic can take on

string

valueType
optional

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
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

attachment
optional

< AttachmentRefOrValue > array

description
optional

A narrative that explains in detail what the agreement specification is about

string

href
optional

Reference of the agreement specification

string

id
optional

Unique identifier of the agreement specification

string

isBundle
optional

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
optional

Date and time of the last update

string(date-time)

lifecycleStatus
optional

Indicates the current lifecycle status

string

name
optional

Name of the agreement specification

string

relatedParty
optional

< RelatedParty > array

serviceCategory
optional

CategoryRef

specificationCharacteristic
optional

< AgreementSpecCharacteristic > array

specificationRelationship
optional

< AgreementSpecificationRelationship > array

validFor
optional

The period for which the agreement specification is valid

TimePeriod

version
optional

Agreement specification version

string

4.14. AgreementSpecificationAttributeValueChangeEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementSpecificationAttributeValueChangeEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

fieldPath
optional

The path identifying the object field concerned by this notification.

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.15. AgreementSpecificationAttributeValueChangeEventPayload

The event data structure

Name Description Schema

agreementSpecification
optional

The involved resource data for the event

AgreementSpecification

4.16. AgreementSpecificationCreateEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementSpecificationCreateEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.17. AgreementSpecificationCreateEventPayload

The event data structure

Name Description Schema

agreementSpecification
optional

The involved resource data for the event

AgreementSpecification

4.18. AgreementSpecificationDeleteEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementSpecificationDeleteEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.19. AgreementSpecificationDeleteEventPayload

The event data structure

Name Description Schema

agreementSpecification
optional

The involved resource data for the event

AgreementSpecification

4.20. AgreementSpecificationRef

AgreementSpecification reference. An AgreementSpecification represents a template of an agreement that can be used when establishing partnerships.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

description
optional

A narrative that explains in detail what the agreement specification is about.

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the agreement specification

string

4.21. AgreementSpecificationRelationship

A relationship between agreement specifications. Typical relationships are substitution and dependency.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
optional

Unique identifier of a related entity.

string

name
optional

Name of the related entity.

string

relationshipType
optional

Type of relationship such as, substitution or dependency.

string

validFor
optional

The period for which the relationship is valid

TimePeriod

4.22. AgreementSpecificationStateChangeEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementSpecificationStateChangeEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.23. AgreementSpecificationStateChangeEventPayload

The event data structure

Name Description Schema

agreementSpecification
optional

The involved resource data for the event

AgreementSpecification

4.24. AgreementStateChangeEvent

The notification data structure

Name Description Schema

correlationId
optional

The correlation id for this event.

string

description
optional

An explanatory of the event.

string

domain
optional

The domain of the event.

string

event
optional

The event payload linked to the involved resource object

AgreementStateChangeEventPayload

eventId
optional

The identifier of the notification.

string

eventTime
optional

Time of the event occurrence.

string(date-time)

eventType
optional

The type of the notification.

string

href
optional

Reference of the resource involved in the event

string

id
optional

Identifier of the resource involved in the event

string

priority
optional

A priority.

string

timeOcurred
optional

The time the event occured.

string(date-time)

title
optional

The title of the event.

string

4.25. AgreementStateChangeEventPayload

The event data structure

Name Description Schema

agreement
optional

The involved resource data for the event

Agreement

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
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

description
optional

Text that explains the term or condition of the agreement.

string

id
optional

Unique number assigned for reference.

string

validFor
optional

The period of time during which the term or condition of the agreement applies.

TimePeriod

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
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

attachmentType
optional

Attachment type such as video, picture

string

content
optional

The actual contents of the attachment object, if embedded, encoded as base64

string

description
optional

A narrative text describing the content of the attachment

string

href
optional

URI for this Attachment

string

id
optional

Unique identifier for this particular attachment

string

mimeType
optional

Attachment mime type such as extension file for video, picture and document

string

name
optional

The name of the attachment

string

size
optional

The size of the attachment.

Quantity

url
optional

Uniform Resource Locator, is a web page address (a subset of URI)

string

validFor
optional

The period of time for which the attachment is valid

TimePeriod

4.28. CategoryRef

The category for grouping recommendations

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the related entity.

string

version
optional

Category version

string

4.29. Characteristic

Describes a given characteristic of an object or entity through a name/value pair.

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

name
required

Name of the characteristic

string

value
required

The value of the characteristic

AgreementSpecCharacteristicValue

valueType
optional

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
optional

When sub-classing, this defines the super-class.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name.

string

code
required

Application relevant detail, defined in the API or a common list.

string

message
optional

More details and corrective actions related to the error which can be shown to a client user.

string

reason
optional

Explanation of the reason for the error which can be shown to a client user.

string

referenceError
optional

URI of documentation describing the error.

string

status
optional

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
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the related entity.

string

4.32. ProductRef

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@referredType
optional

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
optional

Name of the related entity.

string

4.33. Quantity

An amount in a given unit

Name Description Schema

amount
optional

Numeric value in a given unit

number(float)

units
optional

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
optional

When sub-classing, this defines the super-class

string

@referredType
required

The actual type of the target instance when needed for disambiguation.

string

@schemaLocation
optional

A URI to a JSON-Schema file that defines additional attributes and relationships

string

@type
optional

When sub-classing, this defines the sub-class entity name

string

href
optional

Reference of the related entity.

string

id
required

Unique identifier of a related entity.

string

name
required

Name of the related entity.

string

role
optional

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
optional

End of the time period, using IETC-RFC-3339 format

string(date-time)

startDateTime
optional

Start of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an end

string(date-time)