eZ Commerce provides a flexible basket system. A basket is identified by:
- session ID (if the user is not logged in)
- user ID (if the user is logged in)
Doctrine is used to store the basket in the database.
The basket can be of one of the following types:
storedBasket, stored with a user-set name
A standard basket (type
basket) can be in different states during the checkout process. After the order is sent, the basket is assigned the state
The basket enables storing project-specific information in several places:
- Basket header
- Basket lines
- Basket parties
Additional fields can be placed in the basket header (
These can be simple fields or complex data as well.
Basket lines contain information such as:
- variant code
- a remark or additional data per basket line. See Additional data in the basket line
Basket parties include:
- BuyerParty - address of the customer (usually this address is the same as the InvoiceParty)
- InvoiceParty - address for the invoice from the checkout or customer profile
- DeliveryParty - delivery address given by the customer
Baskets in multishop¶
You can configure a
shop_id for each shop. The
shop_id is stored in the basket.
Additional costs can be stored in the basket to implement all kinds of additional costs or discounts, such as:
- shipping costs
- costs for packaging
- costs for payment
- discount for vouchers
- general discounts for total order
The customer can provide a general remark for the basket in the checkout.
Handling of discontinued products¶
The BasketLine stores a serialized version of the product in the basket line. Configuration controls which Fields from the product are stored.
A price engine calculates the prices and provides up-to-date information about stock. The basket contains a flag that controls if a recalculation has to be done (timeout).
Merging of baskets¶
After the user logs in, eZ Commerce merges the products from the existing basket (filled as an anonymous user) and a basket which is already stored for the given user ID.
If an SKU is already present in a basket, a new line is created in the user's basket.
A basket can be shared if a user logs in from a different browser (default), or it can be bound to the session.
If you do not want the basket to be shared between different sessions, change the following setting to