Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Acknowledged

The Acknowledged state is where an order has been received and has passed message and basic business validations.

In Progress

The In Progress state is where an order has passed the Order Feasibility check successfully and service delivery has started.

Cancelled

The Cancelled state is where an In-Flight Order has been successfully cancelled.

Completed

The Completed state is where an order has complete provision and the service is now active.

Rejected

The Rejected state is where:

  • An order failed the Order Feasibility check
  • Invalid information is provided through the order request
  • The order request fails to meet business rules for ordering.

Pending

The Pending state is used when an order is currently in a waiting stage for an action/activity to be completed before the order can progress further, pending order amend or cancel assessment. In situations where Access Seeker action is required, an "information required" notification will be issued on transition into this state.

A pending stage can lead into auto cancellation of an order, if no action is taken within the defined timeframes to be described under the Agreement.

Held

The Held state is used when an order cannot be progressed due to an issue. SP has temporarily delayed completing an order to resolve an infrastructure shortfall to facilitate supply of order. Upon resolution of the issue, the order will continue to progress.

Failed

All Order items have failed which results in the entire Order has Failed.

Partial

Some Order items have failed and some have succeeded so the entire Order is in a Partial state. This provides support for partial Failure of an Order

 

Anchor
_Toc405202658
_Toc405202658
ProductOrder

...


Field Descriptions :
BillingAccount: is the billingAccount to use to bill the ordered products

Field

Description

id

Unique identifier of the billing account

href

Reference of the billing account


Note: Extra-information about the order (e.g. useful to add extra delivery information that could be useful for a human process : a digicode access to a building, …).

Field

Description

date

Date of the note

author

Author of the note

text

Text of the note


Product Order: is a type of order which can be used to place an order between a customer and a service provider or between a service provider and a partner and vice versa.

Field

Description

category

Used to categorize the order from a business perspective that can be useful for the OM system (e.g. "enterprise", "residential", ...)

completionDate

Date when the order was completed

description

Description of the product order

expectedCompletionDate

Expected delivery date amended by the provider

externalId

ID given by the consumer and only understandable by him (to facilitate his searches afterwards)

href

Hyperlink to access the order

id

ID created on repository side (OM system)

notificationContact

Contact attached to the order to send back information regarding this order

orderDate

Date when the order was created

priority

A way that can be used by consumers to prioritize orders in OM system (from 0 to 4 : 0 is the highest priority, and 4 the lowest)

requestedCompletionDate

Requested delivery date from the requestor perspective

requestedStartDate

Order start date wished by the requestor

state

State of the order : described in the state-machine diagram above


OrderItem: Order items that have to be treated

Field

Description

id

Identifier of the line item (generally it is a sequence number 01, 02, 03, …)

action

Can be "add" / "modify" / "no_change"/ "delete"

state

State of the order item : described in the state machine diagram

appointment

Used to precise that an appointment was set up with a related party for this order item


Place: Used to defined a place useful for the product (for example a delivery geographical place)

Field

Description

href

Reference of a place (for instance in google map)

role

Role of the place (for instance delivery geographical place)


Product: Configure the product characteristics (only configurable characteristics and necessary only if a non-default value is selected) and/or identify the product that needs to be modified/deleted.
May be a bundle product instantiation, in this case, it will contain the list of bundled product to instantiate
Nota: Each product to instantiate corresponds to a purchased productOffering. In case of bundles, the order of the list in the productOffering bundle must match the order of the list in the product instance bundle to deliver.

Field

Description

id

Identifier of the owned product (useful for delete or modify command)

href

Reference to the owned product (useful for delete or modify command)


ProductCharacteristic: Characteristics of the product to instantiate or to modify

Field

Description

name

Name of the characteristic

value

Value of the characteristic


ProductOffering: Ordered offering (pricing, default values, etc. are fetched by the OM directly from the catalogue). May be a bundle ProductOffering, in this case, it will contain the list of bundled offers that are ordered

Field

Description

id

Unique identifier of the product offering

href

Reference of the product offering


ProductRelationship: Linked products to the one instantiate.

Field

Description

type

Type of the product relationship. It can be :

  • "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


RelatedParty: Defines parties which are involved in the order and the role they are playing. At product order level, it may be the customer and at the product level, it may be the user.

Field

Description

id

Unique identifier of related party

href

Reference of the relatedParty, could be a party reference or a partyRole reference

role

Role of the related party

name

Name of the related party

...