Feature extra ketchup/item in the cart

Owned by Ruani, Andrea
Last updated: Sept 30, 2024 by Sistla Sumanth
4 min read

Solution

The main idea of the solution is to provide the possibility to the FZ to add a free extra item. The focus is on the ketchup but the FZ can setup any item.

Setting Up

 

For this solution to work, we need to ensure that Sanity is properly configured:

  • The creation of the desired Add On Section

There will be all the sections for addons and promotional add-ons

The sections here can be created and saved to be used later because they need to be added to the feature menu.

 

  • Add the Add On Sections that we want to show in the cart into Feature Menu

Add On Sections that will be shown on Whitelabel front end

The order of the list defines the order that the sections will be shown on the cart checkout page.

 

  • Configure the Add On Section correctly to have the behavior to deal with free items:

    • “Show as a separate section on cart” (ON)

    • “Make options in this section as free add-ons” (ON)

    • “Service Modes”

      • Here we’ll choose the desirable service modes that we want to offer the promotion

    • Configure the options (addons) for this Add On Section

      • Add the paid item (“Option”)

      • Add the free item (“Free Option”)

        • Important: the free item needs a PLU with zero price to have the correct behavior

      • Configure the “Menu options that Offer the Free Options Above”

        • Here we’ll configure the item that will receive the offer and the maximum free items quantity

    • Configure the “Free Add On Modal” fieldset if wants to show the promotional modal when the user enters the checkout page

      • “Show Free Add-On Modal at Checkout” → if ON we’ll have this modal shown in the cart

      • The image and description are optional. Title and CTA are required if the toggle is ON.

 

  • To avoid quantity limits for the added items in the cart we need to configure the following on Sanity:

In the example above the user can select only 20 items (individually) in the cart.

This limit will also affect the addons items. Even if we offer 30 free items the user cannot select more than 20 items (in this example).

 

Front-end behaviors and Business rules

After all the requirements are configured, we’ll have the following things on the FE UI:

Promotional modal when entering the checkout the first time/journey/order

  • Basic Rule: show the modal only for the first time (and always if we have a “new cart”, cleaning the cart and adding the products again)

 

Checkout sections

 

 Your Cart behavior with free/paid items

Extras modal to edit addons

 

 

Troubleshoot

  • Section with free items is not in the checkout?

    • All the flags and toggles should be ON as showed in the Requirements section

      • LD FE Flag to be switched ON: Enable-Add-On-As-Cart-Item

    • Sanity needs to be configured properly and the right item (that is offering the free ones) needs to be in the cart

    • If some item used as a free/paid addon in the Add On Section options has an invalid configuration the entire section will be invalid (for example an invalid PLU, or invalid item config, which will be checked on POS)