Initialize Cart
Version v1
Endpoint
POST
undefined/msapi/sales/shopping-cart-api/v1/carts/initialize
Copy
This operation initializes the shopping cart. It is responsible for creating a new cart and returning a valid cart ID, which is essential for all subsequent commerce operations. If a cart already exists for the user, this API will not create a new one; instead, it will return the existing cart ID.
http
This API supports Basic Authentication.
scheme:basic
Initialize Shopping Cart and retrieve cart id.
Header Parameters
- idpctx-uuidstringRequiredMandatory user id header 'idpctx-uuid'.
- mock-scenariostringEnum: [ATTR_Cart_Initialization, aia_with_only_baseOffer]Optional header 'mock-scenario' to trigger mock mode.
- idpctx-linkedwirelessaccnumsstringLinked wireless account numbers.
- idpctx-acctinfocustypestringAccount information customer type. Example: wireless.
Body Parameters
- objectRequiredATT++::Initialize Cart Input Request Body
- cartTypestringCartType
- idstringid
- extensionsarray of objectsATT++::Describes a given characteristic of an object or entity through a name/value pair.
- channelobjectRelated channel to another entity. May be online web, mobile app, social ,etc.
- relatedPartyarray of objectsRelated Entity reference. A related party defines party or party role linked to a specific entity.
Responses
Success
Body
application/json
- objectA 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,
- idstringID created on repository side (OM system)
- versionintVersion number for the Shopping Cart
- hrefstringHyperlink to access the order
- couponarray of objectsTMF++::Immediate promotion
- cancellationDatestringDate when the order is cancelled. This is used when order is cancelled.
- cancellationReasonstringReason why the order is cancelled. This is used when order is cancelled.
- categorystringUsed to categorize the order from a business perspective that can be useful for the OM system (e.g. "enterprise", "residential", ...)
- completionDatestringDate when the order was completed
- descriptionstringDescription of the product order
- expectedCompletionDatestringExpected delivery date amended by the provider
- externalIdstringID given by the consumer and only understandable by him (to facilitate his searches afterwards)
- notificationContactstringContact attached to the order to send back information regarding this order
- orderDatestringDate when the order was created
- lastUpdatestringTMF++::Date on which the product order was created
- orderPriceDatestringTMF++::Date on which the product order price was calculated
- prioritystringA 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)
- requestedCompletionDatestringRequested delivery date from the requestor perspective
- requestedStartDatestringOrder fulfillment start date wished by the requestor. This is used when, for any reason, requestor cannot allow seller to begin to operationally begin the fulfillment before a date.
- orderExtensionsarray of objectsATT++::Describes a given characteristic of an object or entity through a name/value pair.
- productConfigurationobject
- agreementarray of objects
A reference to an agreement defined in the context of the product order
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. - billingAccountobjectBillingAccount reference. A BillingAccount is a detailed description of a bill structure.
- channelarray of objectsRelated channel to another entity. May be online web, mobile app, social ,etc.
- notearray of objectsExtra information about a given entity
- orderTotalPricearray of objectsAn amount, usually of money, that represents the actual price paid by the Customer for this item or this order
- paymentarray of objectsRepresentation of a payment method
- productOfferingQualificationarray of objectsIt's a productOfferingQualification that has been executed previously
- productOrderItemarray of objectsRequiredAn identified part of the order. A product order is decomposed into one or more order items.
- quotearray of objectsIt's a Quote that has been executed previously
- relatedPartyarray of objectsRelated Entity reference. A related party defines party or party role linked to a specific entity.
- statestringEnum: [acknowledged, rejected, pending, held, inProgress, cancelled, completed, failed, partial, assessingCancellation, pendingCancellation, Draft, Submitted]Possible values for the state of the order
- subStatestringSubstatus value
- @baseTypestringWhen sub-classing, this defines the super-class
- @schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationships
- @typestringWhen sub-classing, this defines the sub-class entity name
- immediatePromotionarray of objectsTMF++::Immediate promotion
- validationobjectTMF++::Validation result that is associated with the product order