Skip to main content

Entities

📄️Article

An Article in the ECommerce implementation is a product listed in the webshop. It is the core item that customers browse and add to their shopping cart. Articles carry identifying information such as name, short description, EAN code, product group membership, and unit of measurement. In the webshop context, articles are further enriched with pricing data through PriceLists and PriceListPos entries, and can be grouped via variants (PGVariant) to represent product families with different sizes or grades.

📄️Partner

In the ECommerce context, a Partner represents a registered webshop customer — the individual or company that places orders through the online channel. Partners carry their account number (debitor ID), VAT number, preferred language, and a flag indicating whether they are displayed on the webshop as a visible entity (e.g. as a reseller storefront). The tax model is automatically derived from the presence of a VAT number: a partner with a UID is treated as a business customer subject to reverse charge or net pricing, while one without is treated as a private consumer.

📄️PriceListPos (Price List Position)

A PriceListPos is a single price entry within a price list — defining the price of a specific article in the webshop. Beyond a flat per-unit price, each position can specify a quantity range (from amount / to amount) enabling volume-based pricing tiers: a customer ordering 1–9 units pays the standard price, while ordering 10 or more unlocks a lower volume price. A discount reference can additionally be linked to the position, expressing the discount as a percentage rather than a fixed price reduction.

📄️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.

📄️ShopCartPos (Shopping Cart Position)

A ShopCartPos is a single product line within a customer's shopping cart. Each position records which article (product) the customer wants to order, in what quantity, and specifies the delivery destination address for that particular item — enabling mixed-address carts where different products are shipped to different locations within the same order. The ShopCartPos is the line-level building block of the cart; the cart header (ShopCart) aggregates these positions into a total.

📄️Voucher

A Voucher is a gift card or discount voucher that a customer can redeem during checkout in the webshop. Each voucher has a monetary face value or a discount percentage, is backed by a dedicated article in the product catalog (which allows it to be sold and tracked like any other item), and is authenticated by a unique authorization code that the customer enters at checkout. The system dynamically tracks the remaining balance of a voucher as it is partially or fully redeemed across one or more orders.