1. Overview

productqualificationtmfwebservices Documentation

1.1. Version information

Version : 1.0.0

1.2. URI scheme

Host : hostname
BasePath : /productqualificationtmfwebservices/v1

1.3. Tags

  • ProductOfferingQualification : Pq Product Offering Qualification Api Controller

1.4. Produces

  • application/json

2. Security

2.1. oauth2_password

Type : oauth2
Flow : password
Token URL : https://localhost:9002/authorizationserver/oauth/token

Name

basic

2.2. oauth2_client_credentials

Type : oauth2
Flow : application
Token URL : https://localhost:9002/authorizationserver/oauth/token

Name

extended

3. Resources

3.1. ProductOfferingQualification

Pq Product Offering Qualification Api Controller

3.1.1. Creates a ProductOfferingQualification

POST /productOfferingQualification
Description

This operation creates a ProductOfferingQualification entity.

Parameters
Type Name Description Schema

Body

productOfferingQualification
required

The ProductOfferingQualification to be created

ProductOfferingQualification

Responses
HTTP Code Description Schema

200

Ok

ProductOfferingQualification

201

Created

No Content

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

4. Definitions

4.1. AgreementItemRef

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

agreementId
optional

Identifier of the agreement

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.2. AlternateProductOfferingProposal

Alternate product Offering proposal is used when the requested product offering is not available with characteristic and date asked for. An alternate proposal could be a distinct product offering or product Spec close to requested one or same as requested but with a different activation date.

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

alternateActivationDate
optional

Alternate activation date in case seller is not able to meet requested expected activation date.

string(date-time)

alternateProduct
optional

Alternate product proposal

ProductRefOrValue

alternateProductOffering
optional

Alternate product offering proposal

ProductOfferingRef

id
optional

Identifier of a alternate product offering proposal

string

4.3. BillingAccountRef

BillingAccount reference. A BillingAccount is a detailed description of a bill structure.

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 billing account

string

id
required

Unique identifier of the billing account

string

name
optional

Name of the billing account

string

4.4. 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.5. ChannelRef

The channel to which the resource reference to. e.g. channel for selling product offerings, channel for opening a trouble ticket etc..

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 channel.

string

4.6. 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

string

valueType
optional

Data type of the value of the characteristic

string

4.7. EligibilityUnavailabilityReason

Reason for eligibility result if the productOfferingQualification result is no (meaning the productOffering or productSpec is not available).

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
optional

Unavailability reason code.

string

label
optional

Unavailability reason label.

string

4.8. 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.9. Money

A base / value business entity used to represent money

Name Description Schema

unit
optional

Currency (ISO4217 norm uses 3 letters to define the currency)

string

value
optional

A positive floating point number

number(float)

4.10. Note

Extra information about a given entity

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

author
optional

Author of the note

string

date
optional

Date of the note

string(date-time)

id
required

Identifier of the note within its containing entity (may or may not be globally unique, depending on provider implementation)

string

text
required

Text of the note

string

4.11. Price

Provides all amounts (tax included, duty free, tax rate), used currency and percentage to apply for Price Alteration.

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

dutyFreeAmount
optional

All taxes excluded amount (expressed in the given currency)

Money

percentage
optional

Percentage to apply for ProdOfferPriceAlteration

number(float)

taxIncludedAmount
optional

All taxes included amount (expressed in the given currency)

Money

taxRate
optional

Tax rate

number(float)

4.12. PriceAlteration

Is an amount, usually of money, that modifies the price charged for an order item.

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

applicationDuration
optional

Duration during which the alteration applies on the order item price (for instance 2 months free of charge for the recurring charge)

integer(int32)

description
optional

A narrative that explains in detail the semantics of this order item price alteration

string

name
optional

Name of the order item price alteration

string

price
required

Price

priceType
required

A category that describes the price such as recurring, one time and usage.

string

priority
optional

Priority level for applying this alteration among all the defined alterations on the order item price

integer(int32)

productOfferingPrice
optional

ProductOfferingPriceRef

recurringChargePeriod
optional

Could be month, week…

string

unitOfMeasure
optional

Could be minutes, GB…

string

4.13. ProductOfferingPriceRef

ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased

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.14. ProductOfferingQualification

ProductOfferingQualification is used to perform a commercial eligibility. It allows to retrieve a list of productOffering that are commercially available in the context of the interaction (defined be place, channel, party, product).

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

category
optional

CategoryRef

channel
optional

Channel used for the qualification

ChannelRef

description
optional

Description of the productOfferingQualification

string

effectiveQualificationDate
optional

Effective date to productOfferingQualification completion

string(date-time)

expectedPOQCompletionDate
optional

Date when the requester expect to provide an answer for the qualification request

string(date-time)

expirationDate
optional

Date the qualification response expires

string(date-time)

href
optional

Hyperlink to access the productOfferingQualification

string

id
optional

Unique identifier of the productOfferingQualification resource

string

instantSyncQualification
optional

An indicator which when the value is "true" means that requester expects to get qualifcation result immediately in the response. If the indicator is true then the response code of 200 indicates the operation is successful otherwise a task is created with a response 201.

boolean

note
optional

Free form text associated with the qualification request

< Note > array

place
optional

< RelatedPlaceRefOrValue > array

productOfferingQualificationDate
optional

Date when the productOfferingQualification has been submitted

string(date-time)

productOfferingQualificationItem
optional

Qualification item for a product or a category

< ProductOfferingQualificationItem > array

provideAlternative
optional

An indicator which when the value is "true" means that alternative solutions should be provided

boolean

provideOnlyAvailable
optional

An indicator which when the value is "true" means that only available product offering must be listed in the response

boolean

provideUnavailabilityReason
optional

An indicator which when the value is "true" means that unavailability reason are expected for non available product offering

boolean

qualificationResult
optional

Result of the qualification (example: green, yellow, red)

string

relatedParty
optional

Party playing a role for this qualification (as requester for example)

< RelatedParty > array

requestedPOQCompletionDate
optional

Deadline date when the requester expected a qualification answer

string(date-time)

state
optional

State of the productOfferingQualification defined in the state engine

enum (acknowledged, terminatedWithError, inProgress, done)

4.15. ProductOfferingQualificationItem

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

action
optional

Can be "add" / "modify" / "no_change"/ "delete" - by default add is considered

enum (add, modify, delete, noChange)

alternateProductOfferingProposal
optional

< AlternateProductOfferingProposal > array

eligibilityUnavailabilityReason
optional

< EligibilityUnavailabilityReason > array

expectedActivationDate
optional

Date when the requester look for productOfferingQualification activation

string(date-time)

id
required

Id of the productOfferingQualification item

string

note
optional

< Note > array

product
optional

ProductRefOrValue

productOffering
optional

ProductOfferingRef

qualificationItemRelationship
optional

< QualificationItemRelationship > array

qualificationItemResult
optional

Qualification result for this productOfferingQualification item. It could be: qualified (request productOffering or productSpecification are available), unqualified (requested not available and not alternate available), alternate (requested not available but proposal available)

string

state
optional

State of the productOfferingQualification item defined in the state engine

enum (acknowledged, terminatedWithError, inProgress, done)

terminationError
optional

< TerminationError > array

4.16. 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.17. ProductPrice

An amount, usually of money, that represents the actual price paid by a Customer for a purchase, a rent or a lease of a Product. The price is valid for a defined period of time.

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

billingAccount
optional

BillingAccountRef

description
optional

A narrative that explains in detail the semantics of this product price.

string

name
optional

A short descriptive name such as "Subscription price".

string

price
required

Price

priceType
required

A category that describes the price, such as recurring, discount, allowance, penalty, and so forth.

string

productOfferingPrice
optional

ProductOfferingPriceRef

productPriceAlteration
optional

< PriceAlteration > array

recurringChargePeriod
optional

Could be month, week…

string

unitOfMeasure
optional

Could be minutes, GB…

string

4.18. ProductRefOrValue

A product to be created defined by value or existing defined by reference. The polymorphic attributes @type, @schemaLocation & @referredType are related to the product entity and not the RelatedProductRefOrValue class itself

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

agreement
optional

< AgreementItemRef > array

billingAccount
optional

BillingAccountRef

description
optional

Is the description of the product. It could be copied from the description of the Product Offering.

string

href
optional

Reference of the product

string

id
optional

Unique identifier of the product

string

isBundle
optional

If true, the product is a ProductBundle which is an instantiation of a BundledProductOffering. If false, the product is a ProductComponent which is an instantiation of a SimpleProductOffering.

boolean

isCustomerVisible
optional

If true, the product is visible by the customer.

boolean

name
optional

Name of the product. It could be the same as the name of the product offering

string

orderDate
optional

Is the date when the product was ordered

string(date-time)

place
optional

< RelatedPlaceRefOrValue > array

product
optional

< ProductRefOrValue > array

productCharacteristic
optional

< Characteristic > array

productOffering
optional

ProductOfferingRef

productOrderItem
optional

< RelatedProductOrderItem > array

productPrice
optional

< ProductPrice > array

productRelationship
optional

< ProductRelationship > array

productSerialNumber
optional

Is the serial number for the product. This is typically applicable to tangible products e.g. Broadband Router.

string

productSpecification
optional

ProductSpecificationRef

productTerm
optional

< ProductTerm > array

realizingResource
optional

< ResourceRef > array

realizingService
optional

< ServiceRef > array

relatedParty
optional

< RelatedParty > array

startDate
optional

Is the date from which the product starts

string(date-time)

status
optional

Is the lifecycle status of the product.

enum (created, pendingActive, cancelled, active, pendingTerminate, terminated, suspended, aborted)

terminationDate
optional

Is the date when the product was terminated

string(date-time)

4.19. ProductRelationship

Linked products to the one instantiate, such as [bundled] if the product is a bundle and you want to describe the bundled products inside this bundle; [reliesOn] if the product needs another already owned product to rely on (e.g. an option on an already owned mobile access product) [targets] or [isTargeted] (depending on the way of expressing the link) for any other kind of links that may be useful

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
required

ProductRefOrValue

relationshipType
required

Type of the product relationship, such as [bundled] if the product is a bundle and you want to describe the bundled products inside this bundle; [reliesOn] if the product needs another already owned product to rely on (e.g. an option on an already owned mobile access product) [targets] or [isTargeted] (depending on the way of expressing the link) for any other kind of links that may be useful

string

4.20. ProductSpecificationRef

Product specification reference: A ProductSpecification is a detailed description of a tangible or intangible object made available externally in the form of a ProductOffering to customers or other parties playing a party role.

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

targetProductSchema
optional

A target product schema reference. The reference object to the schema and type of target product which is described by product specification.

TargetProductSchema

version
optional

Version of the product specification

string

4.21. ProductTerm

Description of a productTerm linked to this product. This represent a commitment with a duration

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

Description of the productTerm

string

duration
optional

Duration of the productTerm

Quantity

name
optional

Name of the productTerm

string

validFor
optional

productTerm validity period

TimePeriod

4.22. QualificationItemRelationship

Structure used to describe relationship between productOfferingQualification item from the same ProductOfferingQualification.

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

id
optional

Id of the ProductOfferingQualificationItem (from the same ProductOfferingQualificationItem).

string

relationshipType
optional

Type of relationship (ex: reliesOn, connectedTo, etc…)

string

4.23. 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.24. 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
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

role
optional

Role played by the related party

string

4.25. RelatedPlaceRefOrValue

Related Entity reference. A related place defines a place described by reference or by value linked to a specific entity. The polymorphic attributes @type, @schemaLocation & @referredType are related to the place entity and not the RelatedPlaceRefOrValue class itself

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

Unique reference of the place

string

id
optional

Unique identifier of the place

string

name
optional

A user-friendly name for the place, such as [Paris Store], [London Store], [Main Home]

string

role
required

string

4.26. RelatedProductOrderItem

RelatedProductOrderItem (ProductOrder item) .The product order item which triggered product creation/change/termination.

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

orderItemAction
optional

Action of the order item for this product

string

orderItemId
required

Identifier of the order item where the product was managed

string

productOrderHref
optional

Reference of the related entity.

string

productOrderId
required

Unique identifier of a related entity.

string

role
optional

role of the product order item for this product

string

4.27. ResourceRef

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 resource

string

value
optional

The resource value that can be used to identify a resource with a public key (e.g.: a tel nr, an msisdn)

string

4.28. ServiceRef

Service reference, for when Service is used by other entities

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.29. TargetProductSchema

The reference object to the schema and type of target product which is described by product specification

Name Description Schema

@baseType
optional

When sub-classing, this defines the super-class

string

@schemaLocation
required

This field provides a link to the schema describing the target product

string

@type
required

Class type of the target product

string

4.30. TerminationError

This indicates an error that caused a qualificationItem to be terminated.

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

id
optional

Unique identifier of the termination error

string

value
optional

Text to describe the termination error - for example: Unable to proceed to qualification because incomplete information provided

string

4.31. 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)