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

# Catalogue

> Manage products, brands, taxonomy and kits in the Solya POS Centrale — the master data every store and till sells from.

The **Catalogue** is the master data that defines what your network sells. A
product created here is sellable at every store's Caisse. This guide covers
products, brands, taxonomy and kits; pricing has its own guides for
[store pricing](/en/centrale/prix-magasin) and [markdowns](/en/centrale/demarques).

## What it is for

* Define **products** with their identity, classification, brand and reference
  price.
* Maintain **brands** as reusable master data.
* Organise products with a **taxonomy** of categories and attributes.
* Assemble **kits** (bundles) that resolve to component units.

## Key screens and actions

<Steps>
  <Step title="Browse the catalogue">
    The catalogue screen lists products with their status (Active / Inactive),
    stock signal (In stock / Low / Out of stock) and price. Use it to search and
    open a product.
  </Step>

  <Step title="Create or edit a product">
    The product form captures identity, taxonomy (category and attributes),
    brand, product codes (POS code, supplier article, manufacturer SKU) and the
    reference **HT** price. Images are attached from a URL.
  </Step>

  <Step title="Manage brands">
    The brands screen and brand detail let you create and edit brands and link
    their suppliers; a brand can be deactivated rather than deleted.
  </Step>

  <Step title="Define taxonomy">
    Category and attribute axes classify products. Products also carry their
    resolved category and attributes so downstream screens can filter on them.
  </Step>

  <Step title="Build kits">
    A kit groups component units into a single sellable bundle that resolves to
    its parts.
  </Step>
</Steps>

<Note>
  Reference prices are HT (excluding tax) and in cents. Per-store overrides are set
  in [store pricing](/en/centrale/prix-magasin) and temporary reductions in
  [markdowns](/en/centrale/demarques).
</Note>

## In the API

| Capability | Endpoints                                                                                                                               |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Products   | `GET/POST /v1/products`, `GET/PUT /v1/products/{id}`, `GET /v1/products/{id}/units`, `POST /v1/products/import`                         |
| Brands     | `GET/POST /v1/brands`, `GET/PUT /v1/brands/{brandId}`, `POST /v1/brands/{brandId}/deactivate`, `GET/PUT /v1/brands/{brandId}/suppliers` |
| Taxonomy   | `GET/POST /v1/taxonomy`, `GET/PUT /v1/taxonomy/{axisId}`, `POST /v1/taxonomy/{axisId}/deactivate`                                       |
| Kits       | `GET/POST /v1/kits`, `PUT /v1/kits/{id}`, `POST /v1/kits/{id}/deactivate`, `GET /v1/kits/{id}/resolve`                                  |
| Search     | `GET /v1/search`                                                                                                                        |

See the [API Reference](/en/developers/overview) for full request and response
shapes. Catalogue writes require a catalogue **manage** scope — see
[roles and permissions](/en/getting-started/roles-and-permissions).