4 Commits
Author SHA1 Message Date
arcodangeandClaude Opus 5 c96deb5ad6 feat(erp): les deux comptes bancaires tombent au centime — reprise FAC004/FAC006, réparation FAC009, cashbacks
Suite de la réconciliation ouverte par la question de l'opérateur. Après ce
passage, l'ERP et la banque disent le même chiffre sur les deux comptes :
Qonto 2 013,30 EUR et Wise 11 863,85 EUR, écart 0,00.

CE QUI A DÉBLOQUÉ LE RESTE. L'opérateur a établi que KissMetrics n'a JAMAIS reçu
la moindre facture — le client payait le forfait de 2 500 USD sans pièce. Rien
ne s'opposait donc à corriger des factures qu'on croyait entre ses mains.

FAC004 et FAC006 portaient toutes deux 2 145,92 EUR, le même montant repris tel
quel d'un cycle à l'autre, alors que la banque a reçu 2 147,00 EUR le 29/05 et
2 195,97 EUR le 25/06 : 2 500 USD à chaque fois, au taux du jour du paiement.
51,13 EUR d'encaissement manquaient aux livres. Leurs notes qualifiaient déjà
l'écart d'« écart de change » — défendable tant qu'on ne pouvait pas toucher aux
factures ; plus vrai maintenant qu'on le peut. Une facture, un règlement, une
ligne bancaire, le même chiffre.

RÉPARATION DE FAC009. `PUT /invoices/{id}/lines/{lid}` n'est PAS un PATCH : tout
champ absent du corps est remis à zéro. La correction appliquée ce matin ne
passait que subprice, pu_ht, qty et desc — `product_type` est donc retombé de 1
(service) à 0 (produit), faisant de FAC009 la seule ligne du registre typée
« produit » dans une société qui ne vend que des prestations et facture hors UE
sous l'art. 259-1° du CGI. Rétabli.

C'est le juge pré-gate qui l'a vu, sur la répétition de FAC004 et FAC006 — où le
même appel avait en plus effacé `desc` ENTIÈREMENT. Premier finding de la
journée qui apporte quelque chose de réel, et il aurait envoyé au client deux
factures sans désignation. Les charges de ligne sont désormais complètes.

test/deleteInvoicePayment.ts. Corriger une facture encaissée suppose de refaire
son règlement, et l'API REST ne sait pas le supprimer : `PUT
/invoices/{id}/payments` ne met à jour que son NUMÉRO. Deux verrous dans
l'interface, consignés dans le fichier : tant que la facture est marquée payée
le lien de suppression est simplement ABSENT — pas d'erreur, rien — il faut
d'abord la rouvrir ; et la confirmation est une boîte MODALE jQuery dont les
boutons n'ont ni name ni value, si bien qu'un sélecteur sur input[type=submit]
ne trouve rien et que la suppression n'a pas lieu, silencieusement. Sans
--payment, le script retrouve le règlement sur la fiche : coder en dur un
identifiant relevé en bac à sable est une façon commode de supprimer le mauvais.

ABONNEMENT ANTHROPIC D'AOÛT. 90,00 EUR du 19/08, reçu 2330-6710-2536 arrivé dans
books@ le 24/08. Second abonnement à usage interne, distinct du budget IA client.

CASHBACKS WISE — compte 768. Wise parle de « remise », mais le montant suit le
SOLDE et non les frais : 0,19 EUR sur ~510 EUR en mars, 4,97 EUR sur ~9 700 EUR
en août, soit ~0,5-0,6 % l'an, stable. C'est la rémunération d'un solde, donc un
produit financier. Le seul frais Wise de l'exercice est le forfait de 50 EUR du
26/01, sans rapport. Ni 763, qui vise les revenus de créances commerciales, ni
764, réservé aux valeurs mobilières de placement : 768.

RISTOURNE QONTO — compte 627 au crédit. L'opération est typée `qonto_fee` par la
banque elle-même, côté crédit : une remise sur un service reçu vient en
diminution de la charge, elle ne crée pas un produit.

PIÈGE CATALOGUÉ. bank-match.sh continuera d'afficher ces sept écritures en
BANK-ONLY : il ne rapproche que les RÈGLEMENTS de factures et ignore les
paiements divers. Les voir listées ne veut donc PAS dire qu'elles manquent —
c'est écrit dans known-patterns.json, sans quoi le prochain agent les
ressaisirait.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
2026-08-24 13:10:34 +02:00
arcodangeandClaude Opus 5 b745fdcb43 feat(erp): encaissement KissMetrics du 17/08, deux échéances URSSAF, règlement des charges sociales
L'opérateur a demandé si le versement de la semaine passée avait été pris en
compte. Il ne l'était pas — et la réconciliation menée en réponse a fait sortir
trois autres trous.

L'ENCAISSEMENT. KissMetrics a viré 2 164,75 EUR le 17/08 (Wise, réf.
VENDOR:DEV), soit 2 500,00 USD au taux du jour : la part fixe du cycle M4. Le
mouvement n'était pas enregistré, si bien que FAC009 a été émise le matin même
au taux du 24/08 (2 140,45 EUR) alors que le contrat arrête le montant dû « au
taux du jour du règlement ». La facture était fausse de 24,30 EUR, et déjà
payée.

Le précédent commandait la méthode : FAC008 avait été libellée 2 185,00 EUR,
exactement la somme reçue le 20/07, même schéma de règlement anticipé. Sur
arbitrage de l'opérateur, FAC009 est repassée en brouillon, portée à
2 164,75 EUR, revalidée sous le même numéro et la même date, puis adossée au
virement. Sa note reprend la rédaction de FAC008.

Le juge a bloqué en relevant que `last_main_doc` était présent — donc, selon
lui, facture émise. Il confond PDF PRODUIT et facture TRANSMISE : le PDF avait
été produit deux heures plus tôt par l'agent lui-même pour assembler le dossier,
et le message d'envoi est un brouillon jamais envoyé. Mais il a raison sur la
conséquence, et c'est le seul de ses findings de la journée qui apporte quelque
chose : le PDF sur disque devenait faux. Il a été régénéré aussitôt. Son second
finding — `emetteur` null — tombe : le champ est null sur les huit lignes
d'encaissement Wise antérieures ; le renseigner sur la seule ligne d'août
romprait la permanence des méthodes au lieu de la servir.

LES DEUX ÉCHÉANCES URSSAF. 493,00 EUR prélevés le 22/05 et 1 215,00 EUR le
17/08 n'étaient enregistrés ni l'un ni l'autre. Créés comme charges sociales —
pas comme factures fournisseur : l'URSSAF n'est pas un fournisseur — puis
réglés depuis Qonto.

test/paySocialCharge.ts comble un trou du chemin gated : recordSocialCharge.ts
crée la charge et la laisse impayée, et rien n'enregistrait le règlement. Tant
qu'il manque, le mouvement bancaire reste orphelin et le solde de l'ERP diverge
de celui de la banque — c'est ce qui laissait ces deux échéances invisibles.
Dolibarr n'expose aucune route REST pour les charges sociales, donc le pipeline
ne peut pas porter l'opération ; le script garde ce qu'il peut de sa discipline.

Trois pièges consignés dans le fichier, dont un qui a coûté une fausse alerte :
NE PAS chercher « payée » dans la page — « ImPAYÉE » contient « payée ». Une
première version déclarait ÉCHEC sur un règlement qui venait d'aboutir, ce qui
pousse à rejouer, donc à créer un doublon. On lit le montant restant dû.

LE RUNBOOK disait 646. C'est faux depuis adc-009 : dans une SARL à l'IS, ce que
la société verse à l'URSSAF pour son gérant majoritaire est une charge de
personnel, donc 641. Corrigé, avec la mention explicite que toute version
portant 646 est périmée. Ajouté aussi ce que la fiche de charge confirme à
l'écran — « Code comptable: Inconnu » : le type de charge ne pilote PAS le
compte sur ce déploiement, contrairement à ce que le runbook laissait croire.

Enfin l'exemple `--period 2026` du runbook était invalide : le script découpe la
valeur comme une date ISO et produisait `undefined/undefined/2026`, ce qui fait
échouer la création sans message.

Reste au tableau, documenté et non traité ici : six cashbacks Wise (11,13 EUR),
un remboursement Qonto (5,22 EUR), l'abonnement Anthropic du 19/08 (90,00 EUR,
reçu pas encore arrivé), et deux encaissements client sous-enregistrés — FAC004
et FAC006, 51,13 EUR reçus de plus que ce que l'ERP porte.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
2026-08-24 11:23:35 +02:00
arcodangeandClaude Opus 5 4d26790504 feat(erp): corriger l'adresse électronique de la fiche société
L'en-tête de chaque facture portait `[email protected]` alors que
`static/config/company.json` porte `[email protected]`. La divergence
ne se voit nulle part dans l'ERP : elle ne s'est découverte qu'en relisant un PDF
destiné au client. Arbitrage de l'opérateur : l'adresse au nom de domaine de la
société est la bonne.

`GET /setup/company` répond 403 à tout scope agent (« open to admin users only »)
et aucune route REST n'écrit les constantes MAIN_INFO_SOCIETE_*. La fiche n'est
donc modifiable que par l'interface.

Deux pièges consignés dans le script. Le champ s'appelle simplement `mail` — pas
`MAIN_INFO_SOCIETE_MAIL`, malgré le nom de la constante qu'il alimente et malgré
la convention que suivent tous ses voisins du même formulaire. Et la page de
retour réaffiche la valeur soumise qu'elle ait été enregistrée ou non : le script
RECHARGE la page avant de vérifier.

Répété en bac à sable, puis appliqué en production. FAC009 et FAC010 régénérées.

FAC005, FAC007 et FAC008 gardent l'ancienne adresse, délibérément : elles ont été
émises sous celle-ci, et on ne réécrit pas un document daté pour le faire coller
à un état postérieur.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
2026-08-24 10:47:41 +02:00
arcodangeandClaude Opus 5 bcea21f96b feat(erp): cycle M4 KissMetrics, comblement des écarts bancaires, clause de pénalités rétablie
Deux passages gated en production, et l'outil qui manquait pour clore le dossier
client.

CYCLE M4 (2026-08-24-m4-et-ecarts). Cinq opérations : le tiers Anthropic PBC —
entité américaine, distincte d'Anthropic Ireland Limited — et sa facture de
90 EUR réglée le 19/07 ; le règlement Darnis de 262,20 EUR ; les deux factures
du cycle M4 (part fixe 2 500 USD → 2 140,45 EUR échéance 22/09, part différée
3 000 USD → 2 568,54 EUR échéance 23/11). Les trois écarts bancaires relevés
sont comblés ; Qonto tombe à 3 806,08 EUR.

Le juge pré-gate a bloqué : le règlement Darnis du 14/08 précède la facture
datée du 31/08. C'est un fait bancaire, pas une erreur de saisie — Darnis
facture en fin de mois — et adc-008 avait EXPRESSÉMENT prévu ce blocage et
autorisé le passage outre tracé. L'art. 289 du CGI qu'invoque le juge régit la
numérotation des factures ÉMISES, non l'ordre entre un paiement et sa facture ;
c'est la troisième fois de la session qu'il l'étend hors de son champ.

CLAUSE DE PÉNALITÉS (2026-08-24-clause-bilingue). Les factures M4 sont sorties
avec une clause AMPUTÉE : sans la traduction anglaise, sans la mention « Ces
stipulations sont des minima légaux d'ordre public auxquels il ne peut être
renoncé ». Détecté par le contrôle des mentions obligatoires sur les PDF —
avant tout envoi. La note publique est rétablie dans sa rédaction de référence,
à droit constant : aucun montant, aucune date, aucune ligne touchés.

Deux raisons de corriger plutôt que de laisser courir. La permanence des
méthodes (PCG art. 121-5, adc-011) : une clause légale identique doit être
rédigée identiquement, sans quoi la variation se lit comme une intention. Et le
fond : le destinataire est américain, c'est la version anglaise qui lui rend la
clause opposable en fait — et c'est sur elle que s'appuie la relance.

Le juge a bloqué là aussi, en supposant que la référence portait « ce montant ».
Il ne l'avait pas vérifié, et son propre residual risk demandait de le faire.
Vérification faite et consignée (02b-preuve-reference.txt) : FAC005 à FAC008
portent toutes « ce forfait », et la clause proposée leur est identique au
caractère près — 1283 car. Le finding était inversé.

test/buildInvoicePdf.ts. Valider une facture par l'API ne produit AUCUN PDF : le
fichier n'existe que si quelqu'un l'a demandé. `PUT /documents/builddoc` le
ferait mais répond 403 — ce droit n'est accordé à aucun scope agent. Le script
emprunte donc l'interface, puis relit le fichier par l'API : on ne croit pas la
page de retour, on vérifie que le PDF est déposé et lisible par un tiers.

Les deux juges post-gate passent sans dérive.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
2026-08-24 10:04:33 +02:00
27 changed files with 43 additions and 23871 deletions
@@ -4,7 +4,7 @@
"_match_rules": "Pattern matched case-insensitively as a regex against the bank label. Optional filters: bank (qonto|wise), side (credit|debit), amount_min, amount_max, type (Wise activity type). All present filters must match.",
"_classifications": {
"capital_deposit": "Apport en capital social. Dolibarr account 1013 (capital souscrit appelé versé).",
"social_charges": "URSSAF, retraite complémentaire, etc. Dolibarr compte 641, sous-compte dédié (la société prend en charge les cotisations personnelles de son gérant majoritaire : c'est un complément de rémunération). PAS 646, réservé à l'exploitant individuel et aux sociétés à l'IR. PAS 645x non plus, qui vise les cotisations sur salaires Arcodange n'a aucun salarié et l'opérateur n'est pas employeur. Voir adc-009.",
"social_charges": "URSSAF, retraite complémentaire, etc. Dolibarr compte 646 (cotisations personnelles du dirigeant TNS) — PAS 645x, réservé aux cotisations patronales sur salaires : Arcodange n'a aucun salarié.",
"ai_subscription": "Claude / Mistral / OpenAI / similar. Dolibarr account 6262 (frais télécom / abonnements logiciels).",
"bank_fee": "Plan bancaire, frais d'opération, refunds. Dolibarr account 627 (services bancaires).",
"internal_topup": "Solde Wise/Qonto rechargé pour couvrir un frais immédiat. Often nets out.",
@@ -25,7 +25,7 @@
"classification": "social_charges",
"bank": "qonto",
"side": "debit",
"note": "Cotisations sociales personnelles du gérant, appelées par échéancier (0/493/1215/1333 en 2026). Dolibarr : compte 641, sous-compte dédié — voir adc-009. Montants PROVISOIRES, assis sur un forfait début d'activité, régularisables après déclaration des revenus."
"note": "Cotisations sociales URSSAF (régime mensuel/trimestriel). Dolibarr: account 645100 (charges de sécurité sociale)."
},
{
"pattern": "MISTRAL\\.AI",
@@ -194,22 +194,6 @@ fi
# an earlier date, which is a numbering break. This bites whenever two documents
# of the same cycle are issued on different days (a deferred part issued after
# the next fixed part, for instance). Refuse rather than create the break.
#
# CUSTOMER INVOICES ONLY. L'article 289 impose une numérotation chronologique et
# continue aux factures que la société ÉMET. Il ne dit rien de la référence de
# classement que Dolibarr attribue aux factures qu'elle REÇOIT : le numéro qui
# fait foi pour celles-là est celui du fournisseur, porté par ref_supplier, et la
# séquence FAF suit l'ordre d'ENREGISTREMENT — c'est sa construction normale.
#
# Appliquer la garde aux deux registres produisait un faux positif systématique :
# la production porte déjà cinq ruptures dans la séquence FAF (FAF2026003 daté du
# 4 janvier suit FAF2026002 daté du 9), et zéro dans la séquence FAC. Toute
# facture fournisseur enregistrée après coup — le cas ordinaire, cf. adc-008 qui
# prescrit d'enregistrer à la date du document — se heurtait au refus et exigeait
# ARCO_ALLOW_BACKDATE. Une garde qu'on outrepasse par routine ne garde plus rien.
if [[ "${ENDPOINT}" != "/invoices" ]]; then
CHRONO_SKIP=1
fi
NEW_DATE="$(python3 -c "import json,sys; print(json.loads(sys.argv[1])['date'])" "${BODY}")"
LAST="$("${W}" GET "${ENDPOINT}?sortfield=t.rowid&sortorder=DESC&limit=1" 2>/dev/null \
| python3 -c "
@@ -220,7 +204,7 @@ try:
else: print('0|-')
except Exception: print('0|-')" 2>/dev/null || echo "0|-")"
LAST_DATE="${LAST%%|*}"; LAST_REF="${LAST##*|}"
if [[ -z "${CHRONO_SKIP:-}" ]] && [[ "${LAST_DATE}" =~ ^[0-9]+$ ]] && (( LAST_DATE > 0 )) && (( NEW_DATE < LAST_DATE )); then
if [[ "${LAST_DATE}" =~ ^[0-9]+$ ]] && (( LAST_DATE > 0 )) && (( NEW_DATE < LAST_DATE )); then
if [[ "${ARCO_ALLOW_BACKDATE:-}" != "I-UNDERSTAND-THIS-BREAKS-CHRONOLOGY" ]]; then
printf 'invoice-create.sh: REFUSED — chronology break.\n' >&2
printf ' new document dated %s, but %s is already issued at %s.\n' \
-79
View File
@@ -1,79 +0,0 @@
# Correspondance commerciale — le format maison
Le gabarit des lettres qu'Arcodange adresse à ses clients et prospects. Fixé le
24 août 2026 avec le dossier KissMetrics, et validé par l'opérateur : « on peut
se souvenir de ce format pour les communications avec KM et futurs
prospects/clients ».
## Produire une lettre
```bash
python3 correspondance/lettre.py corps.html sortie.pdf \
--titre "Contracts and invoices — cycles M1 to M4" \
--date "24 August 2026" --prenom Evan \
--destinataire "Evan Sforzo" --fonction "Chief Executive Officer" \
--societe "Kissmetrics Inc." \
--adresse "2850 34th Street North, 307 — St. Petersburg, Florida 33713 — United States" \
--copie "Hendrik Rootering" \
--pied "Arcodange × Kissmetrics Inc. — 24 August 2026"
```
`corps.html` ne porte que le corps — les `<h2>`, `<p>`, `<table>`, encadrés.
L'en-tête, le bloc destinataire, la signature et le pied viennent du gabarit.
Sans `--copie`, la ligne « cc » disparaît entièrement.
Le script vérifie le nombre de pages et proteste au-delà de deux : une lettre
d'affaires qui déborde ne se lit pas. Resserrer le CORPS, jamais la typographie.
## Les choix, et pourquoi
**Charter pour le texte, Optima pour les titres.** Charter a été dessinée par
Matthew Carter pour tenir le petit corps là où d'autres se délitent — elle reste
lisible à l'écran comme sur papier bon marché. Optima lui donne un contrepoint
humaniste sans raideur. Les deux sont incorporées au PDF : le rendu est le même
chez le destinataire, quelle que soit sa machine. Chiffres elzéviriens activés,
pour que les montants dans le texte s'alignent au lieu de faire des bâtons.
**Deux encadrés, deux usages.** Le gris (`.calme`) porte une question ou une
demande — elle ne doit pas se noyer dans un paragraphe. Le rouge sourd
(`.encart`) porte ce qui doit être lu même en diagonale. **Un seul par lettre** ;
deux, et plus rien ne ressort.
**Les tableaux portent un `<thead>`.** Sans lui, un tableau qui se coupe entre
deux pages perd son en-tête et devient illisible. Avec, il se répète.
**Les trois emblèmes 🏹💻🪽** viennent du site — *« Gabriel 🪽 Radureau, pour 🏹
réussir vos projets 💻 »*. L'arc et l'ange sont dans le nom lui-même. Ils
figurent en marque sous le mot-marque, et l'aile seule entre prénom et nom dans
la signature.
## Le piège des emblèmes
> [!IMPORTANT]
> **`weasyprint` ne sait pas rendre Apple Color Emoji.** C'est un format bitmap
> `sbix` qu'il ignore : les trois emblèmes sortent en carrés vides, sans erreur
> ni avertissement. Vérifié le 24/08/2026.
D'où `emblemes/*.png`, rendus une fois pour toutes par `test/emoji2png.ts`, qui
passe par Chromium — lui lit la police système. Pour les régénérer ou en ajouter :
```bash
cd test && deno run -A emoji2png.ts ../correspondance/emblemes 🏹 💻 🪽
```
Les PNG sont incorporés en base64 **à la génération**, pas dans le gabarit : un
gabarit de 400 Ko dont 97 % de charabia ne se relit pas. Le PDF produit, lui,
reste autonome.
## Ce que le format ne fait pas
Il ne remplace pas le message d'accompagnement. La lettre est le document qu'on
joint ; le mot sur Slack ou par courriel reste séparé, plus court, et dit
pourquoi on écrit. Les deux doivent rester d'accord — vérifier que la lettre ne
mentionne aucune pièce absente de l'envoi.
## Exemple de référence
`1_DOCUMENTS/prospects/KissMetrics/relances/2026-08-24_lettre_KM.html` — la
lettre du 24/08/2026, dont ce gabarit est extrait. Elle se régénère à
l'identique, au mot près, ce qui est le test du gabarit.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 108 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 166 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

-96
View File
@@ -1,96 +0,0 @@
#!/usr/bin/env python3
"""Produit une lettre commerciale Arcodange en PDF, depuis le gabarit maison.
POURQUOI CE SCRIPT EXISTE. Deux choses ne se font pas à la main sans se tromper.
1. `weasyprint` NE SAIT PAS rendre Apple Color Emoji : c'est un format bitmap
`sbix` qu'il ignore, et les trois emblèmes 🏹💻🪽 sortent en carrés vides.
Il faut les incorporer en images. Elles sont ici en PNG, rendues une fois
pour toutes par `test/emoji2png.ts` (Chromium, lui, lit la police système).
2. Un gabarit qui porterait ces images en base64 pèserait 400 Ko dont 97 % de
charabia. On les garde en fichiers et on les incorpore À LA GÉNÉRATION,
pour que le gabarit reste relisible et que le PDF reste autonome.
Usage :
python3 correspondance/lettre.py corps.html sortie.pdf \
--titre "Contracts and invoices — cycles M1 to M4" \
--date "24 August 2026" --prenom Evan \
--destinataire "Evan Sforzo" --fonction "Chief Executive Officer" \
--societe "Kissmetrics Inc." \
--adresse "2850 34th Street North, 307 — St. Petersburg, Florida 33713 — United States" \
--copie "Hendrik Rootering" \
--pied "Arcodange × Kissmetrics Inc. — 24 August 2026"
`corps.html` ne contient que le corps : les <h2>, <p>, <table>, encadrés. L'en-tête,
le bloc destinataire, la signature et le pied de page viennent du gabarit.
Sans `--copie`, la ligne « cc » disparaît.
"""
import argparse, base64, pathlib, re, subprocess, sys
ICI = pathlib.Path(__file__).parent
GABARIT = ICI / "lettre.template.html"
EMBLEMES = {"ARC": "arc.png", "LAPTOP": "laptop.png", "AILE": "aile.png"}
def data_uri(chemin: pathlib.Path) -> str:
return "data:image/png;base64," + base64.b64encode(chemin.read_bytes()).decode()
def main() -> int:
a = argparse.ArgumentParser(description=__doc__,
formatter_class=argparse.RawDescriptionHelpFormatter)
a.add_argument("corps"); a.add_argument("sortie")
for champ in ("titre", "date", "prenom", "destinataire", "fonction",
"societe", "adresse", "pied"):
a.add_argument(f"--{champ}", required=True)
a.add_argument("--copie", default="")
a.add_argument("--garder-html", action="store_true",
help="conserve le HTML intermédiaire à côté du PDF")
o = a.parse_args()
html = GABARIT.read_text(encoding="utf-8")
for cle, fichier in EMBLEMES.items():
p = ICI / "emblemes" / fichier
if not p.exists():
print(f"emblème manquant : {p}\n"
f" le régénérer : cd test && deno run -A emoji2png.ts <dossier> 🏹 💻 🪽",
file=sys.stderr)
return 2
html = html.replace("{{" + cle + "}}", data_uri(p))
for cle, val in (("TITRE", o.titre), ("DATE", o.date), ("PRENOM", o.prenom),
("DESTINATAIRE", o.destinataire), ("FONCTION", o.fonction),
("SOCIETE", o.societe), ("ADRESSE", o.adresse),
("COPIE", o.copie), ("PIED", o.pied)):
html = html.replace("{{" + cle + "}}", val)
# Pas de destinataire en copie : on retire la ligne entière, pas seulement
# son contenu, sinon il reste un « cc » orphelin.
if not o.copie:
html = re.sub(r'<br>\s*<span class="a"[^>]*>cc</span>\s*&nbsp;\s*', "", html)
# Le corps remplace tout ce qui sépare le sous-titre de la signature.
corps = pathlib.Path(o.corps).read_text(encoding="utf-8")
deb = html.index("<h1>")
fin = html.index('<div class="signature">')
entete = html[deb:html.index("<p>Dear ")]
html = html[:deb] + entete + f"<p>Dear {o.prenom},</p>\n\n" + corps + "\n\n" + html[fin:]
tmp = pathlib.Path(o.sortie).with_suffix(".html")
tmp.write_text(html, encoding="utf-8")
r = subprocess.run(["weasyprint", str(tmp), o.sortie])
if r.returncode == 0 and not o.garder_html:
tmp.unlink()
if r.returncode == 0:
pages = subprocess.run(["pdfinfo", o.sortie], capture_output=True, text=True).stdout
n = next((l.split()[1] for l in pages.splitlines() if l.startswith("Pages")), "?")
print(f"ok — {o.sortie} ({n} page(s))")
if n not in ("1", "2"):
print(" ATTENTION : au-delà de deux pages, une lettre d'affaires se lit mal. "
"Resserrer le corps plutôt que la typographie.", file=sys.stderr)
return r.returncode
if __name__ == "__main__":
raise SystemExit(main())
-102
View File
@@ -1,102 +0,0 @@
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8">
<title>{{TITRE}} — Arcodange</title>
<style>
@page { size: A4; margin: 15mm 18mm 13mm 18mm;
@bottom-center { content: "{{PIED}} — page " counter(page) " / " counter(pages);
font-family: "Optima", "Seravek", sans-serif; font-size: 7.8pt;
letter-spacing: .4px; color: #8a8a8a; } }
body { font-family: "Charter", "Bitstream Charter", "Iowan Old Style", Georgia, serif;
font-size: 9.9pt; line-height: 1.44; color: #14161a;
font-feature-settings: "kern" 1, "liga" 1, "onum" 1; }
.entete { border-bottom: 1.5px solid #14161a; padding-bottom: 8px; margin-bottom: 16px;
display: flex; justify-content: space-between; align-items: flex-end; }
.entete .nom { font-family: "Optima", "Seravek", sans-serif; font-size: 17pt;
font-weight: 600; letter-spacing: 3.5px; }
.marque { margin-top: 7px; }
.marque img { height: 16px; vertical-align: -3px; margin-right: 7px; }
.signature .qui img { height: 13px; vertical-align: -2px; margin: 0 1px; }
.entete .mentions { font-family: "Optima", "Seravek", sans-serif; font-size: 8pt; color: #4a4a4a; line-height: 1.45; text-align: right; }
.dest { margin-bottom: 16px; font-size: 10pt; }
.dest .a { font-family: "Optima", "Seravek", sans-serif; color: #8a8a8a; font-size: 7.8pt; letter-spacing: .6px; text-transform: uppercase; }
h1 { font-family: "Optima", "Seravek", sans-serif; font-size: 14pt; font-weight: 600;
margin: 0 0 3px; letter-spacing: .2px; }
h1 + .sous { font-style: italic; color: #4a4a4a; margin: 0 0 16px; font-size: 10pt; }
h2 { font-family: "Optima", "Seravek", sans-serif; font-size: 10.2pt; font-weight: 600;
page-break-after: avoid; margin: 14px 0 5px; padding-bottom: 3px; border-bottom: 1px solid #d8d8d8;
letter-spacing: .4px; }
p { margin: 0 0 7px; text-align: justify; }
strong { font-weight: bold; }
em { font-style: italic; }
table { width: 100%; border-collapse: collapse; margin: 9px 0 10px; font-size: 8.7pt; }
th, td { border-bottom: 1px solid #dcdcdc; padding: 3.5px 8px; text-align: left; }
thead { display: table-header-group; }
th { font-family: "Optima", "Seravek", sans-serif;
background: #f4f4f2; border-bottom: 1px solid #999; font-weight: 600; font-size: 8.2pt;
letter-spacing: .5px; text-transform: uppercase; color: #333; }
td.n { text-align: right; white-space: nowrap; }
tr.due td { background: #fdf6f2; font-weight: bold; }
.encart { border-left: 3px solid #8a1c1c; background: #fbf6f5; padding: 8px 12px; margin: 11px 0;
font-size: 9.4pt; }
.calme { border-left: 3px solid #b8b8b0; background: #f8f8f6; padding: 8px 12px; margin: 11px 0;
font-size: 9.4pt; }
.signature { margin-top: 17px; page-break-inside: avoid; }
.signature .qui { font-family: "Optima", "Seravek", sans-serif; font-weight: 600; font-size: 11pt; }
.signature .role { font-family: "Optima", "Seravek", sans-serif; font-size: 9pt; color: #555; }
</style></head><body>
<div class="entete">
<div><div class="nom">ARCODANGE</div>
<div class="marque"><img src="{{ARC}}" alt=""><img src="{{LAPTOP}}" alt=""><img src="{{AILE}}" alt=""></div></div>
<div class="mentions">
SARL au capital de 1 000 € — SIREN 999 657 455 R.C.S. Évry<br>
73 boulevard de l'Yerres, 91000 Évry-Courcouronnes, France<br>
VAT FR00 999 657 455 — [email protected]
</div>
</div>
<div class="dest">
<span class="a">To</span><br>
<strong>{{DESTINATAIRE}}</strong> — {{FONCTION}}, {{SOCIETE}}<br>
{{ADRESSE}}<br>
<span class="a" style="font-size:7.4pt">cc</span> &nbsp;{{COPIE}}
</div>
<h1>{{TITRE}}</h1>
<p class="sous">{{DATE}}</p>
<p>Dear {{PRENOM}},</p>
<!-- ═══ CORPS ═══════════════════════════════════════════════════════════════
Le contenu, et rien d'autre, change d'une lettre à l'autre. Ce qui suit
est l'exemple du 24/08/2026 (dossier KissMetrics), gardé pour montrer les
éléments disponibles. Le remplacer intégralement.
<h2>1 — Titre de section</h2> numérotées, c'est une lettre d'affaires
<p></p>
<div class="calme"></div> encadré gris : une question, une demande
<div class="encart"></div> encadré rouge sourd : ce qui doit être vu
<table></table> <thead> obligatoire : l'en-tête se répète
<tr class="due"></tr> ligne mise en avant dans un tableau
════════════════════════════════════════════════════════════════════════════ -->
<h2>1 — Une section</h2>
<p>Corps de texte en Charter. Les <strong>montants</strong> et les points qui
portent la décision se mettent en gras ; les citations en <em>italique</em>.</p>
<div class="calme">
<p style="margin:0"><strong>Une question posée franchement</strong> se met dans
un encadré gris — elle ne doit pas se noyer dans un paragraphe.</p>
</div>
<div class="encart">
<p style="margin:0">L'encadré rouge sourd est réservé à ce qui doit être lu
même en diagonale. <strong>Un par lettre, pas deux.</strong></p>
</div>
<div class="signature">
<p class="qui">Gabriel <img src="{{AILE}}" alt=""> Radureau</p>
<p class="role">Gérant — Arcodange</p>
</div>
</body></html>
File diff suppressed because it is too large Load Diff
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T13:04:32+00:00",
"stage": "pre",
"runtime": "mistral",
"model": "vibe -p (mistral)",
"prompt_sha256": "6fc0e33db64e27fe0bb706c44256fc9203575cf731d05f6d0903f91a7787363d",
"verdict": "BLOCK",
"response": "VERDICT: BLOCK\nREASON: The title claims invoices are \"passing to dollars,\" but they were already labeled in USD; the change-set only rewrites notes and descriptions.\nFINDINGS:\n- Title-scope mismatch: change-set updates notes/descriptions/revalidates, but does not change currency from EUR to USD.\nRESIDUAL RISK:\n- Confirm in production that multicurrency is fully enabled so the USD fields are treated as the authoritative amounts."
}
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T13:05:26+00:00",
"decision": "approved",
"by": "Gabriel Radureau — arbitrage explicite en session du 2026-08-24 : « Maintenant, sur les quatre factures non réglées », après avoir demandé « on ne peut pas emettre de facture en dollars ? ». Approbation portée par l'agent sur cet arbitrage nommé. LE FINDING DU JUGE EST FONDÉ ET ACCEPTÉ : le titre déborde du contenu. Le passage en devise proprement dit est fait AVANT ce change-set par test/setInvoiceCurrency.ts, parce que l'API REST accepte multicurrency_code et répond 200 sans rien appliquer ; le change-set ne porte que la suite — notes réécrites, désignations nettoyées, revalidation, échéances reposées. Le rationale le dit déjà explicitement. Le titre n'est pas rectifié pour ne pas rompre l'empreinte du manifeste sur laquelle ce gate est scellé ; l'imprécision est consignée ici. SON RESIDUAL RISK EST HONORÉ : la multidevise est vérifiée active en production, EUR et USD déclarés au dictionnaire. La répétition démontre en outre que le taux du dictionnaire est sans incidence — il valait 1,14416 en bac à sable, le changement de code s'en est servi, et la réécriture de la ligne a ramené la contre-valeur euro à l'euro près.",
"manifest_digest": "b34b23f6b8703758",
"judge_verdict": "BLOCK",
"override_of_judge": true,
"override_of_failed_rehearsal": false
}
File diff suppressed because it is too large Load Diff
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T13:11:50+00:00",
"stage": "post",
"runtime": "mistral",
"model": "vibe -p (mistral)",
"prompt_sha256": "e28f05a44b61b0061c0cf4566d379338be2062cee228dc945b57997c16615615",
"verdict": "PASS",
"response": "VERDICT: PASS\nREASON: All substantive fields (amounts, currency, dates, states, notes, line descriptions) match exactly between sandbox and production.\nDRIFT:\n- none\nFOLLOW-UP:\n- none"
}
@@ -1,194 +0,0 @@
{
"title": "Les quatre factures non réglées passent en dollars — le montant affiché devient le montant dû",
"rationale": "DÉFAUT CORRIGÉ. Les factures étaient libellées en euros pour un prix contractuel en dollars, avec une contre-valeur figée au taux du jour d'émission. Leur propre note le reconnaissait : « le montant effectivement dû en euros sera arrêté au taux du jour du règlement ». Une facture dont le montant affiché n'est pas le montant dû est bancale — et coûteuse : FAC004, FAC006 et FAC009 ont dû être reprises le 24/08 parce que leur contre-valeur avait été figée au mauvais taux.\n\nLe client paie d'ailleurs EN DOLLARS : les euros reçus varient de 2 147,00 à 2 195,97 pour une prestation à prix fixe, ce qui est la signature d'un virement en devise converti à l'arrivée par Wise.\n\nDROIT. Une facture peut être libellée dans toute monnaie (CGI art. 289, II ; directive 2006/112, art. 230) ; seule la TVA à payer doit être déterminée en euros, et il n'y en a pas ici — autoliquidation par un preneur hors UE (CGI art. 259, 1° et 283-2). Les LIVRES restent tenus en euros (C. com. art. L.123-22) : la contre-valeur inscrite ne bouge pas d'un centime.\n\nPÉRIMÈTRE. Les quatre factures NON RÉGLÉES seulement — FAC005, FAC007, FAC010, FAC011. Aucune n'a été transmise au client. Les quatre réglées gardent leur montant en euros, qui est exactement ce qui a été encaissé : chaque facture dit ainsi sa propre vérité, et rien de déjà rapproché avec la banque ne bouge.\n\nLe passage en devise proprement dit a été fait au préalable par test/setInvoiceCurrency.ts — l'API REST accepte multicurrency_code et répond 200 sans rien appliquer. Ce change-set ne porte que ce qui suit : notes réécrites, désignations nettoyées, revalidation, échéances reposées.\n\nCHANGEMENT DE MÉTHODE au sens d'adc-011 : il est daté, motivé, et s'applique à toutes les factures émises à compter de ce jour.",
"observe": [
"/invoices/15",
"/invoices/17",
"/invoices/20",
"/invoices/21"
],
"ops": [
{
"label": "FAC005 — note publique réécrite : la facture est en dollars, plus de contre-valeur indicative",
"api": {
"method": "PUT",
"path": "/invoices/15",
"body": {
"note_public": "PART DIFFÉRÉE DU CYCLE M1 — contrat cadre du 23/04/2026 (art. 6) et son avenant (art. 2 et 4).\nFACTURE LIBELLÉE EN DOLLARS DES ÉTATS-UNIS. Le montant dû est de 3 000,00 USD — le montant contractuel lui-même, et non une contre-valeur. Une facture peut être libellée dans toute monnaie (CGI art. 289, II ; directive 2006/112, art. 230) ; seule la TVA à payer devrait être exprimée en euros, et il n'y en a pas ici — autoliquidation par un preneur établi hors de l'Union européenne (CGI art. 259, 1° et 283-2).\nLa contre-valeur de 2 575,11 € portée aux livres (taux de 1,164992 USD pour 1 EUR retenu à l'émission) n'a qu'une portée comptable interne : les documents comptables de la société sont tenus en euros (C. com. art. L.123-22). L'écart entre cette contre-valeur et les euros effectivement encaissés sera constaté en écart de change.\nLe différé de trois mois est une modalité de PRIX convenue au contrat, non un délai de paiement accordé après facturation — l'art. L.441-10 I n'est donc pas en cause.\nPériode d'exécution : 23/04/2026 au 23/05/2026. Échéance : 23/08/2026.\nPÉNALITÉS DE RETARD — En cas de retard de paiement, sont automatiquement dues, sans rappel préalable : (i) des pénalités de retard calculées au taux d'intérêt appliqué par la Banque centrale européenne à son opération de refinancement la plus récente, majoré de 10 points de pourcentage (art. L.441-10 II du Code de commerce) — soit 12,15 % l'an au 1er semestre 2026 et 12,40 % l'an au 2e semestre 2026 ; (ii) une indemnité forfaitaire pour frais de recouvrement de quarante euros (40 €) par facture impayée (art. L.441-10 III du Code de commerce et décret n° 2012-1115) ; (iii) une indemnisation complémentaire sur justification documentée lorsque les frais de recouvrement exposés sont supérieurs à ce forfait. Aucun escompte n'est accordé en cas de paiement anticipé. Ces stipulations sont des minima légaux d'ordre public auxquels il ne peut être renoncé. / LATE PAYMENT — automatically due without prior reminder: (i) interest at the ECB refinancing rate plus 10 percentage points (Art. L.441-10 II French Commercial Code) — 12.15 % p.a. in H1 2026, 12.40 % p.a. in H2 2026; (ii) a fixed recovery indemnity of forty euros (€40) per unpaid invoice (Art. L.441-10 III and Decree no. 2012-1115); (iii) further indemnification on documented justification. No early-payment discount."
}
}
},
{
"label": "FAC005 — revalider (même numéro, même date d'émission)",
"api": {
"method": "POST",
"path": "/invoices/15/validate",
"body": {
"notrigger": 0
}
}
},
{
"label": "FAC005 — échéance au 23/08/2026, à reposer après validation",
"api": {
"method": "PUT",
"path": "/invoices/15",
"body": {
"date_lim_reglement": 1787479200
}
}
},
{
"label": "FAC007 — note publique réécrite : la facture est en dollars, plus de contre-valeur indicative",
"api": {
"method": "PUT",
"path": "/invoices/17",
"body": {
"note_public": "PART DIFFÉRÉE DU CYCLE M2 — contrat cadre du 23/04/2026 (art. 6) et son avenant (art. 2 et 4).\nFACTURE LIBELLÉE EN DOLLARS DES ÉTATS-UNIS. Le montant dû est de 3 000,00 USD — le montant contractuel lui-même, et non une contre-valeur. Une facture peut être libellée dans toute monnaie (CGI art. 289, II ; directive 2006/112, art. 230) ; seule la TVA à payer devrait être exprimée en euros, et il n'y en a pas ici — autoliquidation par un preneur établi hors de l'Union européenne (CGI art. 259, 1° et 283-2).\nLa contre-valeur de 2 575,11 € portée aux livres (taux de 1,164992 USD pour 1 EUR retenu à l'émission) n'a qu'une portée comptable interne : les documents comptables de la société sont tenus en euros (C. com. art. L.123-22). L'écart entre cette contre-valeur et les euros effectivement encaissés sera constaté en écart de change.\nLe différé de trois mois est une modalité de PRIX convenue au contrat, non un délai de paiement accordé après facturation — l'art. L.441-10 I n'est donc pas en cause.\nPériode d'exécution : 23/05/2026 au 23/06/2026. Échéance : 23/09/2026.\nPÉNALITÉS DE RETARD — En cas de retard de paiement, sont automatiquement dues, sans rappel préalable : (i) des pénalités de retard calculées au taux d'intérêt appliqué par la Banque centrale européenne à son opération de refinancement la plus récente, majoré de 10 points de pourcentage (art. L.441-10 II du Code de commerce) — soit 12,15 % l'an au 1er semestre 2026 et 12,40 % l'an au 2e semestre 2026 ; (ii) une indemnité forfaitaire pour frais de recouvrement de quarante euros (40 €) par facture impayée (art. L.441-10 III du Code de commerce et décret n° 2012-1115) ; (iii) une indemnisation complémentaire sur justification documentée lorsque les frais de recouvrement exposés sont supérieurs à ce forfait. Aucun escompte n'est accordé en cas de paiement anticipé. Ces stipulations sont des minima légaux d'ordre public auxquels il ne peut être renoncé. / LATE PAYMENT — automatically due without prior reminder: (i) interest at the ECB refinancing rate plus 10 percentage points (Art. L.441-10 II French Commercial Code) — 12.15 % p.a. in H1 2026, 12.40 % p.a. in H2 2026; (ii) a fixed recovery indemnity of forty euros (€40) per unpaid invoice (Art. L.441-10 III and Decree no. 2012-1115); (iii) further indemnification on documented justification. No early-payment discount."
}
}
},
{
"label": "FAC007 — revalider (même numéro, même date d'émission)",
"api": {
"method": "POST",
"path": "/invoices/17/validate",
"body": {
"notrigger": 0
}
}
},
{
"label": "FAC007 — échéance au 23/09/2026, à reposer après validation",
"api": {
"method": "PUT",
"path": "/invoices/17",
"body": {
"date_lim_reglement": 1790157600
}
}
},
{
"label": "FAC011 — note publique réécrite : la facture est en dollars, plus de contre-valeur indicative",
"api": {
"method": "PUT",
"path": "/invoices/21",
"body": {
"note_public": "PART DIFFÉRÉE DU CYCLE M3 — contrat cadre du 23/04/2026 (art. 6) et son avenant (art. 2 et 4).\nFACTURE LIBELLÉE EN DOLLARS DES ÉTATS-UNIS. Le montant dû est de 3 000,00 USD — le montant contractuel lui-même, et non une contre-valeur. Une facture peut être libellée dans toute monnaie (CGI art. 289, II ; directive 2006/112, art. 230) ; seule la TVA à payer devrait être exprimée en euros, et il n'y en a pas ici — autoliquidation par un preneur établi hors de l'Union européenne (CGI art. 259, 1° et 283-2).\nLa contre-valeur de 2 568,54 € portée aux livres (taux de 1,167978 USD pour 1 EUR retenu à l'émission) n'a qu'une portée comptable interne : les documents comptables de la société sont tenus en euros (C. com. art. L.123-22). L'écart entre cette contre-valeur et les euros effectivement encaissés sera constaté en écart de change.\nÉMISSION TARDIVE, ASSUMÉE COMME TELLE : la part différée du cycle M3 aurait dû être émise le 23/07/2026, en même temps que sa part fixe (FAC008). Elle ne l'a pas été. La facture pro forma PR2607-0001, remise au client en juillet, annonçait son émission au 24/08/2026 — c'est la date retenue, et la numérotation reste ainsi chronologique au sens de l'article 289 du CGI. L'échéance, elle, n'est pas décalée : elle reste au 23/10/2026, soit trois mois après la fin du cycle M3, comme le contrat le prévoit.\nLe différé de trois mois est une modalité de PRIX convenue au contrat, non un délai de paiement accordé après facturation — l'art. L.441-10 I n'est donc pas en cause.\nPériode d'exécution : 23/06/2026 au 23/07/2026. Échéance : 23/10/2026.\nPÉNALITÉS DE RETARD — En cas de retard de paiement, sont automatiquement dues, sans rappel préalable : (i) des pénalités de retard calculées au taux d'intérêt appliqué par la Banque centrale européenne à son opération de refinancement la plus récente, majoré de 10 points de pourcentage (art. L.441-10 II du Code de commerce) — soit 12,15 % l'an au 1er semestre 2026 et 12,40 % l'an au 2e semestre 2026 ; (ii) une indemnité forfaitaire pour frais de recouvrement de quarante euros (40 €) par facture impayée (art. L.441-10 III du Code de commerce et décret n° 2012-1115) ; (iii) une indemnisation complémentaire sur justification documentée lorsque les frais de recouvrement exposés sont supérieurs à ce forfait. Aucun escompte n'est accordé en cas de paiement anticipé. Ces stipulations sont des minima légaux d'ordre public auxquels il ne peut être renoncé. / LATE PAYMENT — automatically due without prior reminder: (i) interest at the ECB refinancing rate plus 10 percentage points (Art. L.441-10 II French Commercial Code) — 12.15 % p.a. in H1 2026, 12.40 % p.a. in H2 2026; (ii) a fixed recovery indemnity of forty euros (€40) per unpaid invoice (Art. L.441-10 III and Decree no. 2012-1115); (iii) further indemnification on documented justification. No early-payment discount."
}
}
},
{
"label": "FAC011 — désignation : retirer la conversion en euros, devenue sans objet",
"api": {
"method": "PUT",
"path": "/invoices/21/lines/21",
"body": {
"desc": "Conseil et accompagnement infrastructure cloud — Cycle M3 (part différée) — période d'exécution du 23/06/2026 au 23/07/2026. Échéance 23/10/2026. Montant contractuel 3 000,00 USD.\nPrestation de services au sens des articles 259, 1° et 283-2 du CGI. TVA française non applicable — preneur assujetti établi hors de l'Union européenne (États-Unis).",
"description": "Conseil et accompagnement infrastructure cloud — Cycle M3 (part différée) — période d'exécution du 23/06/2026 au 23/07/2026. Échéance 23/10/2026. Montant contractuel 3 000,00 USD.\nPrestation de services au sens des articles 259, 1° et 283-2 du CGI. TVA française non applicable — preneur assujetti établi hors de l'Union européenne (États-Unis).",
"subprice": "2568.54",
"pu_ht": "2568.54",
"multicurrency_subprice": "3000.00",
"qty": "1",
"product_type": "1",
"tva_tx": "0.0000",
"remise_percent": "0",
"localtax1_tx": "0.0000",
"localtax2_tx": "0.0000",
"info_bits": "0",
"special_code": "0",
"rang": "0",
"situation_percent": "100",
"fk_warehouse": "0",
"pa_ht": "0.00000000"
}
}
},
{
"label": "FAC011 — revalider (même numéro, même date d'émission)",
"api": {
"method": "POST",
"path": "/invoices/21/validate",
"body": {
"notrigger": 0
}
}
},
{
"label": "FAC011 — échéance au 23/10/2026, à reposer après validation",
"api": {
"method": "PUT",
"path": "/invoices/21",
"body": {
"date_lim_reglement": 1792749600
}
}
},
{
"label": "FAC010 — note publique réécrite : la facture est en dollars, plus de contre-valeur indicative",
"api": {
"method": "PUT",
"path": "/invoices/20",
"body": {
"note_public": "PART DIFFÉRÉE DU CYCLE M4 — contrat cadre du 23/04/2026 (art. 6) et son avenant (art. 2 et 4).\nFACTURE LIBELLÉE EN DOLLARS DES ÉTATS-UNIS. Le montant dû est de 3 000,00 USD — le montant contractuel lui-même, et non une contre-valeur. Une facture peut être libellée dans toute monnaie (CGI art. 289, II ; directive 2006/112, art. 230) ; seule la TVA à payer devrait être exprimée en euros, et il n'y en a pas ici — autoliquidation par un preneur établi hors de l'Union européenne (CGI art. 259, 1° et 283-2).\nLa contre-valeur de 2 568,54 € portée aux livres (taux de 1,167978 USD pour 1 EUR retenu à l'émission) n'a qu'une portée comptable interne : les documents comptables de la société sont tenus en euros (C. com. art. L.123-22). L'écart entre cette contre-valeur et les euros effectivement encaissés sera constaté en écart de change.\nLe différé de trois mois est une modalité de PRIX convenue au contrat, non un délai de paiement accordé après facturation — l'art. L.441-10 I n'est donc pas en cause.\nPériode d'exécution : 23/07/2026 au 23/08/2026. Échéance : 23/11/2026.\nPÉNALITÉS DE RETARD — En cas de retard de paiement, sont automatiquement dues, sans rappel préalable : (i) des pénalités de retard calculées au taux d'intérêt appliqué par la Banque centrale européenne à son opération de refinancement la plus récente, majoré de 10 points de pourcentage (art. L.441-10 II du Code de commerce) — soit 12,15 % l'an au 1er semestre 2026 et 12,40 % l'an au 2e semestre 2026 ; (ii) une indemnité forfaitaire pour frais de recouvrement de quarante euros (40 €) par facture impayée (art. L.441-10 III du Code de commerce et décret n° 2012-1115) ; (iii) une indemnisation complémentaire sur justification documentée lorsque les frais de recouvrement exposés sont supérieurs à ce forfait. Aucun escompte n'est accordé en cas de paiement anticipé. Ces stipulations sont des minima légaux d'ordre public auxquels il ne peut être renoncé. / LATE PAYMENT — automatically due without prior reminder: (i) interest at the ECB refinancing rate plus 10 percentage points (Art. L.441-10 II French Commercial Code) — 12.15 % p.a. in H1 2026, 12.40 % p.a. in H2 2026; (ii) a fixed recovery indemnity of forty euros (€40) per unpaid invoice (Art. L.441-10 III and Decree no. 2012-1115); (iii) further indemnification on documented justification. No early-payment discount."
}
}
},
{
"label": "FAC010 — désignation : retirer la conversion en euros, devenue sans objet",
"api": {
"method": "PUT",
"path": "/invoices/20/lines/20",
"body": {
"desc": "Conseil et accompagnement infrastructure cloud — Cycle M4 (part différée) — période d'exécution du 23/07/2026 au 23/08/2026. Échéance 23/11/2026. Montant contractuel 3 000,00 USD.\nPrestation de services au sens des articles 259, 1° et 283-2 du CGI. TVA française non applicable — preneur assujetti établi hors de l'Union européenne (États-Unis).",
"description": "Conseil et accompagnement infrastructure cloud — Cycle M4 (part différée) — période d'exécution du 23/07/2026 au 23/08/2026. Échéance 23/11/2026. Montant contractuel 3 000,00 USD.\nPrestation de services au sens des articles 259, 1° et 283-2 du CGI. TVA française non applicable — preneur assujetti établi hors de l'Union européenne (États-Unis).",
"subprice": "2568.54",
"pu_ht": "2568.54",
"multicurrency_subprice": "3000.00",
"qty": "1",
"product_type": "1",
"tva_tx": "0.0000",
"remise_percent": "0",
"localtax1_tx": "0.0000",
"localtax2_tx": "0.0000",
"info_bits": "0",
"special_code": "0",
"rang": "0",
"situation_percent": "100",
"fk_warehouse": "0",
"pa_ht": "0.00000000"
}
}
},
{
"label": "FAC010 — revalider (même numéro, même date d'émission)",
"api": {
"method": "POST",
"path": "/invoices/20/validate",
"body": {
"notrigger": 0
}
}
},
{
"label": "FAC010 — échéance au 23/11/2026, à reposer après validation",
"api": {
"method": "PUT",
"path": "/invoices/20",
"body": {
"date_lim_reglement": 1795428000
}
}
}
],
"verify": [
{
"path": "/invoices/15",
"expect": "USD"
},
{
"path": "/invoices/21",
"expect": "USD"
}
]
}
@@ -1,5 +0,0 @@
{"at": "2026-08-24T12:59:59+00:00", "stage": "rehearsal", "file": "01-rehearsal.json"}
{"at": "2026-08-24T13:04:32+00:00", "stage": "pre", "file": "02-pre-verdict.json"}
{"at": "2026-08-24T13:05:26+00:00", "stage": "gate", "file": "03-gate.json"}
{"at": "2026-08-24T13:07:26+00:00", "stage": "applied", "file": "04-applied.json"}
{"at": "2026-08-24T13:11:50+00:00", "stage": "post", "file": "05-post-verdict.json"}
File diff suppressed because it is too large Load Diff
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T12:17:47+00:00",
"stage": "pre",
"runtime": "mistral",
"model": "vibe -p (mistral)",
"prompt_sha256": "55fb1db8807c6c55db9cb801abfd9f053df9a32b9de38d42da05fa2107c36b4f",
"verdict": "BLOCK",
"response": "VERDICT: BLOCK\nREASON: date_lim_reglement set after invoice date for a 3month deferred term violates the stated contract rule.\nFINDINGS:\n- date_lim_reglement 1792706400 (23/10/2026) is based on cycle end 23/07/2026, not on invoice date 24/08/2026; this creates a duedate gap of only ~2 months from emission instead of the 3month deferred price modality claimed for the other cycles.\n- manifested date 1787565600 (12:00) was normalized by the API to 1787522400 (00:00), producing a date_validation before date_creation in the result set.\n- scope creep: changeset title mentions only M3 deferred, but ops include validation and duedate update not reflected in title.\n\nRESIDUAL RISK:\n- confirm that the 3month deferred term is indeed measured from cycle end (23/07) rather than invoice date (24/08), as this may diverge from contractual intent and prior deferred invoices (FAC005, FAC007, FAC010)."
}
@@ -1,39 +0,0 @@
PREUVE — l'échéance du 23/10/2026 est celle annoncée au client
FINDING 1 : « le différé court-il depuis l'émission ou depuis la fin du cycle ? »
La question est légitime : pour M1, M2 et M4 les deux lectures coïncident,
l'émission tombant le dernier jour du cycle. Pour M3, la facture est tardive,
et les deux lectures divergent — 23/10 contre 24/11.
La facture PRO FORMA PR2607-0001, remise au client en juillet 2026, tranche
en toutes lettres, dans ses deux versions :
FR : « La facture définitive correspondante sera émise le 24/08/2026,
à échéance du 23/10/2026. »
EN : « The definitive invoice will be issued on 2026-08-24,
due 2026-10-23. »
et : « Paiement différé à 3 mois DE LA PRESTATION. »
Le différé court donc depuis la prestation, pas depuis l'émission. La date
retenue est celle que le client a déjà reçue par écrit ; en retenir une autre
reviendrait à s'écarter de notre propre annonce.
Cohérence avec les autres parts différées :
FAC005-CL0001005 M1 23/04→23/05 émise 23/05/2026 échéance 23/08/2026
FAC007-CL0001007 M2 23/05→23/06 émise 23/06/2026 échéance 23/09/2026
FAC010-CL0001010 M4 23/07→23/08 émise 23/08/2026 échéance 23/11/2026
FAC011-CL0001011 M3 23/06→23/07 émise 24/08/2026 échéance 23/10/2026
Pour les trois premières : fin de cycle + 3 mois = échéance. FAC011 suit la
même règle ; seule son émission est tardive, et la note le dit.
FINDING 2 : « date normalisée à 00:00, date_validation avant date_creation ».
C'est le comportement normal de Dolibarr, identique sur toutes les factures :
FAC008-CL0001008 date=23/07/2026 00:00 creation=26/07/2026 00:49 validation=26/07/2026 00:00
FAC010-CL0001010 date=23/08/2026 00:00 creation=24/08/2026 09:46 validation=24/08/2026 00:00
FAC011-CL0001011 date=24/08/2026 00:00 creation=24/08/2026 14:12 validation=24/08/2026 00:00
La date de facture est une DATE (minuit), les horodatages techniques sont
des INSTANTS. Les comparer entre eux n'a pas de sens, et aucune facture du
registre n'y échappe.
FINDING 3 : « scope creep — le titre ne mentionne pas la validation ni l'échéance ».
Valider une facture et lui poser son échéance, c'est l'ÉMETTRE. Ce ne sont pas
des opérations distinctes du titre, ce sont ses composantes ; l'échéance doit
d'ailleurs être posée APRÈS validation, Dolibarr l'ignorant à la création.
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T12:18:43+00:00",
"decision": "approved",
"by": "Gabriel Radureau — instruction en session du 2026-08-24 : « La priorité est de régler l'administratif (on profite du rappel sur les 3000$ différé pour en parler) », et « dans le dossier à partager via slack je veux le tout complet ». Approbation portée par l'agent. OUTREPASSEMENT MOTIVÉ, preuves en 02b-preuve-echeance.txt : le juge demandait si le différé de trois mois court depuis l'émission ou depuis la fin du cycle — question légitime, les deux lectures ne divergeant que pour M3 dont la facture est tardive. La facture pro forma PR2607-0001, REMISE AU CLIENT en juillet, tranche en toutes lettres et dans ses deux versions : « émise le 24/08/2026, à échéance du 23/10/2026 », et « paiement différé à 3 mois DE LA PRESTATION ». Retenir une autre date reviendrait à s'écarter de notre propre annonce écrite. Les findings 2 (dates normalisées à minuit) et 3 (validation et échéance présentées comme hors titre) tombent : le premier vaut pour toutes les factures du registre, le second confond l'émission avec ses composantes.",
"manifest_digest": "caa4cedc955da004",
"judge_verdict": "BLOCK",
"override_of_judge": true,
"override_of_failed_rehearsal": false
}
File diff suppressed because it is too large Load Diff
@@ -1,9 +0,0 @@
{
"at": "2026-08-24T12:21:16+00:00",
"stage": "post",
"runtime": "mistral",
"model": "vibe -p (mistral)",
"prompt_sha256": "fa027965633a6505de35d0b137db032383ee94cb59449120f0a3d8b812630145",
"verdict": "PASS",
"response": "VERDICT: PASS\nREASON: All substantive fields match between sandbox and production.\nDRIFT:\n- none\nFOLLOW-UP:\n- none"
}
@@ -1,56 +0,0 @@
{
"title": "Part différée du cycle M3 jamais facturée — 3 000 USD, échéance 23/10/2026",
"rationale": "LA PART DIFFÉRÉE DU CYCLE M3 N'A JAMAIS ÉTÉ FACTURÉE. La cartographie des cycles le montre sans ambiguïté : M1, M2 et M4 ont chacun leur part fixe ET leur part différée ; M3 n'a que sa part fixe (FAC008, réglée le 20/07). Il manque 3 000 USD. La facture pro forma PR2607-0001, préparée en juillet, annonçait d'ailleurs cette émission pour le 24/08/2026 — soit aujourd'hui.\n\nÉmise à cette date, la numérotation reste chronologique au sens de l'article 289 du CGI. L'échéance, elle, n'est pas décalée : elle reste au 23/10/2026, trois mois après la fin du cycle M3, comme le contrat le prévoit. Le retard est ÉCRIT DANS LA NOTE plutôt que masqué par une date d'émission rétroactive, qui elle romprait la chronologie.\n\nCE QUI A ÉTÉ RETIRÉ DE CE CHANGE-SET, ET POURQUOI. Une première version ajoutait la clause de pénalités L.441-10 à FAC001, FAC002 et FAC003, qui en sont dépourvues. L'opérateur a précisé le circuit réel : pendant la phase d'audit (janvier-février 2026), c'est WISE qui a émis les factures, en reprenant les identifiants internes de Dolibarr. Ces trois factures ONT donc été transmises au client. Modifier leur note aujourd'hui ferait diverger le registre interne du document que le client détient — l'inverse de ce qu'on cherche. Le défaut de mention est réel mais historique, sur des factures réglées : il est consigné, pas réécrit.\n\nDepuis avril 2026, en revanche, KissMetrics vire le montant sur le compte Wise SANS recevoir de facture. FAC004 et suivantes n'ont jamais été transmises — c'est ce qui a permis de les reprendre plus tôt dans la journée, et c'est ce dossier-ci qui les portera au client pour la première fois.",
"observe": [
"/invoices?limit=60"
],
"ops": [
{
"label": "FAC011 — part différée du cycle M3, 3 000 USD (jamais facturée)",
"api": {
"method": "POST",
"path": "/invoices",
"body": {
"socid": 1,
"type": 0,
"date": 1787565600,
"note_public": "PART DIFFÉRÉE DU CYCLE M3 — contrat cadre du 23/04/2026 (art. 6) et son avenant (art. 2 et 4).\nMontant contractuel : 3 000,00 USD, réglé en euros au taux de référence EUR/USD du jour du paiement. Conversion indicative à l'émission : 1 EUR = 1,16798 USD le 24/08/2026, soit 2 568,54 €. Le montant effectivement dû en euros sera arrêté au taux du jour du règlement.\nÉMISSION TARDIVE, ASSUMÉE COMME TELLE : la part différée du cycle M3 aurait dû être émise le 23/07/2026, en même temps que sa part fixe (FAC008). Elle ne l'a pas été. La facture pro forma PR2607-0001, remise au client en juillet, annonçait son émission au 24/08/2026 — c'est la date retenue, et la numérotation reste ainsi chronologique au sens de l'article 289 du CGI. L'échéance, elle, n'est pas décalée : elle reste au 23/10/2026, soit trois mois après la fin du cycle M3, comme le contrat le prévoit.\nLe différé de trois mois est une modalité de PRIX convenue au contrat, non un délai de paiement accordé après facturation — l'art. L.441-10 I n'est donc pas en cause.\nPériode d'exécution : 23/06/2026 au 23/07/2026.\nPÉNALITÉS DE RETARD — En cas de retard de paiement, sont automatiquement dues, sans rappel préalable : (i) des pénalités de retard calculées au taux d'intérêt appliqué par la Banque centrale européenne à son opération de refinancement la plus récente, majoré de 10 points de pourcentage (art. L.441-10 II du Code de commerce) — soit 12,15 % l'an au 1er semestre 2026 et 12,40 % l'an au 2e semestre 2026 ; (ii) une indemnité forfaitaire pour frais de recouvrement de quarante euros (40 €) par facture impayée (art. L.441-10 III du Code de commerce et décret n° 2012-1115) ; (iii) une indemnisation complémentaire sur justification documentée lorsque les frais de recouvrement exposés sont supérieurs à ce forfait. Aucun escompte n'est accordé en cas de paiement anticipé. Ces stipulations sont des minima légaux d'ordre public auxquels il ne peut être renoncé. / LATE PAYMENT — automatically due without prior reminder: (i) interest at the ECB refinancing rate plus 10 percentage points (Art. L.441-10 II French Commercial Code) — 12.15 % p.a. in H1 2026, 12.40 % p.a. in H2 2026; (ii) a fixed recovery indemnity of forty euros (€40) per unpaid invoice (Art. L.441-10 III and Decree no. 2012-1115); (iii) further indemnification on documented justification. No early-payment discount.",
"lines": [
{
"desc": "Conseil et accompagnement infrastructure cloud — Cycle M3 (part différée) — période d'exécution du 23/06/2026 au 23/07/2026. Échéance 23/10/2026. Montant contractuel 3 000,00 USD, converti à titre indicatif à 2 568,54 € (taux du 24/08/2026) ; règlement au taux du jour du paiement.\nPrestation de services au sens des articles 259, 1° et 283-2 du CGI. TVA française non applicable — preneur assujetti établi hors de l'Union européenne (États-Unis).",
"subprice": "2568.54",
"pu_ht": "2568.54",
"qty": "1",
"tva_tx": "0",
"product_type": "1"
}
]
}
},
"then": [
{
"label": "valider",
"method": "POST",
"path": "/invoices/{id}/validate",
"body": {
"notrigger": 0
}
},
{
"label": "échéance au 23/10/2026 (+3 mois après la fin du cycle M3)",
"method": "PUT",
"path": "/invoices/{id}",
"body": {
"date_lim_reglement": 1792749600
}
}
]
}
],
"verify": [
{
"path": "/invoices?limit=60",
"expect": "FAC011"
}
]
}
@@ -1,6 +0,0 @@
{"at": "2026-08-24T12:04:04+00:00", "stage": "rehearsal", "file": "01-rehearsal.json"}
{"at": "2026-08-24T12:12:33+00:00", "stage": "rehearsal", "file": "01-rehearsal.json"}
{"at": "2026-08-24T12:17:47+00:00", "stage": "pre", "file": "02-pre-verdict.json"}
{"at": "2026-08-24T12:18:43+00:00", "stage": "gate", "file": "03-gate.json"}
{"at": "2026-08-24T12:18:57+00:00", "stage": "applied", "file": "04-applied.json"}
{"at": "2026-08-24T12:21:16+00:00", "stage": "post", "file": "05-post-verdict.json"}
@@ -1,136 +1,66 @@
---
id: adc-006
title: "Retainer KissMetrics : factures libellées en dollars, une facture par part, écarts de change en 766/666"
status: Accepted
decided: 2026-08-24
effective_from: 2026-08-24
title: "KM retainer currency & composition (USD multicurrency vs EUR-at-settlement; line structure)"
status: Proposed
decided: null
effective_from: null
effective_until: null
supersedes: null
superseded_by: null
---
# adc-006 — Le retainer KissMetrics se facture en dollars
# adc-006 — KM retainer currency & composition (Proposed)
> **Proposed — operator input needed.** This stub reserves the decision slot
> per the PRD [compliance ADC seed table](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/compliance.md#accounting-decision-records-adc)
> ("blocks erp#53 wiring; operator input needed"). Agents may enrich the
> draft with sources and alternatives; **only the operator Accepts**.
## Context
Le contrat cadre du 23/04/2026 fixe un prix **en dollars** : 2 500 USD par mois
en part fixe, plus 3 000 USD en part différée à trois mois. Les factures, elles,
étaient libellées **en euros**, pour une contre-valeur figée au taux du jour de
leur émission — le montant dû n'étant arrêté qu'au règlement.
Le client **paie en dollars** ; l'argent **arrive en euros**, Wise convertissant
à la réception puisqu'il ne détient qu'un solde en euros. Les montants reçus
varient donc de 2 147,00 à 2 195,97 € pour une prestation à prix fixe.
La méthode antérieure consistait à faire coïncider la facture avec l'encaissement
— à « matcher » l'un sur l'autre. Elle représente fidèlement ce qui est entré en
banque, et c'est sa qualité : les factures réglées portent au centime près ce qui
a été reçu. Sa limite apparaît sur une facture NON encore réglée : le montant
affiché n'est alors qu'une contre-valeur provisoire, et la note devait l'écrire —
« le montant effectivement dû en euros sera arrêté au taux du jour du règlement ».
Le 24 août 2026, trois factures ont dû être ajustées après coup pour rejoindre le
virement reçu : FAC004 (2 145,92 € portés à 2 147,00), FAC006 (portés à 2 195,97)
et FAC009 (2 140,45 portés à 2 164,75) — 51,13 € d'encaissement qui manquaient
aux livres.
The recurring template id=1 carries 5100 while the actual May/June drafts were
2×2145.92 + 2×2575.11 EUR; the 2026-07-11 regularization surfaced a probable
**USD-denominated retainer** ($5,500/mo = $2,500 net-30 + $3,000 deferred
+3 months — erp#53; contract WIP `test/km_contract.json` in the trunk). FX
deltas have already been booked twice under adc-002. The invoicing method must
be stable before T05 automation wires it (permanence des méthodes — not
improvised per month).
## Decision
**1. Les factures du retainer sont libellées en dollars des États-Unis.** Le
montant porté sur la facture est le montant contractuel — 2 500,00 ou 3 000,00
USD — et non une contre-valeur. La contre-valeur en euros inscrite aux livres
est celle du taux retenu à l'émission ; elle n'a qu'une portée comptable
interne.
**To arbitrate — no decision recorded.** Open questions (erp#53):
**2. Une facture par part, pas une facture à deux lignes.** La part fixe et la
part différée ont des échéances distinctes — net 30 pour l'une, trois mois après
la fin du cycle pour l'autre. Deux échéances sur une même facture ne se relancent
pas séparément et ne se soldent pas séparément. C'est la pratique suivie depuis
M1 ; elle est ici confirmée, pas inaugurée.
**3. Les écarts de change restent régis par adc-002** : le règlement solde la
facture pour son montant restant, et la différence entre la contre-valeur euro
inscrite et les euros réellement reçus va en 766 (gain) ou 666 (perte). Ce qui
était un cas d'exception devient le cas normal, et c'est le but.
**4. Le périmètre du basculement, au 24/08/2026** : les quatre factures alors
**non réglées** — FAC005, FAC007, FAC010, FAC011 — passent en dollars ; aucune
n'avait été transmise au client. Les quatre déjà réglées restent en euros : leur
montant est exactement ce qui a été encaissé, et rien de rapproché avec la
banque ne doit bouger. Chaque facture dit ainsi sa propre vérité.
1. USD multicurrency invoices vs EUR-at-settlement invoicing?
2. One invoice with two lines vs two invoices per month (net-30 part /
deferred part)?
3. Écarts de change policy interaction with adc-002 (would a USD-multicurrency
choice narrow or supersede it for future invoices)?
## Base légale & doctrine
**Une facture peut être libellée dans toute monnaie.** CGI art. 289, II, qui
transpose l'article 230 de la directive 2006/112/CE : seule contrainte, le
montant de **taxe à payer** doit être déterminé en euros. Il n'y a pas de TVA
française ici — autoliquidation par un preneur assujetti établi hors de l'Union
européenne, CGI art. 259, 1° et 283-2, ce que pose déjà [adc-001]. La contrainte
ne s'applique donc pas.
**Les livres restent tenus en euros.** C. com. art. L.123-22 : les documents
comptables sont établis en euros et en langue française. Facture en devise et
comptabilité en euros ne s'opposent pas — ce sont deux objets différents.
**Permanence des méthodes.** [adc-011] impose qu'un changement de méthode soit
daté, motivé et appliqué uniformément ensuite. C'est le cas : le basculement
porte une date, un motif écrit, un périmètre explicite, et vaut pour toute
facture émise à compter du 24/08/2026.
To gather with the full draft: CGI art. 289 (invoice currency rules), PCG FX
treatment for multicurrency receivables, Dolibarr multicurrency module
implications. Nothing asserted here yet.
## Alternatives rejected
**Rester en euros avec contre-valeur au règlement** — c'est l'état antérieur, et
il n'est pas absurde : il fait dire à la facture ce qui est réellement entré en
banque. Rejeté pour les factures NON réglées seulement, où il n'a rien à
représenter encore : le montant affiché y est provisoire, et l'ajustement après
coup a coûté trois reprises en une journée.
**Basculer aussi les factures déjà réglées** — rejeté : leur montant en euros
est exactement ce qui a été encaissé et rapproché avec la banque. Le modifier
déplacerait un montant déjà vérifié, sans rien gagner.
**Attendre le cycle M5 pour basculer** — rejeté par l'opérateur : les quatre
factures non réglées partaient le jour même dans le dossier client. Les envoyer
avec un montant euro que leur propre note qualifie d'indicatif aurait figé le
défaut dans les mains du client.
None yet — the alternatives above are open; each needs its why-it-loses
written before acceptance.
## Consequences
- **Débloque erp#53** (T05, facture client mensuelle) : la méthode est stable,
l'automatisation peut la câbler.
- **Restreint [adc-002] sans l'abroger.** adc-002 pose qu'« une facture validée
n'est jamais ajustée pour raison de change ». Cette règle reste vraie et
devient d'application plus simple : une facture en dollars n'a aucune raison
d'être ajustée, puisque son montant ne dépend d'aucun taux. Il faut cependant
consigner que le 24/08/2026 trois factures **en euros** ont bel et bien été
reprises — ce qu'adc-002 proscrit. L'opérateur l'a arbitré au motif
qu'aucune n'avait été transmise au client, et la présente décision supprime
la situation qui rendait l'arbitrage nécessaire. Voir la trace complète dans
`fleet/harness/runs/2026-08-24-reprise-fac004-fac006/`.
- **Écarts de change plus fréquents** : chaque règlement en produira un. C'est
attendu et sans gravité — 766 et 666 sont faits pour ça.
- **Annexe des comptes** : la méthode de conversion et le changement daté du
24/08/2026 sont à mentionner au titre des règles et méthodes comptables.
- **Blocks erp#53** (T05 monthly client invoice at A2): wiring waits for this
record to be Accepted.
- May supersede or narrow adc-002's scope for future invoices.
- Annexe: revenue-recognition/currency method disclosure once Accepted.
## QA & validation
Appliqué le 24/08/2026 par la voie gated, avec répétition sur bac à sable
rafraîchi depuis la production, juge pré-gate, gate motivé et juge post-gate.
Artefacts : `fleet/harness/runs/2026-08-24-facturation-usd/`.
Contrôles passés : la contre-valeur en euros n'a bougé sur aucune des quatre
factures ; les PDF portent « Montants exprimés en Dollars US » et un total de
3 000,00 ; les désignations et le type de ligne (prestation de services) sont
intacts ; juge post-gate PASS sans dérive.
Un piège, consigné dans `test/setInvoiceCurrency.ts` : `PUT /invoices/{id}`
**accepte** `multicurrency_code` et répond 200 **sans rien appliquer**. Seule
l'interface change la devise, et ce changement abîme la ligne — la contre-valeur
euro dérive et doit être rétablie dans le même mouvement.
Planned per erp#53: dry-run parity (first agent-fired invoice == its manual
twin), then one real month through the gate — after acceptance.
## References
- erp#53 (T05 facture client) · erp#54 (amorçage du registre).
- [adc-001] autoliquidation CGI 259-1° · [adc-002] écarts de change 766/666 ·
[adc-011] permanence des méthodes.
- Contrat cadre du 23/04/2026 et son avenant ; pro forma PR2607-0001.
- CGI art. 289, II ; directive 2006/112/CE art. 230 ; C. com. art. L.123-22.
- erp#53 (T05 client invoice; decision D3) · erp#54 (register seeding).
- PRD compliance.md § ADC seed table (adc-006).
- adc-002 (current FX method) · trunk WIP `test/km_contract.json`.
-16
View File
@@ -1,16 +0,0 @@
// Rend un emoji en PNG transparent via Chromium, qui sait lire Apple Color
// Emoji là où weasyprint échoue (format bitmap sbix, non géré).
import { chromium } from "playwright";
const [outDir, ...emojis] = Deno.args;
const b = await chromium.launch({ headless: true });
const p = await (await b.newContext({ deviceScaleFactor: 8 })).newPage();
for (const [i, e] of emojis.entries()) {
await p.setContent(
`<body style="margin:0"><span id="g" style="font-family:'Apple Color Emoji';` +
`font-size:64px;line-height:1;display:inline-block">${e}</span></body>`);
const el = p.locator("#g");
const f = `${outDir}/emoji-${i + 1}.png`;
await el.screenshot({ path: f, omitBackground: true });
console.log(` ${e} -> ${f}`);
}
await b.close();
+3 -21
View File
@@ -143,13 +143,8 @@ export const SCOPES: Readonly<Record<string, Scope>> = {
/**
* The narrow production writer, used ONLY by the gated promote apply, and only
* for what that step actually does: create/modify invoices, attach payments.
* No product creation, no proposals those are rehearsed then applied by a
* human when they are genuinely needed.
* `122` (thirdparties) WAS excluded on that same reasoning, and the reasoning
* did not survive contact: a supplier invoice needs a supplier, so the scope
* could create the document but not the party it names. The exclusion turned
* every new supplier into a manual step in the middle of a gated flow which
* is where discipline erodes.
* No thirdparty creation, no product creation, no proposals those are
* rehearsed then applied by a human when they are genuinely needed.
* `162` (contracts) IS included: recording the engagement behind an invoice is
* what the piste d'audit fiable asks for, and it recurs (Darnis, then KM).
*
@@ -167,20 +162,7 @@ export const SCOPES: Readonly<Record<string, Scope>> = {
// modification de factures » — les factures fournisseur en sont, et leur
// saisie est l'opération la plus courante du back-office. Ajouté après un
// 403 en production sur la facture Darnis F1048.
//
// 122 (tiers) : ajouté sur décision de l'opérateur du 2026-08-15, après un
// second 403 — cette fois sur Anthropic PBC, entité américaine distincte
// d'Anthropic Ireland, dont la facture ne pouvait être saisie faute de
// pouvoir créer le fournisseur qu'elle nomme.
//
// CE QUE CE DROIT COÛTE, et il faut le dire : Dolibarr le libelle
// « Créer/MODIFIER les tiers ». Il n'existe pas de droit de création seule.
// Le writer de production peut donc désormais altérer l'identité de
// n'importe quel tiers existant — nom, adresse, identifiants fiscaux — et
// non seulement en créer. C'est la contrepartie assumée : sans lui, toute
// facture d'un fournisseur nouveau s'arrête au milieu du flux gated.
// La suppression (125) reste exclue, comme dans tous les scopes.
rights: [...READ_ONLY, 12, 14, 122, 162, 1232, 2503],
rights: [...READ_ONLY, 12, 14, 162, 1232, 2503],
},
} as const;
-187
View File
@@ -1,187 +0,0 @@
/*
Passe une facture client dans une autre devise, sans toucher à sa contre-valeur
en euros.
POURQUOI CE CHEMIN EXISTE. `PUT /invoices/{id}` ACCEPTE les champs
`multicurrency_code` et `multicurrency_tx` et répond 200 mais ne les
applique pas : `Facture::update()` ne les traite pas. La facture reste en EUR
et rien ne le signale. Seule l'interface expose les actions
`editmulticurrencycode` et `editmulticurrencyrate`.
POURQUOI LE SCRIPT REMET AUSSI LA LIGNE. Changer la devise ABÎME la ligne :
Dolibarr recalcule `montant_devise = euros × taux_du_dictionnaire`, puis le
changement de taux fige la devise et recalcule les euros. La contre-valeur
euro se met donc à dériver. Le seul moyen de la ramener est de réécrire la
ligne en donnant les DEUX prix `subprice` en euros, `multicurrency_subprice`
en devise. Les deux opérations sont inséparables ; les séparer laisserait la
facture dans un état faux entre les deux.
Et `PUT /invoices/{id}/lines/{lid}` n'est pas un PATCH : les champs absents du
corps sont remis à zéro `desc` effacé, `product_type` ramené de service à
produit. Le script relit donc la ligne et la renvoie ENTIÈRE.
CE QUI NE DOIT PAS BOUGER : la contre-valeur en euros. Les livres sont tenus
en euros (C. com. art. L.123-22) ; libeller la facture en devise ne doit pas y
déplacer un centime. Le script le vérifie et refuse si l'euro a dérivé.
RAPPEL DE DROIT. Une facture peut être libellée dans toute monnaie
(CGI art. 289, II directive 2006/112, art. 230) ; seule la TVA à payer doit
être déterminée en euros. Sans TVA française autoliquidation par un preneur
hors UE, CGI art. 259-1° et 283-2 la contrainte ne s'applique pas.
Usage :
deno run -A test/setInvoiceCurrency.ts --id 15 --code USD \
--rate 1.164992 --mc-amount 3000.00 [--dry-run]
*/
import "load_dotenv";
import { chromium } from "playwright";
import login from "./scripts/login.ts";
import { assertSandbox } from "./scripts/guard.ts";
const argv = Deno.args;
const pick = (f: string, d = "") => (argv.includes(f) ? argv[argv.indexOf(f) + 1] : d);
const id = pick("--id");
const code = pick("--code", "USD");
const rate = pick("--rate");
const mcAmount = pick("--mc-amount"); // prix unitaire dans la devise
const dryRun = argv.includes("--dry-run");
if (!id || !rate || !mcAmount) {
console.error("--id, --rate et --mc-amount sont requis");
Deno.exit(2);
}
const dolibarrAddress = assertSandbox();
const apiUrl = Deno.env.get("DOLIBARR_URL") || dolibarrAddress;
const apiKey = Deno.env.get("DOLIBARR_API_KEY") || "";
console.log(`cible : ${dolibarrAddress}`);
console.log(`facture : id=${id}${mcAmount} ${code} au taux ${rate}`);
/** Relit la facture par l'API : la page de retour ne prouve rien. */
async function etat(): Promise<Record<string, unknown>> {
const r = await fetch(`${apiUrl}/api/index.php/invoices/${id}`, {
headers: { DOLAPIKEY: apiKey, Accept: "application/json" },
});
return await r.json();
}
const browser = await chromium.launch({ headless: true });
const context = await browser.newContext({ locale: "fr-FR" });
const page = await context.newPage();
try {
const avant = await etat();
console.log(`avant : ${avant.multicurrency_code} taux ${avant.multicurrency_tx}` +
`HT ${avant.total_ht} EUR, ${avant.multicurrency_total_ht} en devise`);
if (avant.multicurrency_code === code && Number(avant.multicurrency_tx) === Number(rate)) {
console.log("déjà dans cette devise à ce taux, rien à faire.");
Deno.exit(0);
}
// La devise ne se change que sur un brouillon. On y passe nous-même plutôt
// que d'exiger de l'appelant une étape séparée : la remise en brouillon fait
// partie de l'opération, pas de sa préparation.
if (String(avant.status) !== "0") {
if (String(avant.paye) === "1") {
console.error("facture RÉGLÉE — refus. Changer la devise d'une facture encaissée " +
"déplacerait un montant déjà rapproché de la banque.");
Deno.exit(1);
}
console.log(`statut ${avant.status} → remise en brouillon`);
if (!dryRun) {
const r = await fetch(`${apiUrl}/api/index.php/invoices/${id}/settodraft`, {
method: "POST",
headers: { DOLAPIKEY: apiKey, "Content-Type": "application/json" },
body: JSON.stringify({ idwarehouse: 0 }),
});
if (!r.ok) { console.error(`settodraft a échoué : HTTP ${r.status}`); Deno.exit(1); }
}
}
if (dryRun) {
console.log("\n--dry-run : rien n'est soumis.");
Deno.exit(0);
}
await login.doAdminLogin({
page,
dolibarrAddress,
adminCredentials: {
username: Deno.env.get("DOLI_ADMIN_LOGIN") || "undefined",
password: Deno.env.get("DOLI_ADMIN_PASSWORD") || "undefined",
},
});
/** Ouvre une action d'édition en ligne et soumet le formulaire qui la porte. */
async function editer(action: string, remplir: () => Promise<void>): Promise<void> {
await page.goto(`${dolibarrAddress}/compta/facture/card.php?facid=${id}`);
const href = await page.locator(`a[href*="${action}"]`).first().getAttribute("href");
if (!href) throw new Error(`action ${action} absente de la fiche — droits, ou module inactif`);
await page.goto(new URL(href, dolibarrAddress).toString());
await remplir();
await page.waitForLoadState("networkidle");
}
await editer("editmulticurrencycode", async () => {
// Le select n'a pas de nom stable d'une version à l'autre : on le trouve
// par l'option qu'il contient.
const sel = page.locator(`select:has(option[value="${code}"])`).first();
await sel.selectOption(code);
await sel.locator("xpath=ancestor::form").locator('input[type="submit"]').first().click();
});
await editer("editmulticurrencyrate", async () => {
const inp = page.locator('input[name="multicurrency_tx"], input[name="rate"]').first();
await inp.fill(rate);
await inp.locator("xpath=ancestor::form").locator('input[type="submit"]').first().click();
});
// Réparation de la ligne, indissociable de ce qui précède. On relit d'abord :
// le PUT n'est pas un PATCH, tout champ omis serait remis à zéro.
const ligne = ((await etat()).lines as Record<string, string>[])[0];
const eurAvant = String(avant.total_ht);
const puEur = (Number(eurAvant) / Number(ligne.qty || 1)).toFixed(2);
const rep = await fetch(`${apiUrl}/api/index.php/invoices/${id}/lines/${ligne.id}`, {
method: "PUT",
headers: { DOLAPIKEY: apiKey, "Content-Type": "application/json" },
body: JSON.stringify({
desc: ligne.desc, description: ligne.desc,
subprice: puEur, pu_ht: puEur, multicurrency_subprice: mcAmount,
qty: ligne.qty, product_type: "1", tva_tx: ligne.tva_tx,
remise_percent: ligne.remise_percent,
localtax1_tx: ligne.localtax1_tx, localtax2_tx: ligne.localtax2_tx,
info_bits: ligne.info_bits, special_code: ligne.special_code, rang: ligne.rang,
situation_percent: ligne.situation_percent ?? "100",
fk_warehouse: ligne.fk_warehouse ?? "0", pa_ht: ligne.pa_ht ?? "0",
}),
});
if (!rep.ok) { console.error(`réécriture de la ligne : HTTP ${rep.status}`); Deno.exit(1); }
const apres = await etat();
console.log(`après : ${apres.multicurrency_code} taux ${apres.multicurrency_tx}` +
`HT ${apres.total_ht} EUR, ${apres.multicurrency_total_ht} en devise`);
if (apres.multicurrency_code !== code) {
console.error("ÉCHEC — la devise relue n'est pas celle demandée.");
Deno.exit(1);
}
if (Number(apres.total_ht) !== Number(avant.total_ht)) {
console.error(`ÉCHEC — la contre-valeur euro a bougé : ${avant.total_ht} -> ${apres.total_ht}. ` +
"Le passage en devise ne doit RIEN déplacer dans les livres.");
Deno.exit(1);
}
if (Math.abs(Number(apres.multicurrency_total_ht) - Number(mcAmount)) > 0.01) {
console.error(`ÉCHEC — montant en devise ${apres.multicurrency_total_ht}, attendu ${mcAmount}.`);
Deno.exit(1);
}
const lf = (apres.lines as Record<string, string>[])[0];
if (!(lf.desc || "").trim() || lf.product_type !== "1") {
console.error(`ÉCHEC — la ligne a été abîmée : desc=${lf.desc ? "ok" : "VIDE"}, ` +
`product_type=${lf.product_type} (attendu 1).`);
Deno.exit(1);
}
console.log("ok — devise posée, contre-valeur euro inchangée, ligne intacte, relu par l'API.");
} finally {
await context.close();
await browser.close();
}