Aller au contenu

Fournisseurs & prestataires

À quoi ça sert

Cette page décrit la gestion du référentiel fournisseurs (Vendor) : coordonnées, informations bancaires, compte comptable de rattachement et activation/désactivation. C'est ce référentiel qui alimente le choix du fournisseur lors de la création d'un bon de commande.

Prérequis

Prérequis

  • Modules sous licence : SUPPLIES
  • Permissions : supplies.request, supplies.manage
  • Rôles : ACCOUNTANT, ORG_ADMIN

Comment ça marche

1. Consulter la liste des fournisseurs

  1. Ouvrez Administration → Achats → Fournisseurs (/dashboard/admin/supplies/vendors).
  2. La liste affiche, pour chaque fournisseur : code, nom, email, délai de paiement (en jours) et statut (Actif / Inactif).

2. Créer un fournisseur

  1. Cliquez sur Nouveau fournisseur. Un panneau latéral s'ouvre avec le formulaire :
  2. Code * — proposé automatiquement à partir du nom (les 3 premiers mots, 6 caractères max chacun) ; peut être modifié manuellement.
  3. Nom * de l'entreprise.
  4. Email, Téléphone, Adresse (facultatifs).
  5. IBAN / BIC — coordonnées bancaires pour le règlement des factures.
  6. Délai de paiement en jours (30 par défaut).
  7. Compte comptable — sélection dans le plan comptable via le sélecteur de compte (401 — fournisseurs, par défaut).
  8. Cliquez sur Créer. Le fournisseur apparaît immédiatement dans la liste, actif par défaut.

3. Activer ou désactiver un fournisseur

  • Chaque ligne propose un lien Désactiver (ou Activer si déjà inactif).
  • Un fournisseur désactivé n'apparaît plus dans la liste des fournisseurs actifs proposée lors de la création d'un bon de commande, mais reste visible dans l'historique des commandes déjà passées.

Qui peut faire quoi

Permission requise Rôles concernés
supplies.request ACCOUNTANT, ORG_ADMIN
supplies.manage ACCOUNTANT, ORG_ADMIN
Rôle / permission Voir la liste des fournisseurs Créer / modifier / activer / désactiver un fournisseur
supplies.request ✅ ❌
supplies.manage (équipe Achats / Comptabilité) ✅ ✅
Détails techniques

Entité : Vendor (schéma supplies, table vendors) — champs code, name, email, phone, address, taxId, iban, bic, accountingCode (défaut 401), paymentTermsDays (défaut 30), active, notes, createdBy.

Endpoints (/supplies/vendors, permission supplies.manage sauf lecture) :

  • GET /supplies/vendors — liste paginée, filtrable par active.
  • GET /supplies/vendors/active — liste des fournisseurs actifs (utilisée par le formulaire de commande).
  • GET /supplies/vendors/{id}
  • POST /supplies/vendors, PUT /supplies/vendors/{id}
  • POST /supplies/vendors/{id}/activate, POST /supplies/vendors/{id}/deactivate

Pas de package prestataire séparé : le package app.jigi.prestataire existe dans l'arborescence backend mais est vide (aucune classe). La gestion des fournisseurs/prestataires externes est entièrement portée par app.jigi.supplies.domain.Vendor et VendorController/VendorService. Cette page documente donc le comportement réel du code, pas un module distinct.

Cas d'erreur et FAQ

Où puis-je gérer les budgets par catégorie d'achat ? Sur la page Achats → Budget (/dashboard/supplies/budget), accessible avec la permission supplies.manage : allocation par exercice et catégorie, avec suivi du montant engagé et dépensé.

Puis-je supprimer un fournisseur définitivement ? Non, il n'existe pas de suppression : seule la désactivation est proposée, afin de conserver l'historique des commandes et factures liées.

Le code fournisseur proposé automatiquement ne me convient pas, puis-je le changer ? Oui, tapez directement dans le champ Code : dès que vous le modifiez, la suggestion automatique à partir du nom est désactivée pour cette création.

Le compte comptable est obligatoire ? Un compte par défaut (401 — fournisseurs) est pré-rempli ; vous pouvez le changer via le sélecteur de compte si votre plan comptable utilise une subdivision par fournisseur ou par catégorie.

Voir aussi