Aller au contenu
Criée

D’une exécution aux écritures

Mouvements titres, mouvements espèces, commissions et contre-passation : la conversion côté back-office.

Leçon 1210 min

À la fin de cette leçon

  • Traduire une exécution en mouvements titres et espèces qui portent sa référence
  • Vérifier que les mouvements de tous les comptes, commissions comprises, s’annulent
  • Corriger une exécution erronée par contre-passation, sans rien effacer
Dans cette leçon4

Le moteur s'arrête à l'objet Execution : un acheteur, un vendeur, un prix, une quantité. La leçon Du moteur à MIMS a montré la chaîne qui suit, écran par écran. Celle-ci descend d'un cran, dans le code du back-office : comment une exécution devient des mouvements, des commissions et des écritures, et comment on la défait sans rien effacer.

Ce que fixent les textes

Les négociations sont au comptant. L'ancien règlement exigeait que l'acheteur dispose des fonds et le vendeur des titres dès la passation de l'ordre (RG BVMAC 2008, art. 30). La BVMAC transmet les données des négociations au dépositaire central, pour garantir la livraison des titres et le paiement du prix (RG BVMAC 2025, art. 220 et 231). Dans MIMS, la validation par lot des exécutions fige la commission et produit mouvements titres, mouvements espèces et écritures ; une exécution validée peut être contre-passée, à deux personnes.

Mouvement

Écriture qui fait varier une position (mouvement titres) ou un compte espèces (mouvement espèces).

Une exécution, sept mouvements

Une exécution entre deux clients produit deux mouvements titres (l'acheteur reçoit, le vendeur livre), deux mouvements espèces pour le prix, et des commissions. Le type ci-dessous est un choix de conception du parcours ; chaque mouvement porte la référence de son exécution.

import type { Execution } from '@criee/marche'

type Mouvement =
  | { type: 'titres'; compte: string; quantite: number; execution: string }
  | { type: 'especes'; compte: string; montant: number; motif: 'prix' | 'commission'; execution: string }

interface Comptes { achat: string; vente: string; commissions: string }

function enMouvements(e: Execution, ref: string, c: Comptes, tauxPourDixMille: number): Mouvement[] {
  const montant = e.prix * e.quantite                                  // entier, en francs
  const commission = Math.round((montant * tauxPourDixMille) / 10_000) // arrondi : une décision
  return [
    { type: 'titres', compte: c.achat, quantite: +e.quantite, execution: ref },
    { type: 'titres', compte: c.vente, quantite: -e.quantite, execution: ref },
    { type: 'especes', compte: c.achat, montant: -montant, motif: 'prix', execution: ref },
    { type: 'especes', compte: c.vente, montant: +montant, motif: 'prix', execution: ref },
    { type: 'especes', compte: c.achat, montant: -commission, motif: 'commission', execution: ref },
    { type: 'especes', compte: c.vente, montant: -commission, motif: 'commission', execution: ref },
    { type: 'especes', compte: c.commissions, montant: 2 * commission, motif: 'commission', execution: ref },
  ]
}

En notant PP le prix, QQ la quantité et tt le taux de commission en pour dix mille, le montant MM et la commission CC prélevée de chaque côté valent, avant arrondi :

M=P×QC=M×t10 000M = P \times Q \qquad C = \frac{M \times t}{10\,000}

Sur l'ensemble des comptes, commissions comprises, les mouvements espèces s'annulent : −(M+C)+(M−C)+2C=0-(M + C) + (M - C) + 2C = 0.

Les taux de commission ne viennent d'aucune source de ce parcours : 0,5 % (50 pour dix mille) est un paramètre fictif. Dans la réalité, chaque société de bourse facture son propre client ; les deux commissions sont réunies ici dans un seul compte pour la lisibilité. Dans MIMS, la commission vient de la grille paramétrée et elle est figée à la validation.

Awa achète 30 titres à DidierFictif

La vente B-01 de Didier attend : 30 titres à 10 000. L'achat K-01 d'Awa arrive à 10 100. carnet.passer renvoie { achat: 'K-01', vente: 'B-01', prix: 10000, quantite: 30 }, au prix de l'ordre déjà présent.

  1. Montant : 10 000 × 30 = 300 000 francs.
  2. Commission, au taux fictif de 50 pour dix mille : 300 000 × 50 / 10 000 = 1 500 francs, de chaque côté.
  3. Titres : +30 chez Awa, −30 chez Didier. Somme : 0.
  4. Espèces : −300 000 − 1 500 chez Awa, +300 000 − 1 500 chez Didier, +3 000 en commissions. Somme : 0.

Déroulez la scène : les mouvements tombent dans les comptes, les soldes se repeignent, puis la contre-passation ramène tout au départ.

Une exécution devient des écritures1/6

Execution

{
achat: 'K-01'
vente: 'B-01'
prix: 10000 // 10 000
quantite: 30
}

Titres, Awa

0

Espèces, Awa

500 000

Titres, Didier

50

Espèces, Didier

0

Commissions

0

Execution

Une exécution arrive

Le moteur a apparié l’achat K-01 d’Awa et la vente B-01 de Didier (fictifs) : 30 titres à 10 000. Rien n’a encore bougé dans les comptes.

De mémoire : après commissions, la somme des mouvements espèces des seuls clients est-elle nulle ?

Défaire sans effacer

Une exécution validée à tort ne se supprime pas. On ajoute les mouvements inverses, avec la même référence d'exécution : les soldes reviennent à leur valeur de départ, et l'historique garde l'erreur et sa correction.

Contre-passation

Écriture inverse qui annule l'effet d'une écriture erronée sans l'effacer.

const contrePasser = (ms: Mouvement[]): Mouvement[] =>
  ms.map((m) => (m.type === 'titres' ? { ...m, quantite: -m.quantite } : { ...m, montant: -m.montant }))

// enMouvements(...) puis contrePasser(...) : 14 mouvements, toutes les sommes par compte à 0

C'est le même principe que le journal en ajout seul de la leçon Journaliser et rejouer une séance : on corrige en ajoutant.

Plus loin

L'exécution n'a pas d'identifiant. Le type Execution du moteur ne porte ni numéro ni horodatage. Or l'idempotence exige une clé : sans elle, importer deux fois le même fichier compte tout deux fois (le contrôle n° 7 de la leçon 9). La référence doit venir de l'extérieur, du marché ou de l'import, et accompagner chaque mouvement.

const integrees = new Set<string>()
function integrer(ref: string, ms: Mouvement[]): Mouvement[] {
  if (integrees.has(ref)) return []   // déjà comptée : on ne refait rien
  integrees.add(ref)
  return ms
}
integrer('EX-1', ms).length // 7
integrer('EX-1', ms).length // 0

L'arrondi des commissions. Sur 70 350 francs (7 titres à 10 050), 50 pour dix mille donnent 351,75. Math.round donne 352, Math.floor 351. Les deux choix sont défendables ; ce qui ne l'est pas, c'est de calculer en flottants et d'arrondir au moment d'afficher. Fixez la règle dans la spécification et dans un test, et gardez tous les montants en entiers.

Le prix moyen n'est pas un entier. Awa, servie pour 25 titres à 10 050 et 15 à 10 100, a payé 402 750 francs pour 40 titres : un prix moyen pondéré de 10 068,75. Stockez la quantité et le montant total, qui sont exacts, et dérivez le prix moyen à l'affichage. MIMS calcule ce prix moyen à la validation : un bon cas de test, avec des données qui ne tombent pas juste.

La date de règlement est un paramètre. Aucun texte trouvé ne fixe le délai de règlement-livraison à la BVMAC ; le Bulletin officiel de la cote calcule le coupon couru à J+3, ce qui n'est qu'un indice (BOC du 02/09/2026). Un mouvement porte une date de valeur calculée par un paramètre, jamais par une constante.

De mémoire, en reliant à la leçon sur la modélisation d'un ordre : jusqu'à quel montant prix × quantité reste-t-il exact en number, et que faire au-delà ?

À toi de jouer

Une exécution entre deux clients produit combien de mouvements titres ?

1Une exécution entre deux clients produit combien de mouvements titres ?

Une exécution validée se révèle fausse. Que fait le back-office ?

2Une exécution validée se révèle fausse. Que fait le back-office ?

Pourquoi chaque mouvement porte-t-il la référence de son exécution ?

3Pourquoi chaque mouvement porte-t-il la référence de son exécution ?

Le taux de commission de l'exemple, 0,5 %, est...

4Le taux de commission de l'exemple, 0,5 %, est...

Après commissions, quelle somme de mouvements espèces doit être nulle ?

5Après commissions, quelle somme de mouvements espèces doit être nulle ?

À lire ensuite : Règlement général de la BVMAC (2025)

Une question ? Posez-la à votre enseignant, ou à un assistant IA en lui donnant le titre de cette leçon.

Partager :WhatsAppLinkedIn

Pour aller plus loin