@viu/emporix-sdk 1.0.0

package/dist/cart.d.ts

@@ -0,0 +1,1807 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.js';
+
+/**
+ * Access control identifier that determines who can view or manage the cart.
+ *
+ * **Purpose**: Restricts cart visibility based on scope permissions. Only users/applications
+ * with matching restriction scopes can access carts with a specific restriction value.
+ *
+ * **Access Control**:
+ * - *Reading*: Users can only query and view carts with the `restriction` value that matches one of their authorized restrictions.
+ *
+ * **Validation**: The value must exist in the tenant's configured list of valid restrictions.
+ *
+ * **Restriction Synchronization**:
+ * - If cart is created by customer and `restriction` is not set, the `restriction` will be inherited from customer's restriction'.
+ * - If the `restriction` property is not set with tenant configuration property `enableSyncBetweenRestrictionsAndSiteCodes` set to `true`, the `restriction` field automatically syncs with cart's siteCode property.
+ *
+ */
+type Restriction = string | null;
+type BaseCart = {
+    /**
+     * Cart unique identifier generated when a cart is created.
+     */
+    id?: string;
+    yrn?: Yrn;
+    restriction?: Restriction;
+    /**
+     * Customer unique identifier generated when a customer account is created through the Customer Service.
+     */
+    customerId?: string;
+    /**
+     * ID of the legal entity to which customer is assigned.
+     */
+    legalEntityId?: string;
+    /**
+     * The identifier of an order generated from this cart.
+     */
+    orderId?: string;
+    /**
+     * Identifier of a quote created from this cart.
+     */
+    quoteId?: string;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency?: string;
+    deliveryWindow?: DeliveryWindow;
+    /**
+     * Site unique identifier. A site is a specific shop.
+     */
+    siteCode: string;
+    /**
+     * Cart type.
+     */
+    type?: string;
+    /**
+     * Customer address - zip code.
+     */
+    zipCode?: string;
+    /**
+     * Two-letter country code, compliant with the ISO 3166 standard.
+     */
+    countryCode?: string;
+    /**
+     * A list of addresses used in the cart. The list contains one `BILLING` and one `SHIPPING` address `type`.
+     * If one of the address `types` is not provided in the request, it is automatically populated in the following order:
+     * * If the cart has a legal entity, it gets the first location of the legal entity that has both `country` and `zipCode`, and matches the required `type` - then the address has origin=`LEGAL_ENTITY`.
+     * * Otherwise, if the cart has a logged-in customer, it finds the `default` address that has both `country` and `zipCode`, and matches the required `type`. If there is no matching default address with the required information, it uses the first customer address that meets the criteria. The address has origin=`CUSTOMER`.
+     * * Otherwise, the cart uses the site homebase address. Then the address has origin=`SITE`.
+     * These addresses are used in the tax country code determination [How to determine a tax country at cart level](https://developer.emporix.io/api-references/api-guides/checkout/cart/cart#how-to-determine-a-tax-country-at-cart-level) and shipping cost calculation [How to calculate shipping cost at cart level](https://developer.emporix.io/api-references/api-guides/checkout/cart/cart#how-to-calculate-shipping-cost-at-cart-level).
+     */
+    addresses?: Array<AddressResponse>;
+    channel?: Channel;
+    calculatedPrice?: CartCalculatedPrice;
+    /**
+     * Discounts applied to the cart.
+     */
+    discounts?: Array<DiscountResponse>;
+    /**
+     * External discounts that should be applied to this cart. Requires the `cart.cart_manage_external_prices` scope.
+     */
+    externalDiscounts?: Array<ExternalCartDiscount>;
+    /**
+     * Total number of items added to the cart.
+     */
+    totalUnitsCount?: number;
+    /**
+     * Customer unique session identifier.
+     */
+    sessionId?: string;
+    metadata?: MetadataResponse;
+    totalTax?: Price;
+    /**
+     * Information about the applied tax.
+     */
+    taxDescription?: string;
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Time needed to prepare the products for the delivery, expressed in hours. Time is calculated based on the products added to the cart. It is equal to the maximum lead time of all the products - `mixins.productCustomAttributes.leadTime`.
+     */
+    leadTime?: number;
+    /**
+     * List of days on which the products cannot be delivered. Days are presented by numbers where Monday is `0`, Tuesday is `1` etc. `nonDelivery` list is the union of all `mixins.productCustomAttributes.nonDelivery` products values.
+     */
+    nonDelivery?: Array<string>;
+};
+type Cart$1 = BaseCart & {
+    /**
+     * Items added to the cart.
+     */
+    items?: Array<CartItemResponse>;
+    /**
+     * Delivery window unique identifier, as defined in the Shipping Service.
+     *
+     * ***NOTE***
+     * This attribute is deprecated. Please use the `deliveryWindow` attribute.
+     * @deprecated
+     */
+    deliveryWindowId?: string;
+    /**
+     * @deprecated
+     */
+    feeYrnAggregate?: FeeAggregate & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    totalPrice?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    subTotalPrice?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    shipping?: Shipping & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    taxAggregate?: TaxAggregate & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    subtotalAggregate?: SubtotalAggregate & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    totalDiscount?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    itemFeesTotal?: Total & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    paymentFeesTotal?: Total & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    totalAuthorizedAmount?: Price & {
+        [key: string]: unknown;
+    };
+};
+type CartItemRequest = {
+    /**
+     * Cart item's unique identifier.
+     */
+    id?: string;
+    /**
+     * Indicates that products are maintained as individual entries in the cart, rather than being consolidated.  When identical products are added multiple times, each addition creates a new line item instead of increasing the quantity of an existing one.
+     */
+    keepAsSeparateLineItem?: boolean;
+    product?: Product & {
+        [key: string]: unknown;
+    };
+    /**
+     * A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant. This field should not be provided when itemType is EXTERNAL and request contains external product.
+     */
+    itemYrn?: string;
+    externalFees?: Array<ExternalFee>;
+    /**
+     * External discounts that should be applied to this cart item. Requires `cart.cart_manage_external_prices` scope
+     */
+    externalDiscounts?: Array<ExternalDiscount>;
+    itemType?: ItemType & {
+        [key: string]: unknown;
+    };
+    /**
+     * Tax code. Tax indicated in this field overrides the site's default tax value.
+     */
+    taxCode?: string;
+    /**
+     * Quantity of the product added to cart.
+     */
+    quantity: number;
+    price: PriceRowItem;
+    tax?: TaxValue & {
+        [key: string]: unknown;
+    };
+    /**
+     * Externally calculated total line price (`unit price × quantity`). When provided, this overrides internal calculations.
+     */
+    linePrice?: {
+        effectiveAmount: number;
+        originalAmount: number;
+        currency: string;
+    };
+    /**
+     * Externally calculated total tax for the item line. Only allowed when `itemType = EXTERNAL`.
+     */
+    lineTax?: TaxValue & {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Deprecated, use product `weightDependent` attribute that is stored in the database.
+     * If set to `true`, the storefront displays a hint that the total price of the product may vary depending on the product’s actual weight.
+     *
+     * @deprecated
+     */
+    weightDependent?: boolean;
+};
+type CouponDiscount = {
+    /**
+     * ID of coupon.
+     */
+    couponId?: string;
+    /**
+     * Absolute value indicating how much given coupon lowered the price of given item.
+     */
+    value?: number;
+};
+/**
+ * Collection of couponId-value pairs indicating how much particular coupon lowered absolute price of given item. Coupons of FREE_SHIPPING discount type are not taken into account.
+ */
+type CouponDiscounts = Array<CouponDiscount>;
+/**
+ * Localized value which can have different structure which depends on provided `Content-Language` header.
+ */
+type LocalizedValue = string | {
+    [key: string]: string;
+};
+type ExternalFee = {
+    /**
+     * Unique identifier of the fee.
+     */
+    id?: string;
+    name?: LocalizedValue & {
+        [key: string]: unknown;
+    };
+    /**
+     * Unique identifier of the fee.
+     */
+    yrn?: string;
+    /**
+     * Type of the fee.
+     */
+    feeType: 'PERCENT' | 'ABSOLUTE' | 'ABSOLUTE_MULTIPLY_ITEMQUANTITY';
+    /**
+     * Value of fee as percentage. It must be provided when feeType equals `PERCENT`.
+     */
+    feePercentage?: number;
+    /**
+     * Value of fee as absolute. It must be provided when feeType equals `ABSOLUTE` or `ABSOLUTE_MULTIPLY_ITEMQUANTITY`.
+     */
+    feeAbsolute?: {
+        /**
+         * Currency of fee absolute.
+         */
+        currency: string;
+        /**
+         * Value of fee absolute.
+         */
+        amount: number;
+    };
+    /**
+     * Whether tax should be included to the fee or not.
+     */
+    taxable?: boolean;
+    /**
+     * Tax code of the fee.
+     */
+    taxCode?: string;
+    taxValues?: Array<{
+        /**
+         * Name of the tax.
+         */
+        name?: string;
+        /**
+         * Rate of the tax.
+         */
+        rate?: number;
+        /**
+         * The taxable amount.
+         */
+        taxable?: number;
+        value?: {
+            /**
+             * Currency of the tax.
+             */
+            currency?: string;
+            /**
+             * Value of the tax.
+             */
+            amount?: number;
+        };
+    }>;
+};
+/**
+ * Type of the external discount.
+ */
+type ExternalDiscountType = 'PERCENT' | 'ABSOLUTE';
+/**
+ * External discount that can be applied to cart items.
+ */
+type ExternalDiscount = {
+    /**
+     * Unique identifier of the external discount.
+     */
+    id: string;
+    discountType: ExternalDiscountType;
+    /**
+     * Value of the discount (percentage e.g 15.00 -> 15% or absolute amount e.g 10.00 -> 10 EUR depending on the discountType).
+     */
+    value: number;
+    /**
+     * Flag indicating whether the discount should be also applied to fees.
+     */
+    includeFees?: boolean;
+    /**
+     * Sequence number determining the order in which discounts are applied. The lowest sequence number is applied first.
+     */
+    sequence?: number;
+};
+/**
+ * External discount that can be applied to cart items.
+ */
+type ExternalCartDiscount = {
+    /**
+     * Unique identifier of the external discount.
+     */
+    id: string;
+    /**
+     * Indicates the type of discount applied:
+     * * `PERCENT` — a percentage-based discount
+     * * `ABSOLUTE` — a fixed monetary amount
+     * * `FREE_SHIPPING` — shipping is fully discounted
+     */
+    discountType: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * Value of the discount (percentage e.g 15.00 -> 15% or absolute amount e.g 10.00 -> 10 EUR depending on the discountType).
+     */
+    value: number;
+    /**
+     * Determines whether the discount is applied to the total or subtotal value of the order.
+     * * `TOTAL` - discount is spread across products with product fees and shipping cost.
+     * * `SUBTOTAL` - discount is spread across products without fees
+     */
+    discountCalculationType?: 'TOTAL' | 'SUBTOTAL';
+    /**
+     * Sequence number determining the order in which discounts are applied. The lowest sequence number is applied first.
+     */
+    sequence?: number;
+};
+/**
+ * Cart item details.
+ */
+type BaseCartItemResponse = {
+    /**
+     * Cart item's unique identifier generated when the item is added to cart.
+     */
+    id?: string;
+    /**
+     * Indicates that products are maintained as individual entries in the cart, rather than being consolidated.  When identical products are added multiple times, each addition creates a new line item instead of increasing the quantity of an existing one.
+     */
+    keepAsSeparateLineItem?: boolean;
+    yrn?: Yrn;
+    product?: CartItemResponseProduct;
+    itemYrn?: Yrn;
+    type?: ItemType;
+    /**
+     * Quantity of the product added to cart.
+     */
+    quantity: number;
+    /**
+     * Effective quantity of the product added to cart.
+     */
+    effectiveQuantity: number;
+    calculatedPrice?: ItemCalculatedPrice;
+    /**
+     * Tax code. Tax indicated in this field overrides the site's default tax value.
+     */
+    taxCode?: string;
+    unitPrice?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    /**
+     * Product total tax amount.
+     */
+    totalTax?: number;
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * External discounts applied to this cart item.
+     */
+    externalDiscounts?: Array<ExternalDiscount>;
+};
+/**
+ * Cart item details.
+ */
+type CartItemResponse = BaseCartItemResponse & {
+    /**
+     * @deprecated
+     */
+    price?: PriceRow & {
+        [key: string]: unknown;
+    };
+    /**
+     * Externally calculated total line price (`unit price × quantity`). When provided, this overrides internal calculations.
+     */
+    linePrice?: {
+        effectiveAmount: number;
+        originalAmount: number;
+        currency: string;
+    };
+    /**
+     * Externally calculated total tax for the item line. Only allowed when `itemType = EXTERNAL`.
+     */
+    lineTax?: TaxValueWithQuantity;
+    /**
+     * @deprecated
+     */
+    couponDiscounts?: CouponDiscounts & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    itemPrice?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * **This field is deprecated**. Please use `calculatedPrice.price` instead.
+     * @deprecated
+     */
+    itemTaxInfo?: Array<TaxValue>;
+    /**
+     * @deprecated
+     */
+    fees?: FeeAggregate & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    authorizedAmount?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * @deprecated
+     */
+    totalDiscount?: Price & {
+        [key: string]: unknown;
+    };
+    /**
+     * **This field is deprecated**. Please use `calculatedPrice.fees` instead.  A fee has an enum value that allows to distinguish external prices
+     * @deprecated
+     */
+    externalFees?: Array<ExternalFee>;
+};
+/**
+ * Channel through which the cart was created.
+ */
+type Channel = {
+    name?: string;
+    source?: string;
+};
+type CreateCart = {
+    /**
+     * Customer unique identifier generated when a customer account is created through the Customer Service.
+     */
+    customerId?: string;
+    restriction?: Restriction;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency: string;
+    /**
+     * ID of the legal entity to which customer is assigned.
+     */
+    legalEntityId?: string;
+    /**
+     * Delivery window unique identifier, as defined in the Shipping Service.
+     */
+    deliveryWindowId?: string;
+    deliveryWindow?: DeliveryWindow;
+    /**
+     * Site unique identifier. A site is a specific shop.
+     *
+     * If the tenant owns only one shop, the value should be set to `main`.
+     */
+    siteCode?: string;
+    /**
+     * Cart type. You can use this field if your store offers different types of carts, such as shopping carts and wishlists.
+     */
+    type?: string;
+    channel?: Channel;
+    /**
+     * List of addresses that should be associated with the cart and used for tax determination and shipping cost. There can be one address of type `BILLING` and one of type `SHIPPING` - others are ignored. These addresses are returned with the origin `REQUEST` in the cart response.
+     */
+    addresses?: Array<AddressRequest>;
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * If set to `true`, endpoints validate whether the `session-id` used to create the cart matches the `session-id` passed in the request header.
+     *
+     * **Note**: The `sessionValidated` parameter only applies to anonymous customer carts.
+     */
+    sessionValidated?: boolean;
+};
+type DeliveryWindow = {
+    /**
+     * ID of the delivery window.
+     */
+    id?: string;
+    /**
+     * ID of the delivery time slot.
+     */
+    slotId?: string;
+    /**
+     * Delivery date. It has to be of "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'" format.
+     */
+    deliveryDate?: string;
+};
+/**
+ * Information about the cart address that can be provided in the request.
+ */
+type AddressRequest = {
+    /**
+     * Contact name.
+     */
+    contactName?: string;
+    /**
+     * Company name.
+     */
+    companyName?: string;
+    /**
+     * Street.
+     */
+    street?: string;
+    /**
+     * Street number.
+     */
+    streetNumber?: string;
+    /**
+     * Street appendix.
+     */
+    streetAppendix?: string;
+    /**
+     * Zip code.
+     */
+    zipCode?: string;
+    /**
+     * City.
+     */
+    city?: string;
+    /**
+     * Country.
+     */
+    country?: string;
+    /**
+     * State.
+     */
+    state?: string;
+    /**
+     * Contact phone.
+     */
+    contactPhone?: string;
+    /**
+     * Type of the address data
+     */
+    type?: 'BILLING' | 'SHIPPING';
+    metadata?: MetadataRequest;
+    /**
+     * Mixins object.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Information about the carts address used for shipping and tax determination.
+ */
+type AddressResponse = {
+    /**
+     * Holds information about the origin of the address. Possible values:
+     * * `REQUEST` - provided in create/update cart request
+     * * `LEGAL_ENTITY` - automatically populated from from cart's legal entity location
+     * * `CUSTOMER` - automatically populated from fetched from customer addresses
+     * * `SITE` - automatically populated from sites base address
+     */
+    origin?: 'REQUEST' | 'LEGAL_ENTITY' | 'CUSTOMER' | 'SITE';
+    /**
+     * Site unique identifier. A site is a specific shop.
+     */
+    siteCode?: string;
+    /**
+     * ID of the legal entity to which customer is assigned.
+     */
+    legalEntityId?: string;
+    /**
+     * ID of the legal entity location.
+     */
+    legalEntityLocationId?: string;
+    /**
+     * ID of the customer address.
+     */
+    customerAddressId?: string;
+    /**
+     * Contact name.
+     */
+    contactName?: string;
+    /**
+     * Company name.
+     */
+    companyName?: string;
+    /**
+     * Street.
+     */
+    street?: string;
+    /**
+     * Street number.
+     */
+    streetNumber?: string;
+    /**
+     * Street appendix.
+     */
+    streetAppendix?: string;
+    /**
+     * Zip code.
+     */
+    zipCode?: string;
+    /**
+     * City.
+     */
+    city?: string;
+    /**
+     * Country.
+     */
+    country?: string;
+    /**
+     * State.
+     */
+    state?: string;
+    /**
+     * Contact phone.
+     */
+    contactPhone?: string;
+    /**
+     * Type of the address data.
+     */
+    type?: 'BILLING' | 'SHIPPING';
+    metadata?: MetadataRequest;
+    /**
+     * Mixins object
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type CreatedCart = {
+    /**
+     * Cart unique identifier.
+     */
+    cartId: string;
+    yrn: Yrn;
+};
+/**
+ * Discount details.
+ */
+type DiscountResponse = {
+    /**
+     * Discount's unique identifier.
+     */
+    id?: string;
+    yrn?: Yrn;
+    couponYrn?: Yrn;
+    /**
+     * Discount code generated when a discount coupon is created through the Coupon Service.
+     */
+    code: string;
+    /**
+     * Discount expressed as fixed amount.
+     */
+    amount?: number;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency?: string;
+    /**
+     * Discount expressed as a percentage of the price.
+     */
+    discountRate?: number;
+    /**
+     * Discount's displayed name.
+     */
+    name?: string;
+    /**
+     * Calculation type specifies how the discount should be calculated. Can be set to one of the following:
+     * * `ApplyDiscountBeforeTax`
+     * * `ApplyDiscountAfterTax`
+     */
+    calculationType?: 'ApplyDiscountBeforeTax' | 'ApplyDiscountAfterTax';
+    /**
+     * Determines whether the coupon is applied to the total or subtotal value of the order.
+     */
+    discountCalculationType?: 'SUBTOTAL' | 'TOTAL';
+    /**
+     * Flag indicating whether the discount is valid.
+     * Invalid discounts are not taken into account when the cart is calculated.
+     */
+    valid?: boolean;
+    /**
+     * Links to Coupon Service endpoints used to validate and redeem the discount.
+     */
+    links?: Array<Link>;
+    discountValidationDetails?: DiscountValidationDetails;
+    /**
+     * The index of the discount. It represents the discount position in the cart discounts array.
+     */
+    discountIndex?: number;
+};
+type DiscountValidationDetails = {
+    message?: string;
+    details?: Array<string>;
+};
+type Fee = {
+    yrn?: Yrn;
+    name?: LocalizedValue;
+    taxCode?: string;
+    amount: number;
+    totalTax: number;
+    total: Total;
+    taxValues?: Array<TaxValue>;
+};
+type FeeAggregate = {
+    elements?: Array<Fee>;
+    total?: Total;
+};
+type Link = {
+    /**
+     * Action to be done using the endpoint provided in the `href` field.
+     */
+    rel: 'validate' | 'redeem';
+    /**
+     * Detailed link description.
+     */
+    title?: string;
+    /**
+     * Endpoint used to validate or redeem the discount.
+     */
+    href: string;
+    /**
+     * Content type.
+     */
+    type: string;
+};
+/**
+ * Information about the unit by which the customer can order the product.
+ */
+type MeasurementUnit = {
+    /**
+     * Quantity of the measurement unit.
+     *
+     * For example, if the customer can order a product by one piece, the value should be set to `1`.
+     */
+    quantity: number;
+    /**
+     * Code of the measurement unit by which the customer can order the product. The possible values for the `unitCode` field are explained in the table below:
+     * |     |     |
+     * | --- | --- |
+     * | **Value** | **Measurement unit** |
+     * | `H87` | Pieces |
+     * | `KGM` | Kilograms |
+     * | `GRM` | Grams |
+     * | `LTR` | Liters |
+     * | `MLT` | Milliliters |
+     * | `MTR` | Meters |
+     * | `RO` | Rolls |
+     *
+     * For example, if the customer can order a product by pieces, the value should be set to `H87`.
+     */
+    unitCode?: 'kg' | 'g' | 'mg' | 'l' | 'ml' | 'lb' | 'qt' | 'qtr' | 'gal' | 'pt' | 'oz' | 'MTR' | 'XRO' | 'MLT' | 'LTR' | 'H87' | 'KGM' | 'GRM' | 'HLT' | 'DL' | 'DAG' | 'RO';
+};
+type MetadataRequest = {
+    /**
+     * Links to mixin schemas.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type MetadataResponse = {
+    /**
+     * Date and time when the object was created, compliant with the ISO 8601 format.
+     */
+    createdAt: string;
+    /**
+     * Date and time when the object was last modified, compliant with the ISO 8601 format.
+     */
+    modifiedAt: string;
+    /**
+     * Date and time when the object was last calculated, compliant with the ISO 8601 format.
+     */
+    calculatedAt?: string;
+    version: number;
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type Price = {
+    /**
+     * Price.
+     */
+    amount: number;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency: string;
+};
+/**
+ * Price details.
+ */
+type PriceRow = {
+    /**
+     * Price’s unique identifier generated when the price is created through the Price Service.
+     */
+    priceId: string;
+    /**
+     * Identifier of price list. The field is populated only in case when the returned prices belongs to any price list.
+     */
+    priceListId?: string;
+    yrn?: Yrn;
+    /**
+     * Product’s regular price per specified `measurementUnit`.
+     */
+    originalAmount: number;
+    /**
+     * Actual amount the customer will pay per specified `measurementUnit`.
+     */
+    effectiveAmount: number;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard.
+     */
+    currency: string;
+    measurementUnit?: MeasurementUnit;
+};
+/**
+ * Price details.
+ */
+type PriceRowItem = {
+    /**
+     * Price’s unique identifier generated when the price is created through the Price Service. This field should not be provided when itemType is EXTERNAL.
+     */
+    priceId: string;
+    yrn?: Yrn;
+    /**
+     * Product’s regular price per specified `measurementUnit`. Property can be made optional by setting `cartItemValidationSkipOriginalAmount` configuration to `true` in the configuration-service. In that case, the value is fetched from `priceId`.
+     */
+    originalAmount: number;
+    /**
+     * Actual amount the customer will pay per specified `measurementUnit`. Property can be made optional by setting `cartItemValidationSkipEffectiveAmount` configuration to `true` in the configuration-service. In that case, the value is fetched from `priceId`.
+     */
+    effectiveAmount: number;
+    /**
+     * Three-letter currency code, compliant with the ISO 4217 standard. Property can be made optional by setting `cartItemValidationSkipCurrency` configuration to `true` in the configuration-service. In that case, the value is fetched from cart currency.
+     */
+    currency: string;
+    measurementUnit?: MeasurementUnit;
+};
+/**
+ * Product details.
+ */
+type Product = {
+    /**
+     * Product’s unique identifier. This field should be provided when itemType is EXTERNAl and request contains external product.
+     */
+    id?: string;
+    /**
+     * Product Stock Keeping Unit (SKU).
+     */
+    sku?: string;
+    /**
+     * Product code.
+     */
+    code?: string;
+    yrn?: Yrn;
+    /**
+     * Product name.
+     */
+    name?: string;
+    /**
+     * A product name represented as a map, with language as the key and the corresponding translated name as the value
+     */
+    localizedName?: {
+        [key: string]: string;
+    };
+    /**
+     * Product description.
+     */
+    description?: string;
+    /**
+     * List of product images.
+     */
+    images?: Array<ProductImage>;
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type CartItemResponseProduct = Product & {
+    vendor?: Vendor;
+};
+/**
+ * Product vendor information, autopopulated based on product catalog information.
+ */
+type Vendor = {
+    /**
+     * An identifier of a vendor to whom the product belongs
+     */
+    id: string;
+    /**
+     * vendor name
+     */
+    name?: string;
+};
+/**
+ * Product image details.
+ */
+type ProductImage = {
+    /**
+     * Product image''s unique identifier, generated when the image is added through the Product Service.
+     */
+    id: string;
+    /**
+     * Product image's URL with the file extension specified.
+     */
+    url: string;
+};
+type SingleBatchResponse = {
+    /**
+     * Index of the processed cart item, matching the position in the request body.
+     */
+    index?: number;
+    /**
+     * HTTP response status code.
+     */
+    status: number;
+    /**
+     * Cart item's unique identifier.
+     */
+    id?: string;
+    /**
+     * Descriptive error message for debugging purposes.
+     */
+    errorMessage?: string;
+    headers?: {
+        /**
+         * Cart item location.
+         */
+        location?: string;
+    };
+    yrn?: Yrn;
+};
+/**
+ * Shipping cost information.
+ */
+type Shipping = {
+    fee?: Price;
+    total?: Total;
+};
+type TaxAggregate = {
+    lines?: Array<TaxAggregateLine>;
+};
+type SubtotalAggregate = {
+    currency?: string;
+    netValue?: number;
+    grossValue?: number;
+    taxValue?: number;
+};
+type TaxAggregateLine = {
+    /**
+     * The tax name e.g.: CANADA GST/TPS
+     */
+    name?: string;
+    /**
+     * The tax amount for the line.
+     */
+    amount?: number;
+    /**
+     * The tax rate is a percentage between 0 and 100, e.g.: 5.00
+     */
+    rate?: number;
+    /**
+     * The taxable amount.
+     */
+    taxable?: number;
+};
+/**
+ * The tax amount from an external source, requiring either gross amount, net amount, or both to be specified
+ */
+type TaxValue = {
+    /**
+     * Tax name. This field is required only when the itemType is set as EXTERNAL and the request contains an external price.
+     */
+    name?: string;
+    /**
+     * Tax rate based on which the net/gross values can be calculated. This field is required only when the itemType is set as EXTERNAL and the request contains an external price.
+     */
+    rate?: number;
+    /**
+     * The gross value (amount including tax). If not provided, it's calculated based on the net value and tax rate.  If provided then the price effective amount must be equal to it. This field is required only when the itemType is set as EXTERNAL and the request contains an external price.
+     */
+    grossValue?: number;
+    /**
+     * The net value (amount excluding tax). If not provided, it's calculated based on the gross value and tax rate.  If provided then the price effective amount must be equal to it. This field is required only when the itemType is set as EXTERNAL and the request contains an external price.
+     */
+    netValue?: number;
+};
+type TaxValueWithQuantity = TaxValue & {
+    /**
+     * Represents the item quantity for which the external `lineTax` was provided.
+     */
+    quantity?: number;
+};
+type Total = {
+    /**
+     * Subtotal for the products.
+     */
+    subTotal?: number;
+    /**
+     * Total tax for the products.
+     */
+    totalTax?: number;
+    /**
+     * Total amount the customer will pay for the products.
+     */
+    total?: number;
+    /**
+     * Total discount for the products
+     */
+    discount?: number;
+};
+type UpdateCartItem = {
+    externalFees?: Array<ExternalFee>;
+    /**
+     * External discounts applied to this cart item.
+     */
+    externalDiscounts?: Array<ExternalDiscount>;
+    product?: UpdateProduct;
+    itemYrn?: Yrn;
+    itemType?: ItemType & {
+        [key: string]: unknown;
+    };
+    /**
+     * Quantity of the product added to cart.
+     */
+    quantity?: number;
+    /**
+     * Tax code. Tax indicated in this field overrides the site's default tax value.
+     */
+    taxCode?: string;
+    tax?: TaxValue & {
+        [key: string]: unknown;
+    };
+    price?: PriceRowItem;
+    /**
+     * Externally calculated total line price (`unit price × quantity`). When provided, this overrides internal calculations.
+     */
+    linePrice?: {
+        effectiveAmount: number;
+        originalAmount: number;
+        currency: string;
+    };
+    /**
+     * Externally calculated total tax for the item line. Only allowed when `itemType = EXTERNAL`.
+     */
+    lineTax?: TaxValue;
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type UpdateProduct = {
+    /**
+     * Product code.
+     */
+    code?: string;
+    /**
+     * Product Stock Keeping Unit (SKU).
+     */
+    sku?: string;
+    /**
+     * Product description.
+     */
+    description?: string;
+    /**
+     * Product name.
+     */
+    name?: string;
+    /**
+     * A product name represented as a map, with language as the key and the corresponding translated name as the value
+     */
+    localizedName?: {
+        [key: string]: string;
+    };
+    /**
+     * List of product images.
+     */
+    images?: Array<ProductImage>;
+    metadata?: MetadataRequest;
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+type BatchResponse = Array<SingleBatchResponse>;
+/**
+ * A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant.
+ */
+type Yrn = string;
+type ItemType = 'EXTERNAL' | 'INTERNAL';
+/**
+ * A price calculation model containing net and gross amounts along with their associated tax details.
+ */
+type CalculatedPrice = {
+    /**
+     * Net value of the price, price without tax.
+     */
+    netValue?: number;
+    /**
+     * Gross value of the price, price with tax.
+     */
+    grossValue?: number;
+    /**
+     * Tax value of the price, it's the actual amount of tax that has to be paid.
+     */
+    taxValue?: number;
+    /**
+     * Tax code applied to the price, a tax code is a country's set of tax rules.
+     */
+    taxCode?: string;
+    /**
+     * Tax rate applied to the price, it's the percentage at which an individual or business is taxed.
+     */
+    taxRate?: number;
+};
+type CalculatedPriceWithDiscounts = CalculatedPrice & {
+    /**
+     * List of applied discounts for the calculated price.
+     */
+    appliedDiscounts?: Array<CalculatedAppliedDiscount>;
+};
+type CalculatedPriceWithTaxAggregate = CalculatedPrice & {
+    taxAggregate?: CalculatedTaxAggregate;
+};
+/**
+ * Aggregated tax information showing detailed tax calculations
+ */
+type CalculatedTaxAggregate = {
+    /**
+     * List of tax calculations grouped by taxCode and taxRate
+     */
+    lines?: Array<CalculatedPrice>;
+};
+/**
+ * A breakdown of the total price calculated from all line items, including detailed pricing components.
+ */
+type CartCalculatedPrice = {
+    price?: CalculatedPrice & {
+        /**
+         * Net value of the price, price without tax.
+         */
+        netValue?: number;
+        /**
+         * Gross value of the price, price with tax.
+         */
+        grossValue?: number;
+        /**
+         * Tax value of the price, it's the actual amount of tax that has to be paid.
+         */
+        taxValue?: number;
+        /**
+         * Tax code applied to the price, a tax code is a country's set of tax rules. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxCode?: string;
+        /**
+         * Tax rate applied to the price, it's the percentage at which an individual or business is taxed. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxRate?: number;
+    };
+    upliftValue?: CalculatedPrice & {
+        /**
+         * Net value of the uplift amount, value without tax.
+         */
+        netValue?: number;
+        /**
+         * Gross value of the uplift amount, value with tax.
+         */
+        grossValue?: number;
+        /**
+         * Tax value of the uplift amount, it's the actual amount of tax that has to be paid.
+         */
+        taxValue?: number;
+        /**
+         * Tax code applied to uplift amount, a tax code is a country's set of tax rules. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxCode?: string;
+        /**
+         * Tax rate applied to the uplift amount, it's the percentage at which an individual or business is taxed. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxRate?: number;
+    };
+    discountedPrice?: CalculatedPriceWithDiscounts & {
+        /**
+         * The net value after applying discounts.
+         */
+        netValue?: number;
+        /**
+         * The gross value after applying discounts.
+         */
+        grossValue?: number;
+        /**
+         * The difference between `grossValue` and `netValue`.
+         */
+        taxValue?: number;
+        /**
+         * Tax code applied to the discounted price, a tax code is a country's set of tax rules. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxCode?: string;
+        /**
+         * Tax rate applied to the discounted price, it's the percentage at which an individual or business is taxed. If all fees have the same taxRate, then the value is present. Otherwise, the field is not returned.
+         */
+        taxRate?: number;
+    };
+    fees?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    totalFee?: CalculatedPriceWithDiscounts & {
+        /**
+         * Net value of the total fee, value without tax.
+         */
+        netValue?: number;
+        /**
+         * Gross value of the total fee, value with tax.
+         */
+        grossValue?: number;
+        /**
+         * Tax value of the total fee, it's the actual amount of tax that has to be paid.
+         */
+        taxValue?: number;
+        /**
+         * If all fees have the same `taxCode` defined, resulting in the same `taxRate`, the value is present. Otherwise, the field is not returned in the response.
+         */
+        taxRate?: number;
+        /**
+         * If all fees have the same `taxCode` defined, the value is present. Otherwise, the field is not returned in the response.
+         */
+        taxCode?: string;
+        /**
+         * A list of discounts applied to on the line item fees. The payment fee itself is not discountable.
+         */
+        appliedDiscounts?: unknown;
+    };
+    shipping?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    /**
+     * The total shipping cost is calculated by summing `items[].calculatedPrice.price.grossValue` for shipping estimation. `GrossValue` is used because, even for zero-tax items, it remains equal to `netValue`. The `totalShipping` is the value *after all the discounts*, if any discounts were applied.
+     */
+    totalShipping?: CalculatedPriceWithDiscounts & {
+        /**
+         * The net value after applying discounts.
+         */
+        netValue?: number;
+        /**
+         * The gross value after applying discounts.
+         */
+        grossValue?: number;
+        /**
+         * The difference between `grossValue` and `netValue`.
+         */
+        taxValue?: number;
+        /**
+         * Tax code applied to the shipping cost, a tax code is a country's set of tax rules.
+         */
+        taxCode?: string;
+        /**
+         * Tax rate applied to the shipping cost, it's the percentage at which an individual or business is taxed.
+         */
+        taxRate?: number;
+        /**
+         * A list of discounts applied to shipping.
+         */
+        appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+            /**
+             * Discount identifier.
+             */
+            id?: string;
+            /**
+             * Value of the discount that was applied.
+             */
+            value?: number;
+            /**
+             * PERCENT for percentage discounts and ABSOLUTE for amount applied to the line item.
+             */
+            discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+        }>;
+    };
+    totalDiscount?: CalculatedTotalDiscount & {
+        /**
+         * Indicates whether discounts were applied to net or gross values.
+         */
+        calculationType?: 'ApplyDiscountBeforeTax' | 'ApplyDiscountAfterTax';
+        /**
+         * Aggregated sum of `lines[].calculatedPrice.totalDiscount.value` plus the sum of shipping discounts `totalShipping.appliedDiscounts[].value`.
+         */
+        value?: number;
+        /**
+         * A list of the applied discounts.
+         */
+        appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+            /**
+             * Discount identifier.
+             */
+            id?: string;
+            /**
+             * The sum of all `lines[].calculatedPrice.totalDiscount.value` plus `totalShipping.appliedDiscounts[].value` grouped by the discount ID.
+             */
+            value?: number;
+            /**
+             * PERCENT for percentage discounts, ABSOLUTE for monetary amount and FREE_SHIPPING is shipping is fully discounted.
+             */
+            discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+        }>;
+    };
+    finalPrice?: CalculatedPriceWithTaxAggregate & {
+        /**
+         * The sum of line items, `discountedPrice.netValue` or `price.netValue`, and `totalFee.netValue`.
+         */
+        netValue?: number;
+        /**
+         * The sum of line items, `discountedPrice.grossValue` or `price.grossValue`, and `totalFee.grossValue`.
+         */
+        grossValue?: number;
+        /**
+         * The result of subtracting `netValue` and `grossValue`, which is equal to the sum of all `taxValues` from the prices.
+         */
+        taxValue?: number;
+        /**
+         * If the tax code of the line item matches the tax code of all applied fees, the tax rate is populated with the value. Otherwise, it's not returned in the response.
+         */
+        taxRate?: number;
+        /**
+         * The common tax code of the line item and all applicable fees. If at least one fee does not have a defined tax code, the common tax code cannot be determined, and the field is empty.
+         */
+        taxCode?: string;
+        taxAggregate?: {
+            lines?: CalculatedPrice & {
+                /**
+                 * Net value of the tax, value without tax.
+                 */
+                netValue?: number;
+                /**
+                 * Gross value of the tax, value with tax.
+                 */
+                grossValue?: number;
+                /**
+                 * Tax value of the tax, it's the actual amount of tax that has to be paid.
+                 */
+                taxValue?: number;
+                /**
+                 * Tax code applied to the tax, a tax code is a country's set of tax rules.
+                 */
+                taxCode?: string;
+                /**
+                 * Tax rate applied to the tax, it's the percentage at which an individual or business is taxed.
+                 */
+                taxRate?: number;
+            };
+        };
+    };
+};
+type CalculatedFee = {
+    /**
+     * Unique identifier of the fee.
+     */
+    id?: string;
+    /**
+     * INTERNAL defined in commerce engine, EXTERNAL specified when an item is added to the cart
+     */
+    origin?: 'INTERNAL' | 'EXTERNAL';
+    /**
+     * Type of the fee.
+     */
+    type?: 'PERCENT' | 'ABSOLUTE' | 'ABSOLUTE_MULTIPLY_ITEMQUANTITY';
+    /**
+     * Localized names of the fee.
+     */
+    name?: {
+        [key: string]: string;
+    };
+    price?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    discountedPrice?: CalculatedPriceWithDiscounts & {
+        [key: string]: unknown;
+    };
+};
+type ItemCalculatedPrice = {
+    price?: CalculatedPrice & {
+        [key: string]: unknown;
+    } & {
+        /**
+         * Indicates how the line item price was determined. - `INTERNAL` — Calculated by Emporix using unit price × quantity. - `EXTERNAL` — Provided externally with `lineTax`.
+         */
+        calculated?: 'INTERNAL' | 'EXTERNAL';
+    };
+    upliftValue?: CalculatedPrice & {
+        /**
+         * Net value of the uplift amount, value without tax.
+         */
+        netValue?: number;
+        /**
+         * Gross value of the uplift amount, value with tax.
+         */
+        grossValue?: number;
+        /**
+         * Tax value of the uplift amount, it's the actual amount of tax that has to be paid.
+         */
+        taxValue?: number;
+        /**
+         * Tax code applied to uplift amount, a tax code is a country's set of tax rules.
+         */
+        taxCode?: string;
+        /**
+         * Tax rate applied to the uplift amount, it's the percentage at which an individual or business is taxed.
+         */
+        taxRate?: number;
+    };
+    discountedPrice?: CalculatedPriceWithDiscounts & {
+        /**
+         * The net value after applying discounts, calculated if `includesTax=false`.
+         */
+        netValue?: number;
+        /**
+         * The gross value after applying discounts, calculated if `includesTax=true`.
+         */
+        grossValue?: number;
+        /**
+         * The difference between `grossValue` and `netValue`.
+         */
+        taxValue?: number;
+        /**
+         * Tax rate applied to the discounted price, it's the percentage at which an individual or business is taxed.
+         */
+        taxRate?: number;
+        /**
+         * Tax code applied to the discounted price, a tax code is a country's set of tax rules.
+         */
+        taxCode?: string;
+        /**
+         * A list of discounts applied to the line item.
+         */
+        appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+            /**
+             * Discount identifier.
+             */
+            id?: string;
+            /**
+             * Value of the discount that was applied.
+             */
+            value?: number;
+            /**
+             * PERCENT for percentage discounts and ABSOLUTE for amount applied to the line item.
+             */
+            discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+        }>;
+    };
+    /**
+     * A list of fees applied to the line item. If there are no fees on the item line, it's not returned in the response.
+     */
+    fees?: Array<CalculatedFee & {
+        /**
+         * Fee identifier.
+         */
+        id?: string;
+        /**
+         * PERCENT for fee percentage of the item's line `price.netValue` - unit price x quantity. ABSOLUTE for the absolute amount assigned to the item line. ABSOLUTE_MULTIPLY_ITEMQUANTITY for the monetary amount multiplied by the item quantity and assigned to the item line.
+         */
+        type?: 'PERCENT' | 'ABSOLUTE' | 'ABSOLUTE_MULTIPLY_ITEMQUANTITY';
+        /**
+         * INTERNAL defined in commerce engine, EXTERNAL specified when an item is added to the cart.
+         */
+        origin?: 'INTERNAL' | 'EXTERNAL';
+        /**
+         * Fee name.
+         */
+        name?: {
+            [key: string]: unknown;
+        };
+        /**
+         * The calculated price of the fee.
+         */
+        price?: {
+            /**
+             * Monetary amount of the fee, depends on the fee type.
+             */
+            netValue?: number;
+            /**
+             * Value calculated based on the `taxCode` and the `taxRate` if `taxable=true`.
+             */
+            grossValue?: number;
+            /**
+             * If a fee is defined with the attribute `taxable=true`, the tax rate is calculated based on the provided `taxCode` at the fee level. A taxable fee must have a defined `taxCode`.
+             */
+            taxRate?: number;
+            /**
+             * Tax code defined on the fee level, for example STANDARD. The value should match the available tax codes in the system configuration.
+             */
+            taxCode?: string;
+            discountedPrice?: CalculatedPriceWithDiscounts & {
+                /**
+                 * The net value after applying discounts, calculated if `includesTax=false`.
+                 */
+                netValue?: number;
+                /**
+                 * The gross value after applying discounts, calculated if `includesTax=true`.
+                 */
+                grossValue?: number;
+                /**
+                 * The difference between `grossValue` and `netValue`.
+                 */
+                taxValue?: number;
+                /**
+                 * Refers to `fees[].price.taxRate`.
+                 */
+                taxRate?: number;
+                /**
+                 * Refers to `fees[].price.taxCode`.
+                 */
+                taxCode?: string;
+                /**
+                 * A list of discounts applied to the line item.
+                 */
+                appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+                    /**
+                     * Discount identifier.
+                     */
+                    id?: string;
+                    /**
+                     * Monetary amount of the discount applied to the price for the given discount ID.
+                     */
+                    value?: number;
+                    /**
+                     * PERCENT for percentage discounts and ABSOLUTE for amount applied to the line item.
+                     */
+                    discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+                }>;
+            };
+        };
+    }>;
+    totalFee?: CalculatedPriceWithDiscounts & {
+        /**
+         * Net value of the price, price without tax.
+         */
+        netValue?: number;
+        /**
+         * Gross value of the price, price with tax.
+         */
+        grossValue?: number;
+        /**
+         * Tax value of the price, it's the actual amount of tax that has to be paid.
+         */
+        taxValue?: number;
+        /**
+         * If all fees have the same `taxCode` defined, which results in the same `taxRate`, then the value is present. Otherwise, the field is not returned.
+         */
+        taxRate?: number;
+        /**
+         * If all fees have the same `taxCode`, then the value is present. Otherwise, the field is not returned.
+         */
+        taxCode?: string;
+        /**
+         * A list of discounts applied to the line item.
+         */
+        appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+            /**
+             * Discount identifier.
+             */
+            id?: string;
+            /**
+             * Sum of all `fees[].discountedPrice.appliedDiscounts[].value` grouped by `discount.id`
+             */
+            value?: number;
+            /**
+             * PERCENT for percentage discounts and ABSOLUTE for amount applied to the line item.
+             */
+            discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+        }>;
+    };
+    totalDiscount?: CalculatedTotalDiscount & {
+        /**
+         * Indicates whether discounts were applied to net or gross values.
+         */
+        calculationType?: 'ApplyDiscountBeforeTax' | 'ApplyDiscountAfterTax';
+        /**
+         * Aggregated sum of `lines[].calculatedPrice.totalDiscount.value` plus the sum of shipping discounts `totalShipping.appliedDiscounts[].value`.
+         */
+        value?: number;
+        /**
+         * A list of the applied discounts.
+         */
+        appliedDiscounts?: Array<CalculatedAppliedDiscount & {
+            /**
+             * Discount identifier.
+             */
+            id?: string;
+            /**
+             * The sum of `discountedPrice.appliedDiscounts[].value` and `fees[].discountedPrice.appliedDiscounts[].value`.
+             */
+            value?: number;
+            /**
+             * PERCENT for percentage discounts and ABSOLUTE for monetary amount.
+             */
+            discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+        }>;
+    };
+    /**
+     * Detailed price calculation for a single line item with all pricing components.
+     */
+    finalPrice?: CalculatedPrice & {
+        /**
+         * The sum of line items, `discountedPrice.netValue` or `price.netValue`, and `totalFee.netValue`.
+         */
+        netValue?: number;
+        /**
+         * The sum of line items, `discountedPrice.grossValue` or `price.grossValue`, and `totalFee.grossValue`.
+         */
+        grossValue?: number;
+        /**
+         * The result of subtracting `netValue` and `grossValue`, which is equal to the sum of all `taxValues` from the prices.
+         */
+        taxValue?: number;
+        /**
+         * If the tax code of the line item matches the tax code of all applied fees, the tax rate is populated with the value. Otherwise, it's not returned in the response.
+         */
+        taxRate?: number;
+        /**
+         * The common tax code of the line item and all applicable fees. If at least one fee does not have a defined tax code, the common tax code cannot be determined, and the field is empty.
+         */
+        taxCode?: string;
+    };
+};
+type CalculatedAppliedDiscount = {
+    /**
+     * The ID of the applied discount.
+     */
+    id?: string;
+    /**
+     * The calculated value of the discount.
+     */
+    value?: number;
+    price?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    /**
+     * The discount type which shows how the discount was calculated. PERCENT refers to a percentage discount for example 10%. ABSOLUTE is a monetary amount.
+     */
+    discountType?: 'PERCENT' | 'ABSOLUTE' | 'FREE_SHIPPING';
+    /**
+     * Indicates whether the discount is from internal coupon (INTERNAL) or external discount (EXTERNAL).
+     */
+    origin?: 'INTERNAL' | 'EXTERNAL';
+};
+/**
+ * The total combined value of all applied discounts.
+ */
+type CalculatedTotalDiscount = {
+    /**
+     * Indicates whether discounts were calculated using net or gross price values.
+     */
+    calculationType?: 'ApplyDiscountBeforeTax' | 'ApplyDiscountAfterTax';
+    /**
+     * The calculated amount of all discounts.
+     */
+    value?: number;
+    price?: CalculatedPrice & {
+        [key: string]: unknown;
+    };
+    /**
+     * All applied discounts that are parts of the sum. Sum of all `discountedPrice.appliedDiscounts[].value` and `fees[].discountedPrice.appliedDiscounts[].value`.
+     */
+    appliedDiscounts?: Array<CalculatedAppliedDiscount>;
+};
+
+/** A cart as returned by the Cart service (all generated fields). */
+type Cart = Cart$1;
+/** The cart-create response (`{ cartId, yrn }`, generated). */
+type CartCreated = CreatedCart;
+/** Generated request bodies (caller sends the exact wire shape). */
+type CreateCartInput = CreateCart;
+type CartItemInput = CartItemRequest;
+type CartItemUpdate = UpdateCartItem;
+/** Per-entry result of `addItemsBatch`. `status` is HTTP-style per entry (e.g. 201 = added, 4xx = failed). */
+type CartItemBatchEntry = SingleBatchResponse;
+/** Response shape of `addItemsBatch` — one entry per input item, matching by `index`. */
+type CartItemsBatchResponse = BatchResponse;
+/** An address payload for cart shipping/billing (generated). */
+type CartAddress = AddressRequest;
+/** Cart operations. Every method requires an explicit customer/anonymous context. */
+declare class CartService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Creates a cart. */
+    create(input: CreateCartInput | undefined, auth: AuthContext): Promise<CartCreated>;
+    /** Fetches a cart by id. */
+    get(cartId: string, auth: AuthContext): Promise<Cart>;
+    /** Returns the current cart for the session, or null if none. */
+    /**
+     * Get the customer / anonymous cart matching the given criteria. Per Emporix:
+     * uniqueness is defined by `siteCode` + `type` + `legalEntityId` +
+     * (`customerId` derived from a customer token, or `sessionId` derived from an
+     * anonymous token). With `create: true`, Emporix creates a new cart if none
+     * matches.
+     *
+     * Returns `null` on 404 (no cart found and `create` was not set). All other
+     * errors are propagated.
+     */
+    getCurrent(auth: AuthContext, opts: {
+        siteCode: string;
+        type?: string;
+        legalEntityId?: string;
+        create?: boolean;
+    }): Promise<Cart | null>;
+    /** Adds an item. */
+    addItem(cartId: string, item: CartItemInput, auth: AuthContext): Promise<Cart>;
+    /**
+     * Adds multiple items in a single request via `POST /carts/{id}/itemsBatch`.
+     * Server-side limit is 200 entries per call — callers handling larger sets
+     * must chunk. The response carries a per-entry `status` (HTTP-style: 201
+     * for added, 4xx/5xx for failed) and `index` matching the input position;
+     * partial failures do **not** throw — inspect `status` per entry.
+     */
+    addItemsBatch(cartId: string, items: CartItemInput[], auth: AuthContext): Promise<CartItemsBatchResponse>;
+    /** Updates an item. */
+    updateItem(cartId: string, itemId: string, patch: CartItemUpdate, auth: AuthContext): Promise<Cart>;
+    /** Removes an item. */
+    removeItem(cartId: string, itemId: string, auth: AuthContext): Promise<Cart>;
+    /** Empties the cart. */
+    clear(cartId: string, auth: AuthContext): Promise<Cart>;
+    /** Applies a coupon. */
+    applyCoupon(cartId: string, code: string, auth: AuthContext): Promise<Cart>;
+    /** Removes a coupon. */
+    removeCoupon(cartId: string, code: string, auth: AuthContext): Promise<Cart>;
+    /** Sets the shipping address. */
+    setShippingAddress(cartId: string, address: CartAddress, auth: AuthContext): Promise<Cart>;
+    /** Sets the billing address. */
+    setBillingAddress(cartId: string, address: CartAddress, auth: AuthContext): Promise<Cart>;
+    /**
+     * Merges one or more anonymous carts into the specified customer cart.
+     * Per Emporix: the target cart in the path **must belong to the logged-in
+     * customer**, and each id in `anonymousCartIds` must belong to an anonymous
+     * customer. Anonymous carts go `CLOSED` on success.
+     *
+     * Requires a customer `AuthContext`.
+     */
+    merge(customerCartId: string, anonymousCartIds: string[], auth: AuthContext): Promise<Cart>;
+}
+
+export { type Cart, type CartAddress, type CartCreated, type CartItemBatchEntry, type CartItemInput, type CartItemUpdate, type CartItemsBatchResponse, CartService, type CreateCartInput };