ShopCart

A ShopCart represents a customer's active shopping basket in the e-commerce channel. It holds the current collection of items the customer intends to purchase, along with the running price total, the selected payment type, and references to the billing and shipping addresses chosen during checkout. The ShopCart is the transient pre-order state: once the customer confirms their purchase and payment is validated, the ShopCart is converted into a Contract (the confirmed order document), and a formal invoice is generated.

Beyond the basket itself, the ShopCart exposes contextual order information: once a Contract exists for the cart, the converter surfaces the order date, order number, and order status directly on the ShopCart response, giving the webshop frontend a unified view of a customer's pending or recently placed order without requiring a separate contract lookup. If an invoice has been issued for the associated contract, the invoice reference is also returned, enabling the frontend to link directly to the invoice document from the order confirmation page.