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

# Magasins, régions & flotte

> Administrer le réseau : magasins et entités juridiques, régions, et flotte de périphériques (caisses).

Cet espace administre la structure physique du réseau : les **magasins** (et
leurs entités juridiques), les **régions** qui les regroupent, et la **flotte**
de périphériques (caisses).

## Magasins

### Rôle

Tenir le **Répertoire des magasins** et la hiérarchie des sociétés exploitantes
qui les possèdent.

### Écrans et actions clés

* **Répertoire des magasins** — liste avec un détail par magasin
  (« Sélectionnez un magasin », « N magasins dans le réseau. »).
* **Réseau : entités juridiques** — la hiérarchie « Société exploitante » /
  « Entité juridique ».
* Création / édition d'un magasin, avec garde-fous : « Un magasin porte déjà cet
  identifiant. », « La chaîne de sociétés de ce magasin est incohérente
  (cycle). »

### Lien avec l'API

`client.stores.list/get/create/update` → `GET /v1/stores`.

## Régions

### Rôle

Regrouper les magasins par zone géographique (« Le réseau par région »).

### Écrans et actions clés

* **Répertoire des régions** — ex. « Auvergne-Rhône-Alpes », « Provence-Alpes-Côte
  d'Azur ».
* Sélection d'une région pour voir ses magasins (« Choisissez une région
  ci-dessus pour voir le détail de ses magasins. » ; « Aucun magasin dans cette
  région »).

### Lien avec l'API

`client.regions.list/get` → `GET /v1/regions`. Les régions sont des données de
référence (lecture) gérées par le seed du réseau.

## Flotte (périphériques)

### Rôle

Superviser « l'état de connexion des caisses du réseau ».

### Écrans et actions clés

* **Appairer un périphérique** / **Modifier le périphérique**.
* **Filtrer les caisses par état** (« Choisir un état »), avec « N/M
  périphériques en ligne » et des états « appairé » / « Déconnecté ».
* Garde-fou : « Un périphérique est déjà appairé sur cette caisse. »

### Lien avec l'API

`client.fleet.list/get/create/update` → `GET /v1/fleet`. L'onboarding des
magasins et périphériques est gardé par le scope `pos.settings.manage`.

## Voir aussi

* [Équipe](/fr/centrale/equipe) — les utilisateurs et leurs accès.
* [Réglages](/fr/centrale/parametres) — les préférences du réseau.
* [Finance réseau](/fr/centrale/finance) — les sessions de caisse.