> ## Documentation Index
> Fetch the complete documentation index at: https://docs-pos.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Core concepts

> The vocabulary and data model shared by the Centrale, the Caisse and the API — network, catalogue, stock, sales, customers and instruments.

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

<CardGroup cols={2}>
  <Card title="Banner (enseigne)" icon="store">
    The commercial brand that groups your stores. In the pilot there is a single
    banner, derived from your brand list.
  </Card>

  <Card title="Region" icon="map">
    An organisational grouping of stores (for reporting and roll-ups). Regions
    are reference data — see `GET /v1/regions`.
  </Card>

  <Card title="Store" icon="shop">
    A physical point of sale. Stores hold stock, run cash sessions and are the
    target of transfers and orders — see `GET /v1/stores`.
  </Card>

  <Card title="Device / register" icon="cash-register">
    A till (register) or peripheral belonging to a store's fleet — see
    `GET /v1/fleet`.
  </Card>
</CardGroup>

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

<Note>
  Money is expressed **in cents** and **excluding tax (HT)** across the API unless
  a field says otherwise, and the pilot is single-currency (EUR).
</Note>

## Next

Continue with [roles and permissions](/en/getting-started/roles-and-permissions)
to see who can do what, or the [glossary](/en/getting-started/glossary) for a
quick term lookup.