Skip to content

Module 1 — Paramétrage

Le paramétrage est le référentiel de l'application : c'est l'ensemble des données qui alimentent tous les flux (achats, ventes, stock, facturation). Un paramétrage incomplet est la cause n°1 de blocage lors de la saisie d'un document.

🧭 Où trouver ce module dans l'application ? Menu latéral → Paramétrage. Cinq sous-entrées : Tiers & Véhicule, Prix & Taxes, Station-service, Localités & tarifs, Produits et unités.

Menu Paramétrage dans la barre latérale


Les sous-modules en un coup d'œil

Sous-moduleCe qu'il contientPourquoi c'est essentiel
TiersClients, fournisseurs, transporteursRéférencés dans tous les documents d'achat et de vente
VéhiculesTracteurs, citernes, chauffeursRéférencés dans les ordres de livraison et bons de livraison
Prix & TaxesPrix carburant, base facturation, taxes, TSUConditionnent tous les calculs de facturation
Station-serviceStations-service du réseauRéférencées dans les ventes réseau et déviations
FranchiseDépôts consommateursClients à dépôt, ventes franchise
Localités & tarifsVilles, tarifs de transportAlimentent la péréquation transport
Produits & unitésArticles et unités de mesureRéférencés dans toutes les lignes de documents

⚠️ Ordre conseillé. Les produits et unités doivent exister avant les prix. Les tiers doivent exister avant les véhicules et franchises. Les taxes doivent être paramétrées avant la base facturation.


La suppression dans ce module

La plupart des entités utilisent la suppression douce : elles disparaissent des listes mais restent conservées pour l'historique et la comptabilité.

Si une entité est référencée par un document, la suppression est refusée avec le message « Impossible de supprimer cet élément : il est référencé par d'autres enregistrements ».

⚠️ Exceptions à connaître : les chauffeurs sont supprimés définitivement, et les produits et unités ne peuvent pas être supprimés.


1. Tiers

À quoi ça sert ?

Le tiers est l'acteur commercial central. Un même écran gère trois types, filtrés par le menu choisi :

  • Client — destinataire d'une vente.
  • Fournisseur — source d'un achat (notamment SIR, confrères).
  • Transporteur — assure les livraisons (rattaché aux véhicules).

Droits d'accès

ActionDroit requis
Lister, créer, modifier, supprimerCréer / modifier un tiers

Accès

Paramétrage → Tiers & Véhicule → Tiers → {Client | Fournisseur | Transporteur} → {Créer | Liste}

Créer un tiers

  1. Choisir le type dans le menu, puis Créer.

  2. Renseigner :

    Création d'un tiers client

    Identification :

    • Intitulé ⚑ — raison sociale
    • Code {type}(ex. « Code client »)unique
    • N° compte général — optionnel (compte du plan comptable)
    • N° compte {type}(ex. « N° compte client »)unique
    • Numéro CC — optionnel

    Coordonnées :

    • Siège social
    • Adresse, Téléphone, Code postal — optionnels
  3. (Optionnel) Ajouter des remises commerciales dans le tableau « Action commerciale » via le bouton Nouvelle ligne :

    • Produits ⚑, Remise (F.cfa) ⚑, Date d'effet ⚑, Date de fin, État (case)

    ⚠️ La section Action commerciale n'apparaît pas pour les transporteurs.

  4. Cliquer Enregistrer.

Modifier / Supprimer

  • Depuis la liste, action (⋮) → Modifier.
  • En édition, seules les remises actives s'affichent (les inactives restent conservées mais ne sont pas éditables).
  • La suppression est refusée si le tiers est référencé par des documents.

Cas particulier — Transporteur

Les transporteurs n'ont pas de remise commerciale. Le bloc « Action commerciale » est masqué dans le formulaire et dans la fiche détail.


2. Véhicules

À quoi ça sert ?

Référencer le parc logistique : tracteurs (têtes tractrices), citernes (remorques), et chauffeurs. Tous sont rattachés à un transporteur.

Prérequis

Au moins un tiers transporteur doit exister (§1).

Droits d'accès

ActionDroit requis
Lister, créer, modifier, supprimer (3 types)Créer / modifier les véhicules

Accès

Paramétrage → Tiers & Véhicule → Véhicules → {Tracteur | Citerne | Chauffeurs}

2.1 Tracteur

Champs : Immatriculation ⚑ (unique), Marque ⚑, N° chassis, Transporteur ⚑, Energie, Place assise, Couleur, P.T.A.C (Kg).

2.2 Citerne

Champs : Transporteur ⚑, Type véhicule ⚑ (Citerne ou Palettisé), Immatriculation ⚑ (unique), Capacité ⚑, Certificat jaugeage, Date validité certificat.

2.3 Chauffeur

Champs : Nom ⚑, Prénom(s) ⚑, Téléphone, Adresse, Transporteur ⚑.

Points d'attention

  • ⚠️ Suppression des chauffeurs définitive : une fois supprimé, le chauffeur disparaît définitivement. Vérifier qu'aucun document ne le référence avant de supprimer.
  • La liste des chauffeurs ne propose pas de bouton Supprimer (uniquement Modifier).

3. Prix & Taxes

Le sous-module Prix & Taxes gère les périodes tarifaires. Toutes les données sont valables sur une période (date début / date fin) et ne doivent pas se chevaucher pour un même produit.

Prérequis

Les produits doivent exister (§7).

Droits d'accès

ActionDroit requis
Gérer les prixCréer / modifier les prix
Gérer les taxesCréer / modifier les taxes

3.1 Prix carburant (Ex SIR / À la pompe)

Objectif — Définir, par produit carburant, le prix de cession (Ex SIR) ou le prix de vente au détail (à la pompe), valable sur une période.

Accès : Paramétrage → Prix & Taxes → Prix → Carburant → {Ex Sir | A la pompe}

Saisie des prix carburant

Champs (une ligne par produit/période) : Produits ⚑ (carburants), Date début ⚑, Date de fin, Prix (F.cfa) ⚑, État.

💡 Un seul écran sert à la création ET à la modification. Le formulaire est pré-rempli avec les lignes existantes, modifiables en place.

⚠️ Chevauchement interdit. Deux périodes ne peuvent pas se chevaucher pour un même produit. Les bornes contiguës sont autorisées (la fin d'une période peut être égale au début de la suivante).

3.2 Base de facturation

Objectif — Définir la base de calcul du prix de facturation pour chaque produit carburant : base taxable + base non taxable + base TVA.

Accès : Paramétrage → Prix & Taxes → Prix → Carburant → Base facturation

Champs : Produits ⚑, Date début ⚑, Date de fin, Base taxable, Base non taxable, Base TVA, Prix (F.cfa) (calculé automatiquement = somme des 3 bases — non saisissable), État.

⚠️ À l'enregistrement, les anciennes lignes actives absentes du formulaire sont supprimées : l'écran remplace intégralement la base active.

3.3 Prix autres (lubrifiants)

Objectif — Prix des produits hors carburant (lubrifiants, services).

Accès : Paramétrage → Prix & Taxes → Prix → Autres

Champs : identiques au prix carburant, mais filtrés sur les lubrifiants et services.

3.4 Taxes (Douane, TVA, RST, Bases taxables)

Objectif — Paramétrage des taux fiscaux par produit.

⚠️ Le libellé du menu est « Douane », mais cet écran gère en réalité toutes les taxes (TVA, RST, Douane, Bases taxables) sauf la TSU.

Accès : Paramétrage → Prix & Taxes → Taxes → Douane

Champs : Produits ⚑, Date début, Date de fin, Type de taxes(TVA, RST, Douane, Bases taxables), Valeur, État.

💡 L'unité affichée s'adapte : % pour TVA, RST, Douane — F.cfa pour Bases taxables.

3.5 Taxe spécifique unique (TSU)

Objectif — Paramétrage de la TSU par produit via le TUB (taxe unitaire de base) et le TUF (taxe unitaire fiscale).

Accès : Paramétrage → Prix & Taxes → Taxes → Taxe spécifique (TSU)

Champs : Produits ⚑, Date début ⚑, Date de fin, Type (forcé à TSU), TUB, TUF, État.

⚠️ Une seule TSU active par produit.


4. Station-service

À quoi ça sert ?

Référencer les stations-service du réseau. Sert de référentiel pour les ventes réseau et les déviations.

Prérequis

Au moins une société et une ville doivent exister.

Droits d'accès

ActionDroit requis
Lister, créer, modifier, supprimerConsulter les stations-service

⚠️ Malgré son libellé, ce droit autorise toutes les actions sur les stations : création, modification et suppression.

Accès

Paramétrage → Station-service → Listes stations-service

Créer une station

  1. Cliquer Nouveau depuis la liste.
  2. Renseigner :
    • Société
    • Nom station(unique)
    • Localité / Ville
    • Quartier, Téléphone (optionnels)
    • Code DGH(unique)
  3. Cliquer Enregistrer.

🔔 L'édition d'une station déclenche une notification réseau (pas la création).

Particularités

  • En édition, un formulaire plus complet expose le type (STATION ou DEPOT) et les comptes comptables par type de produit.

5. Franchise (Dépôt consommateur)

À quoi ça sert ?

Une franchise est un client disposant d'un dépôt de carburant alimenté par la Sodepci. Elle combine les données d'un client (tiers) avec des informations de dépôt (localisation, code DGH) et des remises commerciales dédiées.

Prérequis

  • Un tiers client doit exister.
  • Une ville doit exister.

Droits d'accès

ActionDroit requis
Lister, créer, modifier, supprimerCréer / modifier un dépôt consommateur

Accès

Paramétrage → Station-service → Franchise

Créer une franchise

  1. Cliquer Nouveau depuis la liste.
  2. Renseigner :
    • Client ⚑ — sélection du tiers client propriétaire
    • Intitulé ⚑, Code(unique), Code DGH(unique)
    • Adresse, Téléphone (optionnels)
    • Ville / Localité
    • Remises commerciales (optionnel, identique aux tiers)
  3. Cliquer Enregistrer.

Consulter les remises

Depuis la liste, le bouton Voir ouvre une fenêtre listant les remises F/Litre de la franchise.


6. Localités & tarifs

À quoi ça sert ?

  • Localités (villes) : référentiel géographique utilisé par les tiers, stations, franchises.
  • Tarifs : grille de transport (prix au kilomètre) entre une localité et un sous-dépôt, par type de produit. Alimente le calcul de péréquation.

Droits d'accès

ActionDroit requis
Lister, créer, modifier des tarifsGérer les localités & tarifs

6.1 Localité (Ville)

Accès : Paramétrage → Localités & tarifs → Localités → {Créer | Liste}

Champs : Nom ville, Code ville.

6.2 Tarif (Localisation)

Accès : Paramétrage → Localités & tarifs → Tarifs → {Créer | Liste}

Saisie d'un tarif de transport

Champs :

  • Ville
  • Date d'effet
  • Dépôt(uniquement les sous-dépôts)
  • Type produit(Carburant, Lubrifiant, Services)
  • Distance (Km)
  • Tarif (F.cfa)

⚙️ À la création, le tarif est automatiquement actif.

💡 Les tarifs alimentent le calcul de péréquation transport (visible dans l'État → Etat péréquation transport).


7. Produits & unités

À quoi ça sert ?

Référentiel des articles (carburants, lubrifiants, services) et des unités de mesure (litre, kilogramme…). Les produits sont référencés dans tous les documents et conditionnent le calcul des prix, taxes et mouvements de stock.

Prérequis

Pour les produits : au moins un site de stockage (dépôt) doit exister.

Droits d'accès

ActionDroit requis
Lister, créer, modifier des produitsGérer les produits
Lister, créer, modifier des unitésAucun droit spécifique

7.1 Produits

Accès : Paramétrage → Produits et unités → Produits

Champs :

  • Code(unique)
  • Référence (codification, optionnelle)
  • Désignation
  • Famille(Carburant, Lubrifiant, Services)
  • Poids (Kg) (conditionnel)
  • Groupe (conditionnel)
  • Site de stockage(sélection d'un ou plusieurs dépôts)

⚙️ À la création, les stocks sont initialisés à zéro pour chaque dépôt sélectionné. Tout mouvement ultérieur passe par les documents du module Stock (jamais par ce formulaire).

⚠️ La liste des produits ne propose pas de bouton Supprimer (uniquement Modifier).

7.2 Unités

Accès : Paramétrage → Produits et unités → Unités

Champs : Description ⚑, Codification ⚑.

⚠️ Aucune suppression possible : les unités sont référencées dans de nombreux documents.


Préparer un nouveau périmètre

Avant d'ouvrir un nouveau dépôt, client ou produit à l'exploitation, vérifier dans l'ordre :

  1. Tiers : créer le transporteur, puis les clients/fournisseurs concernés.
  2. Véhicules : créer tracteurs, citernes, chauffeurs (rattachés au transporteur).
  3. Produits : créer ou vérifier l'existence du produit, et son rattachement au dépôt.
  4. Prix & Taxes : vérifier qu'il existe un prix actif à la date du jour pour chaque produit carburant (Ex SIR et/ou à la pompe).
  5. Base facturation : vérifier qu'une base est active.
  6. Taxes : vérifier TVA, RST, Douane actives.
  7. TSU : vérifier qu'une TSU active existe par produit.
  8. Localités : créer la ville du dépôt, puis le tarif (ville + sous-dépôt).
  9. Station-service / Franchise : créer si applicable.

⚠️ Si une de ces étapes est manquante, la saisie d'un document échouera ou produira des montants erronés — pas toujours avec un message explicite.

Guide utilisateur Orbis Carburant — Sodepci