The network
Banner (enseigne)
The commercial brand that groups your stores. In the pilot there is a single
banner, derived from your brand list.
Region
An organisational grouping of stores (for reporting and roll-ups). Regions
are reference data — see
GET /v1/regions.Store
A physical point of sale. Stores hold stock, run cash sessions and are the
target of transfers and orders — see
GET /v1/stores.Device / register
A till (register) or peripheral belonging to a store’s fleet — see
GET /v1/fleet.Catalogue and pricing
- Product — a sellable item. Created and edited in the Centrale
(
/v1/products). A product carries its taxonomy (category, attributes), a brand, and a reference (master) price expressed HT (excluding tax). - Unit / SKU — the concrete variant that is counted in stock and rung up at
the till (
GET /v1/products/{id}/units). - Brand — master data attached to products (
/v1/brands). - Taxonomy — the category and attribute axes used to classify products
(
/v1/taxonomy). - Reference price vs store price — every product has a reference price; a
store can override it with a store price (
/v1/store-prices). Temporary price reductions are markdowns (/v1/markdowns). - Kit — a bundle that resolves to component units (
/v1/kits).
Stock and the supply chain
- Stock / inventory — on-hand quantity per unit per store (
/v1/inventory). - Cycle count — a scheduled or ad-hoc physical count that reconciles the
system quantity against reality (
/v1/inventory/counts,/v1/cycle-counts). - Write-off — stock removed for loss, damage or shrinkage
(
/v1/inventory/write-offs). - Transfer — stock moving between two stores (
/v1/transfers). - Purchase order (PO) — stock ordered from a supplier (
/v1/purchase-orders). - Return-to-vendor (RTV) — stock sent back to a supplier
(
/v1/return-to-vendors). - Order (OMS) — a customer order captured centrally and routed to a store to
fulfil (
/v1/orders).
Sales, customers and instruments
- Sale / transaction — a completed checkout (
/v1/sales), the raw material for finance and reporting. - Cash session — a till’s day, from opening float to close, consolidated
across the network as network finance (
/v1/finance). - Customer — a person in the directory, with purchase history and GDPR
consent (
/v1/customers). - Loyalty account — a customer’s points balance and ledger (
/v1/loyalty). - Gift card — a stored-value instrument (
/v1/giftcards). - Promotion / coupon — automatic price rules and single- or batch-issued
codes (
/v1/promotions,/v1/coupons). - Quote — a priced proposal that can be sent, accepted and converted to a
sale (
/v1/quotes).
Money is expressed in cents and excluding tax (HT) across the API unless
a field says otherwise, and the pilot is single-currency (EUR).

