Managing Price Forcing in Cart Items

Overview

When processing a shopping cart in the e-commerce system, there may be situations where the price of a product is overridden or forced to a new value. This feature allows the e-commerce platform or sales personnel to modify the product price directly within the cart, providing flexibility for discounts, promotions, or manual price adjustments.

This documentation outlines how price forcing should be handled, including the necessary fields to be populated when submitting a cart for validation or sale.

Fields for Price Forcing

To manage price forcing effectively, the following fields must be populated for each line item in the cart:

unitPrice:

Description: This field represents the current price of the product after applying the price override (if any).

Value: It should be populated with the price at which the product will be sold after the override. If no price override is applied, this value will be the same as the originalPrice.

originalPrice:

Description: This field indicates the original price of the product as per the price list before any overrides.

Value: It should contain the original price of the product as specified in the e-commerce system's price list.

priceForcingReason:

Description: This field captures the reason or code for why the price has been overridden. This allows tracking of price changes and understanding the rationale behind them.

Value: It should be populated with a valid code from the predefined list of price forcing reasons. This list might include reasons such as "Promotion", "Manager Override", "Price Match", etc.

Implementation Guidelines

Handling Price Forcing:

If a product's price is manually overridden, the system must populate the unitPrice with the new price and retain the originalPrice from the price list.

The priceForcingReason field must be filled with the appropriate code that explains why the price was changed.

Example:

In this case, the price for the line item has been overridden from the original list price. The original price (originalPrice) was 215, but it has been changed to 21 and is now listed as the product price in unitPrice, with the forcing reason code FORZA_PREZZO indicated in priceForcingReason.

{
    "transactionId": "{% faker datatype.uuid %}",
    "movementType": "V",
    "barcodeInfo": "{{ean13}}",
    "currency": "EUR",
    "currencySymbol": "€",
    "branchCode": "9999",
    "entityCode": "501",
    "docNumberDigital": "{% faker random.numeric %}",
    "docNumber": "TICKET_{% faker random.numeric %}",
    "endDate": "2024-07-22 10:07:49",
    "startDate": "2024-07-22 10:07:49",
    "deliveryDate": "2024-07-22 10:07:49",
    "clientDenomination": "Mario Rossi",
    "discountsManualCumulative": "N",
    "registerCode": "1",
    "clientId": "11111",
    "ticket": 240905,
    "rounding": 2,
    "onlineValidation": "Y",
    "seller": "Marco Bianchi",
    "sellerId": 1001,
    "filling": "FIRST",
    "callback": "https://webhook.site/c171c596-972a-46b8-89d8-99c4ab79169a",
    "items": [
        {
            "rowId": "{% faker datatype.uuid %}",
            "rowType": "ITEM",
            "barcode": "8058251375998",
            "barcodeType": "EAN13",
            "qty": 1,
            "qtyType": "N",
            "itemState": "SERVER_OK",
            "taxRate": 22,
            "vatCode": 4,
            "description": "Descrizione del prodotto",
            "discountAmount": 0,
            "discountPerc": 0,
            "rowNumber": 1,
            "priceList": "11",
            "rowTotal": 21,
            "rowVat": 3.79,
            "unitPrice": 21,
            "originalPrice": 215,
            "priceForcingReason": "FORZA_PREZZO",
            "itemType": "PRODUCT",
            "itemSubtype": "ITEM",
            "qtaConfirmed": "Y",
            "movementType": "V",
            "printerDepartmentCode": 1,
            "havingTailoring": "N",
            "itemCode": "033---00000",
            "currencySymbol": "€",
            "currency": "EUR",
            "rounding": 2,
            "oldUnitPrice": 215,
            "rowOrder": 1,
            "channel": "IN_STORE"
        }
    ],
    "totals": {
        "total": 193.5,
        "vat": 34.89,
        "grandTotal": 193.5,
        "allowance": 0,
        "alreadyPayed": 0,
        "taxableIncome": 193.5,
        "digitalGrandTotal": 0,
        "totalDeposits": 0,
        "totalDepositsVat": 0
    }
}

In this example, the unitPrice reflects the new selling price, while the originalPrice retains the price from the price list. The priceForcingReason indicates the reason for this adjustment.

Validation:

Before a cart is finalized for validation or sale, the system should check that:

If unitPrice differs from originalPrice, the priceForcingReason is not null and contains a valid code.

The unitPrice is a valid numeric value and does not violate any pricing rules (e.g., cannot be lower than a minimum allowable price unless specifically authorized).

Any discrepancies should trigger an error

Managing Price Forcing in Cart Items