# InStore_Cart

The InStore\_Cart module provides functionality to collect, modify, and prepare items for purchase or return.

## Capabilities

The InStore\_Cart module handles the following InStore functions:

- Creates a Cart based on the addition of a Customer, item, or coupon.

- Adds purchasable items to a payment Cart by scanning or typing the SKU, or by selecting items from the catalog or wishlist.

- Adds returnable items to a refund Cart by scanning or typing the SKU, or by selecting items from the catalog.

- Changes the quantity of an item.

- Removes an item.

- Moves all items from a payment Cart to a wishlist.

- Attaches a Customer to the Cart using the in-cart **Search** feature.

- Detaches a Customer from the Cart using the **Remove Cart** action or the in-cart **Change Customer** button.

- Defines a new shipping address and shipping level for an attached Customer or guest.

  Shipping addresses and shipping levels are not saved to the Customer record.

- Apply item-level discounts such as percent-off, amount-off, or price changes, according to the [administration parameters](/instore/customization/administration-parameters.md).

- Receive Category-level discounts from your Project.

- Apply a Cart-level coupon to the contents of the Cart by scanning the barcode or by typing the coupon’s barcoded number.

- Remove the Cart.

The actions that a user can perform depend on their given [role](/instore/use-the-instore-center/store-roles.md) and the [parameter settings](/instore/customization/administration-parameters.md) that you define in the InStore Center.

## GitHub location

The source code for the InStore\_Cart module is available on [GitHub](https://github.com/NebulaTerra/modular-store/tree/main/InStore_Cart).

## Administration parameters

You can modify the behavior of this module by setting the following [administration parameters](/instore/customization/administration-parameters.md) in the InStore Center:

### Store Front parameters

- `Allow_Add_Coupon`
- `Allow_Amount_Off_Line_Item`
- `Allow_Order_Item`
- `Allow_Payment_Line_Item_Delete`
- `Allow_Percent_Off_Line_Item`
- `Allow_Price_Change_On_Line_Item`
- `Allow_Remove_Cart`
- `Allow_Save_Cart_As_Wishlist`
- `Allow_Save_Item_To_Wishlist`
- `Allow_Sell_Item`
- `Allow_Receipted_Return`
- `Allow_Refund_Line_Item_Delete`
- `Allow_Unreceipted_Return`
- `Collected_Shipping_Address_Info`
- `Default_Scan_Mode`
- `Maximum_Percent_Off_Line_Item`
- `Required_Shipping_Address_Info`

## User interface

This module affects the **Cart** screen on the InStore POS UI.

## Related pages

- [Search documentation and API specs](/search.md)