Paramètres avancés (Administration)

L'écran Paramètres d'HtkDoli regroupe désormais une section Administration dédiée aux outils de configuration côté Dolibarr accessibles depuis l'application mobile. Cette section n'apparaît que si l'utilisateur connecté dispose des permissions nécessaires côté Dolibarr.

Accès

Ouvrez l'onglet Plus (MoreMenuView).
Tapez sur Paramètres.
Faites défiler jusqu'à la section Administration.

Gestion des catégories

La ligne Gestion des catégories est visible si vous disposez de la permission Dolibarr categorie.creer (ou si vous êtes administrateur). Elle ouvre l'écran CategoryManagementView.

Fonctionnalités

L'écran permet de gérer l'ensemble du cycle de vie des catégories Dolibarr (aussi appelées « tags ») pour les types les plus courants :

Tiers (Client) — catégories des clients et prospects.
Fournisseur — catégories des tiers fournisseurs.
Produit — catégories du catalogue produits / services.
Adhérent — catégories d'adhérents.
Contact — catégories de contacts.
Projet — catégories de projets.

Un sélecteur en haut de l'écran permet de basculer entre les types. Pour chaque type, la liste des catégories est récupérée via GET /categories?type=....

Créer une catégorie

Le bouton « + » de la barre du haut ouvre une feuille de création. Vous pouvez saisir :

Libellé (obligatoire).
Description (visible côté Dolibarr).
Couleur au format hexadécimal (RRGGBB).
ID de la catégorie parente pour créer une hiérarchie.

La création utilise l'endpoint Dolibarr POST /categories.

Modifier une catégorie

Tapez sur une ligne pour ouvrir la feuille d'édition pré-remplie.
Ou utilisez le swipe « Modifier » sur la ligne.

La modification utilise l'endpoint PUT /categories/{id}.

Supprimer une catégorie

Le swipe « Supprimer » sur une ligne demande une confirmation avant suppression définitive. La suppression utilise DELETE /categories/{id}.

Permissions et sécurité

Les boutons « + » et les actions de swipe ne sont affichés que si la permission categorie.creer est accordée.
Toutes les opérations sont effectuées via l'API REST Dolibarr et respectent l'isolation par profil de HtkDoli (chaque profil utilise son propre serveur et sa propre clé API).

Société (paramètres)

La ligne Société (paramètres) est visible si vous êtes administrateur sur l'instance Dolibarr connectée (profile.isAdmin). Elle ouvre l'écran CompanySetupView, qui affiche les paramètres globaux de la société Dolibarr.

Ce que vous pouvez consulter

Les informations sont récupérées via GET /setup/company et présentées en cartes :

Identité — raison sociale, capital, devise.
Adresse — adresse, code postal, ville, état/région, pays.
Contact — email, téléphone, fax, site web.
Identifiants légaux — SIREN, SIRET, NAF/APE, RCS, TVA intracommunautaire.
Objet social — description de l'activité.

Un utilisateur non-administrateur qui atteindrait cet écran le voit en lecture seule (un bandeau « Lecture seule (non admin) » est affiché).

Ce que vous pouvez modifier

Le menu ••• du header sticky propose « Modifier » (uniquement si profile.isAdmin). Il ouvre la feuille CompanySetupEditView, qui permet d'éditer l'ensemble des champs ci-dessus. L'enregistrement envoie l'intégralité des champs via PUT /setup/company.

Permissions et sécurité

L'entrée du menu et le bouton « Modifier » sont réservés aux administrateurs (profile.isAdmin).
Toutes les requêtes passent par la clé API du profil courant — l'isolation par profil de HtkDoli est respectée.

Numérotations automatiques

La ligne Numérotations automatiques est visible si vous êtes administrateur sur l'instance Dolibarr connectée (profile.isAdmin). Elle ouvre l'écran NumberingsSetupView.

À quoi ça sert ?

Chaque module Dolibarr (factures, devis, commandes, expéditions, contrats, etc.) utilise un masque de numérotation pour générer automatiquement la référence des nouveaux documents (par exemple FA{yyyy}-{0000} pour les factures). Cet écran liste, pour chaque module, le masque actuellement actif côté Dolibarr.

Ce que vous pouvez consulter

Le masque actif par module est récupéré via GET /setup/numberings.
Le module et son libellé sont affichés en clair, avec le masque actif en police monospace pour lisibilité.
Si l'endpoint n'est pas exposé par votre installation Dolibarr, un état vide explicite vous l'indique (« Aucune numérotation trouvée »).

Ce que vous pouvez modifier (best-effort)

Lorsque l'API Dolibarr renvoie également la liste des masques disponibles pour un module, un tap sur la ligne ouvre une feuille permettant de basculer le masque actif. La modification est envoyée via PUT /setup/numberings/{module}.

⚠️ Limitation connue. Selon la version de votre instance Dolibarr, l'endpoint d'édition peut renvoyer une erreur 404 ou refuser le payload. Dans ce cas, l'écran reste en lecture seule (pas de picker) — il s'agit d'un comportement volontaire pour ne pas exposer un flux de modification cassé. Le statut de modification reste consultable côté serveur Dolibarr (Configuration → Modules → ...).

Permissions et sécurité

L'entrée du menu est masquée pour les utilisateurs non administrateurs.
L'écran lui-même teste à nouveau profile.isAdmin avant d'autoriser l'édition.
Toutes les requêtes passent par la clé API du profil courant — l'isolation par profil de HtkDoli est respectée.

Gestion des utilisateurs

La ligne Utilisateurs est réservée aux administrateurs Dolibarr (profile.isAdmin == true). Elle ouvre l'écran DirectoryUserListView en mode administration : création, modification, suppression et affectation de groupes.

Accès

Les actions d'écriture (bouton « + », swipes, menus contextuels, menu sticky de la fiche détail) ne s'affichent que si le profil connecté est administrateur Dolibarr. Un utilisateur non-admin conserve l'accès lecture seule à l'annuaire — c'est exactement le comportement de l'onglet « Annuaire » classique.

Indexation locale & Recherche globale (mai 2026) — Les utilisateurs visités au moins une fois via DirectoryUserListView sont persistés localement et apparaissent désormais dans la recherche globale de l'application (onglet « Rechercher »). Recherche par login, prénom, nom, email ou fonction ; chaque résultat ouvre directement la fiche utilisateur correspondante.

Créer un utilisateur

Le bouton « + » de la barre du haut ouvre une feuille de création. Les champs disponibles :

Login (obligatoire) — identifiant de connexion Dolibarr.
Prénom et Nom (nom obligatoire).
Email, Téléphone fixe, Téléphone mobile, Fonction / poste.
Compte activé (statut).
Administrateur Dolibarr — accorde tous les droits.
Mot de passe initial (obligatoire à la création) — à communiquer manuellement à l'utilisateur.

La création utilise l'endpoint POST /users.

Modifier un utilisateur

Vous pouvez :

Swiper de gauche à droite sur une ligne pour ouvrir la feuille d'édition pré-remplie.
Utiliser le menu contextuel (appui long) avec l'entrée « Modifier ».
Ouvrir la fiche d'un utilisateur puis taper sur le menu ••• dans le header sticky et choisir « Modifier ».

Le login est en lecture seule en édition (contrainte Dolibarr). Tous les autres champs sont modifiables. La modification utilise PUT /users/{id}.

Supprimer un utilisateur

Swipe à droite « Supprimer » sur la ligne, ou
Menu contextuel « Supprimer », ou
Menu ••• sur la fiche détail.

Une confirmation est demandée avant suppression définitive (DELETE /users/{id}).

Gérer les groupes

Le menu contextuel « Gérer les groupes » (ou l'entrée du menu ••• sur la fiche) ouvre la feuille DirectoryUserGroupsSheet. Elle liste tous les groupes Dolibarr (GET /users/groups) et permet de cocher les groupes à ajouter à l'utilisateur (POST /users/{id}/setGroup/{groupID}?entity=1).

⚠️ Limitation Dolibarr. L'API REST n'expose pas de manière fiable une opération de retrait d'un utilisateur d'un groupe. Pour retirer un utilisateur d'un groupe, passez par l'interface web Dolibarr (Utilisateurs et groupes → Groupes). Cette limitation est rappelée en pied de la feuille de gestion des groupes.

Permissions et sécurité

Toutes les actions d'écriture sont gardées par le flag profile.isAdmin. Les utilisateurs non-admin ne voient ni le bouton « + », ni les swipes, ni les menus, ni la possibilité de modifier la fiche détail.
Toutes les opérations passent par la clé API du profil courant — l'isolation par profil de HtkDoli est respectée.
Le mot de passe initial transite via HTTPS — utilisez impérativement une URL https:// pour votre serveur Dolibarr.

Autres dictionnaires exposés (techniques)

L'application expose en interne, pour ses propres pickers et écrans futurs, les dictionnaires Dolibarr suivants. Ces points d'accès ne disposent pas (encore) d'écran utilisateur dédié, mais sont disponibles côté code :

Pays — GET /setup/dictionary/countries (fetchCountries).
Devises — GET /setup/dictionary/currencies (fetchCurrencies).
Taux de TVA — GET /setup/dictionary/vat (fetchVATRates).
Modules actifs — GET /setup/modules (fetchActiveModules).

Ces dictionnaires sont mis en cache mémoire pour toute la session afin d'éviter de retaper le réseau à chaque fois.

Captures d'écran

3 captures — cliquez pour agrandir