Skip to main content
Solya POS is built on one data model that both apps and the API read and write. Learning this vocabulary once makes every guide easier to follow, because the same words mean the same thing in the Centrale, at the Caisse and in the API.

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).

Next

Continue with roles and permissions to see who can do what, or the glossary for a quick term lookup.