---
title: "Inventaire mobile"
weight: 35
description: "Guide d'utilisation du mode inventaire de l'application smartphone : création du parc client (clients, sites, équipements) directement sur le terrain, avec gestion du mode hors ligne."
---

# Inventaire mobile

## À quoi sert le mode inventaire

Le mode **inventaire** permet au technicien ou au commercial de saisir le parc d'équipements d'un client directement sur le terrain, **sans avoir besoin de créer préalablement la fiche client dans Dolibarr**. C'est le cas d'usage typique des métiers de distribution (machines à café, distributeurs, EPI, extincteurs) où le premier passage chez un prospect inconnu sert à faire l'inventaire en même temps que la découverte commerciale.

Le mode fonctionne entièrement **hors ligne** : tout peut être saisi sans réseau (sous-sol, ascenseur, zone blanche), puis se synchronise automatiquement au retour de connectivité.

## Accès au mode inventaire

Sur la page d'accueil de l'application smartphone, appuyez sur le bouton **+** en bas à droite. Une fenêtre s'ouvre avec deux choix :

- **Créer une intervention** (comportement habituel).
- **Inventaire du parc client** (nouveau).

Choisissez "Inventaire du parc client" pour entrer dans le flux.

![Choix "Inventaire du parc client" depuis le bouton + de l'accueil](screenshots/inventaire-acces.webp)

Le bouton **+** n'apparaît que si vous avez le droit `mobilecreate` (géré par votre administrateur Dolibarr dans **Utilisateurs et groupes > Permissions > SmartInterventions**).

## Étape 1 -- Choisir un client

Une page de recherche s'ouvre. Tapez le nom du client (ou une partie) dans le champ de recherche. Les résultats apparaissent au fil de la saisie, depuis le cache local **et** depuis le serveur si vous êtes en ligne.

![Recherche et choix du client dans le flux d'inventaire](screenshots/inventaire-client.webp)

Si le client n'existe pas encore, appuyez sur le bouton **+ Nouveau client / prospect**. Un formulaire court s'affiche :

| Champ | Obligatoire | Notes |
|-------|-------------|-------|
| Nom | oui | Nom commercial ou raison sociale. |
| Ville | oui | Aide à détecter les doublons lors de la fusion ultérieure. |
| Code postal | oui | Idem. |
| Téléphone | non | Si connu sur place. |
| Email | non | Pour l'envoi automatique des rapports plus tard. |
| SIRET | non | Validé automatiquement à la synchronisation. |

La position GPS est capturée automatiquement en arrière-plan (5 secondes de tentative), sans bloquer le formulaire si vous n'autorisez pas la géolocalisation.

Le bouton **+ Nouveau client** est grisé si vous n'avez pas le droit Dolibarr `societe/creer`. Demandez à votre administrateur de vous accorder ce droit si vous êtes amené à créer des prospects sur le terrain.

À la validation : le client est créé localement, marqué comme "Brouillon" tant qu'il n'est pas synchronisé avec le serveur, et l'application passe directement à l'étape 2 (sites).

La fiche est créée côté Dolibarr en tant que **prospect** (et non client) : c'est cohérent avec le cas d'usage de découverte commerciale. Le tiers deviendra automatiquement un client lors de l'émission de sa première facture. Son **code client** est attribué automatiquement par le module de numérotation configuré dans Dolibarr ; vous n'avez rien à saisir sur le terrain.

## Étape 2 -- Choisir un site

Le mot **site** désigne ici un emplacement physique d'installation chez le client (un local, un café, un magasin, une succursale, etc.). Un client peut avoir plusieurs sites.

La page liste les sites connus du client courant. Source primaire : cache local. Source secondaire : serveur si vous êtes en ligne. Les sites en attente de synchronisation portent un badge **"Brouillon"**.

![Choix du site du client dans le flux d'inventaire](screenshots/inventaire-site.webp)

Si le client n'a qu'**un seul** site, l'application le sélectionne automatiquement et vous passe directement à l'étape 3 (équipements). Cas très fréquent. Le fil d'Ariane reste cliquable en haut de l'écran (`Client > Site > Équipements`) : touchez la pastille "Site" pour revenir à la liste et éventuellement ajouter un autre site.

Pour ajouter un nouveau site, appuyez sur **+ Nouveau site** :

| Champ | Obligatoire | Notes |
|-------|-------------|-------|
| Libellé | oui | Ex : "Café principal", "Local technique R+2". |
| Adresse | non | Encouragée. |
| Code postal | non | Encouragé. |
| Ville | non | Encouragée. |
| Note publique | non | Visible par le client (consignes d'accès, horaires). |
| Note privée | non | Interne (codes parking, mots de passe). |

GPS capturé en arrière-plan.

À la validation, le nouveau site est créé localement et l'application passe à l'étape 3.

## Étape 3 -- Liste des équipements du site

La page affiche le parc d'équipements du site avec un fil d'Ariane en haut (`Client > Site > Équipements`).

Champ de recherche en haut : tapez une partie d'un identifiant pour filtrer la liste. La recherche est insensible à la casse et porte sur :

- la référence (`ref`),
- le numéro de série (`serial_no`),
- le libellé (`label`),
- la zone (`zone`),
- la note publique (toujours),
- la note privée (seulement si vous avez le droit de lecture sur l'équipement).

Tri par défaut : zone, puis étage, puis référence.

Chaque ligne affiche : icône QR, référence (ou "Brouillon" si non synchronisé), libellé, numéro de série, zone. Touchez une ligne pour ouvrir la fiche détail.

![Liste des équipements du site avec recherche et fil d'Ariane](screenshots/inventaire-equipements.webp)

## Étape 4 -- Ajouter un équipement

Appuyez sur le bouton **+ Ajouter un équipement** toujours visible en bas de la liste.

![Formulaire d'ajout d'un équipement et caractéristiques techniques](screenshots/inventaire-ajout-equipement.webp)

### Type d'équipement et caractéristiques techniques

En haut du formulaire, choisissez le **Type d'équipement** dans la liste déroulante (extincteur, imprimante, ordinateur, équipement réseau...). Cette liste reprend les types pré-importés pour votre société (voir [Configuration](/smartinterventions/configuration) et la base [schemas.cap-rel.fr](https://schemas.cap-rel.fr/)).

Le type choisi fait apparaître une section **Caractéristiques techniques** : un formulaire dont les champs sont **propres à ce type de matériel**. Par exemple :

- pour un extincteur : agent extincteur, capacité, année de fabrication, date de prochaine vérification... ;
- pour une imprimante : compteur de pages, niveau de toner... ;
- pour un équipement réseau : SSID, date de rotation du mot de passe...

Chaque caractéristique s'affiche avec le bon type de saisie : champ texte, nombre, date (avec calendrier), case à cocher, ou liste déroulante pour les valeurs prédéfinies (par exemple l'agent d'un extincteur). Les libellés sont traduits dans la langue de votre interface.

Quelques règles utiles :

- Les champs marqués d'un astérisque (*) sont **conseillés** mais **non bloquants** : vous pouvez enregistrer une fiche incomplète et la compléter plus tard. L'objectif sur le terrain est de saisir vite, quitte à affiner ensuite.
- Si vous changez de type, les caractéristiques sont réinitialisées (chaque type a ses propres champs).
- Les valeurs saisies sont enregistrées avec l'équipement et **reprises sur les rapports PDF**.
- Si un type ne définit aucune caractéristique, un simple champ libre est proposé à la place.

> Note : dans les versions précédentes, ces informations se saisissaient dans un unique champ technique au format JSON. Ce n'est plus le cas -- chaque caractéristique a désormais son propre champ adapté.

### Section "Identification QR"

![Section Identification QR du formulaire d'équipement (scan, saisie manuelle, étiquette générée)](screenshots/inventaire-qr-identification.webp)

Trois modes en parallèle, au choix selon le matériel disponible :

1. **Scanner un code** : ouvre la caméra. Visez l'étiquette QR pré-imprimée posée sur l'équipement ou son emplacement. Le code lu est stocké dans le champ QR.
2. **Générer QR à la volée** : crée un identifiant unique côté application. Le QR est affiché à l'écran -- prenez-le en photo ou imprimez-le ultérieurement en back-office (planche A4 générable depuis Dolibarr).
3. **Saisir le code à la main** : mode dégradé si la caméra est inutilisable. Champ texte simple.

Si vous scannez un code **déjà attaché** à un autre équipement, un message apparaît :

> Ce code est déjà utilisé par l'équipement <ref> chez <client> (<site>).

Le seul choix possible est **Conserver sur l'ancien équipement**. Le champ QR est vidé et vous devez choisir un autre code. **Pas de réassignation possible** dans cette version : la réassignation explicite (avec saisie de raison) sera disponible dans une mise à jour ultérieure.

### Champs métier

Obligatoires :

- **Numéro de série** -- celui gravé par le constructeur.
- **Libellé** -- description courte.
- **Photos** -- face et plaque constructeur (à minima).

Optionnels :

- **Zone** -- pour les sites multi-zones (salle A, hangar 2, etc.).
- **Étage**.
- **Produit lié** -- choix dans le catalogue Dolibarr si vous voulez relier l'équipement à un modèle produit.

Notes :

- **Note publique** (visible client, imprimable sur les rapports PDF).
- **Note privée** (interne technicien, jamais transmise au client).

GPS capturé automatiquement.

### Avertissement doublon de série

Si vous saisissez un numéro de série déjà présent chez ce client pour le même modèle, une bannière jaune apparaît sous le champ :

> Un équipement avec ce numéro de série et ce modèle existe déjà chez ce client (ref X). Vérifier qu'il ne s'agit pas d'un doublon avant d'enregistrer.

C'est **purement informatif**, non bloquant. Vous pouvez passer outre dans les cas légitimes (deux machines identiques avec une série gravée ambiguë).

### Boutons d'enregistrement

Trois boutons, pensés pour la saisie en série sur le terrain (inventorier tout un parc d'un coup) :

- **Enregistrer** : sauvegarde l'équipement et revient sur la liste du site.
- **Enregistrer et dupliquer** (= "ajouter un autre") : sauvegarde, puis ouvre immédiatement un nouveau formulaire pré-rempli avec le même schéma, le même libellé et le même produit. Les champs identifiants sont vidés (numéro de série, QR, zone, étage, notes, photos) -- vous n'avez qu'à scanner le QR suivant et ajuster ce qui change. Très utile pour saisir en série une dizaine de distributeurs identiques.
- **Enregistrer et terminer** : sauvegarde le dernier équipement et clôt l'inventaire en revenant à l'écran d'accueil de l'application. À utiliser quand vous avez fini la visite.

> Astuce dictée : pour les notes (publique / privée), utilisez le bouton micro du clavier de votre smartphone -- la dictée vocale native remplit le champ sans rien à installer.

## Mode hors ligne

Tout fonctionne **sans réseau**.

- À la création d'un client / site / équipement hors ligne, la fiche est stockée localement avec un identifiant temporaire et un badge **"Brouillon"**.
- Quand le réseau revient, la synchronisation se fait automatiquement en cascade : d'abord les clients en attente, puis les sites (les sites attendent que leur client parent soit synchronisé), puis les équipements (qui attendent que leur site parent soit synchronisé).
- Une fois synchronisé, l'identifiant temporaire est remplacé par l'identifiant serveur et le badge "Brouillon" disparaît.

Si une synchronisation échoue (erreur réseau, permission manquante côté serveur, conflit), la fiche concernée passe en statut "erreur" avec un message explicatif. Les fiches qui en dépendent (par exemple un site dont le client parent est en erreur) restent en "Brouillon" jusqu'à résolution.

### Que faire en cas d'erreur

- Erreur **"qr_token already in use"** : le QR a été attribué à un autre équipement entre temps. Éditez l'équipement local, changez le QR, et la synchronisation reprendra.
- Erreur **"permission denied"** sur un client : votre compte n'a pas le droit Dolibarr `societe/creer`. Demandez-le à votre administrateur.
- Erreur **"socid does not exist"** sur un site : le client parent a été supprimé côté serveur entre temps. Cas rare, contactez votre administrateur.
- Erreur **"ErrorCustomerCodeRequired"** sur un client : le module de numérotation des tiers de Dolibarr est en mode obligatoire mais son masque n'est pas configuré. Demandez à votre administrateur de renseigner le masque de code client dans la configuration des tiers (menu Tiers > Configuration > Codes clients/fournisseurs). Une fois le masque défini, relancez la synchronisation : le code sera attribué automatiquement.

### Brouillons

L'application conserve indéfiniment les brouillons non synchronisés. Si vous changez d'appareil ou que vous réinitialisez l'application, vous perdrez les brouillons locaux. **Synchronisez avant tout changement d'appareil** en vous connectant à Internet et en attendant que tous les badges "Brouillon" disparaissent.

## Doublons de clients

L'application ne déduplique pas les clients automatiquement (pas de "fuzzy match" sur les noms). Si vous créez deux fois le même prospect (frappe différente, espace en trop, accent oublié), deux fiches différentes seront poussées sur Dolibarr.

Réglez les doublons côté back-office Dolibarr via l'outil standard **Tiers > Fusion** après la synchronisation. C'est la pratique recommandée pour ce module.

## Retrouver un équipement en scannant son QR (depuis l'application)

Sur la page **Parc d'équipements** (la liste du parc d'un client dans l'application smartphone), un bouton **Scanner un QR** est disponible en haut de la liste.

Appuyez dessus, visez l'étiquette QR collée sur l'équipement (ou son emplacement), et l'application ouvre **directement la fiche maintenance** de cet équipement. Plus besoin de chercher la ligne à la main dans une longue liste : le scan vous y emmène en un geste.

![Bouton "Scanner un QR" sur la liste du parc, pour ouvrir directement la fiche équipement](screenshots/inventaire-scan-qr.webp)

Quelques précisions :

- **Fonctionne hors ligne** : le code scanné est d'abord résolu depuis le cache local de l'appareil. Si l'équipement n'est pas en cache et que vous êtes en ligne, l'application interroge le serveur. Si le code est inconnu, un message le signale et rien ne se passe.
- **Étiquette QR universelle** : l'étiquette imprimée encode l'adresse de l'équipement. Scannée **depuis l'application**, elle ouvre la fiche maintenance ; scannée **hors application** (appareil photo natif du téléphone), la même étiquette ouvre la **page publique** de l'équipement dans le navigateur. Vous n'avez donc qu'un seul QR à coller, quel que soit l'usage.
- Les planches d'étiquettes QR s'impriment depuis le back-office Dolibarr (voir ci-dessous).

## Consultation du parc en back-office

Le parc saisi sur le terrain se consulte aussi côté Dolibarr (back-office) de deux façons :

- **Par client** : sur la fiche d'un tiers, l'onglet SmartInterventions expose la
  liste des équipements de ce client (recherche, tri, pagination, et actions de
  masse propres à ce client : planches d'étiquettes Avery, planche de QR codes,
  réaffectation de site, changement de statut groupé).
- **Inventaire global du parc** : menu **Commercial > Interventions >
  Inventaire du parc**. Cette page liste le parc de **tous les clients** dans un
  seul tableau, avec un filtre par **tiers**, par **schéma** d'équipement, par
  **statut**, par **zone** et par **échéance de contrôle** (équipements à
  contrôler avant une date donnée). Chaque ligne renvoie vers la fiche de
  l'équipement (colonne Réf) et vers la liste par client (colonne Tiers). C'est
  la vue à utiliser pour repérer d'un coup d'oeil, tous clients confondus, les
  contrôles à venir ou les équipements d'un type donné.

![Onglet SmartInterventions sur la fiche d'un tiers : parc d'équipements du client en back-office](screenshots/parc-client-backoffice.webp)

![Inventaire global du parc, tous clients, avec filtres tiers / schéma / statut / zone / échéance](screenshots/parc-global-backoffice.webp)

![Planche de QR codes d'équipements générée pour impression](screenshots/planche-qrcodes.webp)

L'accès à ces deux vues est conditionné au droit **"Consulter le parc
d'équipements"**. Les actions de masse par client nécessitent en plus le droit
**"Créer / modifier le parc d'équipements"**.

## Limites connues de cette version

Cette version (2.0.64) couvre le **coeur** de la gestion de parc :

- création client / site / équipement,
- mode hors ligne avec synchronisation en cascade,
- collision QR strictement bloquante,
- duplication rapide,
- recherche et filtre.

Ne sont **pas encore** couverts par cette version (prévus dans la version 2.2.0) :

- **Transfert d'équipement** d'un site à un autre, ou d'un client à un autre.
- **Cycle de vie** d'un équipement (en service, en réparation, décommissionné, retour stock, rebut).
- **Dates métier** (installation, fin de garantie, dernière maintenance, prochaine échéance).
- **Historique des évènements** par équipement, filtré par période de propriété.
- **Codes-barres 1D** (Code 128, EAN-13, DataMatrix) en plus du QR.
- **Réassignation QR** avec saisie de raison.