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
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Body |
productOfferingQualification |
The ProductOfferingQualification to be created |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Ok |
|
201 |
Created |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
No Content |
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
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 |
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 |
agreementId |
Identifier of the agreement |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
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 |
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 |
alternateActivationDate |
Alternate activation date in case seller is not able to meet requested expected activation date. |
string(date-time) |
alternateProduct |
Alternate product proposal |
|
alternateProductOffering |
Alternate product offering proposal |
|
id |
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 |
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 billing account |
string |
id |
Unique identifier of the billing account |
string |
name |
Name of the billing account |
string |
4.4. 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.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 |
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 channel. |
string |
4.6. 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 |
string |
valueType |
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 |
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 |
Unavailability reason code. |
string |
label |
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 |
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.9. Money
A base / value business entity used to represent money
| Name | Description | Schema |
|---|---|---|
unit |
Currency (ISO4217 norm uses 3 letters to define the currency) |
string |
value |
A positive floating point number |
number(float) |
4.10. Note
Extra information about a given entity
| 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 |
author |
Author of the note |
string |
date |
Date of the note |
string(date-time) |
id |
Identifier of the note within its containing entity (may or may not be globally unique, depending on provider implementation) |
string |
text |
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 |
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 |
dutyFreeAmount |
All taxes excluded amount (expressed in the given currency) |
|
percentage |
Percentage to apply for ProdOfferPriceAlteration |
number(float) |
taxIncludedAmount |
All taxes included amount (expressed in the given currency) |
|
taxRate |
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 |
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 |
applicationDuration |
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 |
A narrative that explains in detail the semantics of this order item price alteration |
string |
name |
Name of the order item price alteration |
string |
price |
||
priceType |
A category that describes the price such as recurring, one time and usage. |
string |
priority |
Priority level for applying this alteration among all the defined alterations on the order item price |
integer(int32) |
productOfferingPrice |
||
recurringChargePeriod |
Could be month, week… |
string |
unitOfMeasure |
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 |
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.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 |
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 |
category |
||
channel |
Channel used for the qualification |
|
description |
Description of the productOfferingQualification |
string |
effectiveQualificationDate |
Effective date to productOfferingQualification completion |
string(date-time) |
expectedPOQCompletionDate |
Date when the requester expect to provide an answer for the qualification request |
string(date-time) |
expirationDate |
Date the qualification response expires |
string(date-time) |
href |
Hyperlink to access the productOfferingQualification |
string |
id |
Unique identifier of the productOfferingQualification resource |
string |
instantSyncQualification |
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 |
Free form text associated with the qualification request |
< Note > array |
place |
< RelatedPlaceRefOrValue > array |
|
productOfferingQualificationDate |
Date when the productOfferingQualification has been submitted |
string(date-time) |
productOfferingQualificationItem |
Qualification item for a product or a category |
< ProductOfferingQualificationItem > array |
provideAlternative |
An indicator which when the value is "true" means that alternative solutions should be provided |
boolean |
provideOnlyAvailable |
An indicator which when the value is "true" means that only available product offering must be listed in the response |
boolean |
provideUnavailabilityReason |
An indicator which when the value is "true" means that unavailability reason are expected for non available product offering |
boolean |
qualificationResult |
Result of the qualification (example: green, yellow, red) |
string |
relatedParty |
Party playing a role for this qualification (as requester for example) |
< RelatedParty > array |
requestedPOQCompletionDate |
Deadline date when the requester expected a qualification answer |
string(date-time) |
state |
State of the productOfferingQualification defined in the state engine |
enum (acknowledged, terminatedWithError, inProgress, done) |
4.15. ProductOfferingQualificationItem
| 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 |
action |
Can be "add" / "modify" / "no_change"/ "delete" - by default add is considered |
enum (add, modify, delete, noChange) |
alternateProductOfferingProposal |
< AlternateProductOfferingProposal > array |
|
eligibilityUnavailabilityReason |
< EligibilityUnavailabilityReason > array |
|
expectedActivationDate |
Date when the requester look for productOfferingQualification activation |
string(date-time) |
id |
Id of the productOfferingQualification item |
string |
note |
< Note > array |
|
product |
||
productOffering |
||
qualificationItemRelationship |
< QualificationItemRelationship > array |
|
qualificationItemResult |
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 |
State of the productOfferingQualification item defined in the state engine |
enum (acknowledged, terminatedWithError, inProgress, done) |
terminationError |
< 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 |
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.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 |
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 |
billingAccount |
||
description |
A narrative that explains in detail the semantics of this product price. |
string |
name |
A short descriptive name such as "Subscription price". |
string |
price |
||
priceType |
A category that describes the price, such as recurring, discount, allowance, penalty, and so forth. |
string |
productOfferingPrice |
||
productPriceAlteration |
< PriceAlteration > array |
|
recurringChargePeriod |
Could be month, week… |
string |
unitOfMeasure |
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 |
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 |
agreement |
< AgreementItemRef > array |
|
billingAccount |
||
description |
Is the description of the product. It could be copied from the description of the Product Offering. |
string |
href |
Reference of the product |
string |
id |
Unique identifier of the product |
string |
isBundle |
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 |
If true, the product is visible by the customer. |
boolean |
name |
Name of the product. It could be the same as the name of the product offering |
string |
orderDate |
Is the date when the product was ordered |
string(date-time) |
place |
< RelatedPlaceRefOrValue > array |
|
product |
< ProductRefOrValue > array |
|
productCharacteristic |
< Characteristic > array |
|
productOffering |
||
productOrderItem |
< RelatedProductOrderItem > array |
|
productPrice |
< ProductPrice > array |
|
productRelationship |
< ProductRelationship > array |
|
productSerialNumber |
Is the serial number for the product. This is typically applicable to tangible products e.g. Broadband Router. |
string |
productSpecification |
||
productTerm |
< ProductTerm > array |
|
realizingResource |
< ResourceRef > array |
|
realizingService |
< ServiceRef > array |
|
relatedParty |
< RelatedParty > array |
|
startDate |
Is the date from which the product starts |
string(date-time) |
status |
Is the lifecycle status of the product. |
enum (created, pendingActive, cancelled, active, pendingTerminate, terminated, suspended, aborted) |
terminationDate |
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 |
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 |
||
relationshipType |
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 |
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 |
targetProductSchema |
A target product schema reference. The reference object to the schema and type of target product which is described by product specification. |
|
version |
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 |
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 |
Description of the productTerm |
string |
duration |
Duration of the productTerm |
|
name |
Name of the productTerm |
string |
validFor |
productTerm validity period |
4.22. QualificationItemRelationship
Structure used to describe relationship between productOfferingQualification item from the same ProductOfferingQualification.
| 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 |
id |
Id of the ProductOfferingQualificationItem (from the same ProductOfferingQualificationItem). |
string |
relationshipType |
Type of relationship (ex: reliesOn, connectedTo, etc…) |
string |
4.23. Quantity
An amount in a given unit
| Name | Description | Schema |
|---|---|---|
amount |
Numeric value in a given unit |
number(float) |
units |
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 |
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.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 |
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 |
Unique reference of the place |
string |
id |
Unique identifier of the place |
string |
name |
A user-friendly name for the place, such as [Paris Store], [London Store], [Main Home] |
string |
role |
string |
4.26. RelatedProductOrderItem
RelatedProductOrderItem (ProductOrder item) .The product order item which triggered product creation/change/termination.
| 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 |
orderItemAction |
Action of the order item for this product |
string |
orderItemId |
Identifier of the order item where the product was managed |
string |
productOrderHref |
Reference of the related entity. |
string |
productOrderId |
Unique identifier of a related entity. |
string |
role |
role of the product order item for this product |
string |
4.27. ResourceRef
| 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 resource |
string |
value |
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 |
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.29. TargetProductSchema
The reference object to the schema and type of target product which is described by product specification
| Name | Description | Schema |
|---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
This field provides a link to the schema describing the target product |
string |
@type |
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 |
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 |
id |
Unique identifier of the termination error |
string |
value |
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 |
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) |