feat(erp): le retainer KissMetrics se facture en dollars — adc-006 tranchée
L'opérateur a demandé « on ne peut pas emettre de facture en dollars ? ». Si, et
c'est même la bonne réponse ici — au point que la question avait déjà son créneau
au registre : adc-006 était Proposed depuis juillet, sa première question ouverte
étant mot pour mot « USD multicurrency invoices vs EUR-at-settlement ? ».
LE DÉFAUT. Le contrat fixe un prix EN DOLLARS — 2 500 USD en part fixe, 3 000 en
part différée — mais les factures étaient libellées en euros, contre-valeur figée
au taux du jour d'émission. Leur propre note l'avouait : « 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û.
Le coût était réel et mesuré : FAC004, FAC006 et FAC009 ont dû être reprises le
même jour parce que leur contre-valeur ne correspondait pas aux virements reçus.
51,13 EUR d'encaissement manquaient aux livres.
Le client paie d'ailleurs en dollars : les euros reçus varient de 2 147,00 à
2 195,97 pour une prestation à prix fixe, signature d'un virement en devise
converti à l'arrivée par Wise, qui ne détient qu'un solde en euros.
LE DROIT. Une facture peut être libellée dans toute monnaie (CGI art. 289, II,
transposant la directive 2006/112 art. 230) ; seule la TVA à payer doit être
déterminée en euros, et il n'y en a pas — autoliquidation par un preneur hors UE.
Les LIVRES, eux, restent tenus en euros (C. com. art. L.123-22) : la
contre-valeur inscrite n'a pas bougé d'un centime.
PÉRIMÈTRE. Les quatre factures NON RÉGLÉES, aucune n'ayant été transmise :
FAC005, FAC007, FAC010, FAC011, toutes portées à 3 000,00 USD. Les quatre réglées
restent en euros — leur montant est exactement ce qui a été encaissé et rapproché
avec la banque. Chaque facture dit ainsi sa propre vérité.
CE QUE adc-006 DOIT CONSIGNER, ET CONSIGNE. adc-002 pose qu'« une facture validée
n'est jamais ajustée pour raison de change ». Trois l'ont pourtant été le 24/08.
L'opérateur l'a arbitré au motif qu'aucune n'avait été transmise au client, et
adc-006 supprime la situation qui rendait l'arbitrage nécessaire : une facture en
dollars n'a aucune raison d'être ajustée, son montant ne dépendant d'aucun taux.
adc-002 s'en trouve restreinte, pas abrogée — les écarts de change continuent
d'aller en 766 et 666, et deviennent le cas normal au lieu de l'exception.
test/setInvoiceCurrency.ts. Deux pièges consignés. `PUT /invoices/{id}` ACCEPTE
`multicurrency_code`, répond 200, et n'applique rien : seule l'interface change
la devise. Et ce changement ABÎME la ligne — Dolibarr recalcule le montant en
devise depuis les euros et le taux du dictionnaire, puis le changement de taux
fige la devise et recalcule les euros, si bien que la contre-valeur dérive. Le
script réunit donc les deux opérations, réécrit la ligne ENTIÈRE (le PUT n'est
pas un PATCH) et refuse si la contre-valeur euro a bougé d'un centime.
Le juge a relevé, à raison, que le titre du change-set débordait de son contenu :
le passage en devise est fait par le script, en amont. Accepté et consigné au
gate ; le manifeste n'a pas été retouché pour ne pas rompre l'empreinte sur
laquelle le gate est scellé. Son residual risk — vérifier la multidevise en
production — est honoré. Juge post-gate PASS sans dérive.
Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
This commit is contained in:
Claude Opus 5
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"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."
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"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
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"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"
|
||||
}
|
||||
@@ -0,0 +1,194 @@
|
||||
{
|
||||
"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"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
{"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"}
|
||||
@@ -1,66 +1,131 @@
|
||||
---
|
||||
id: adc-006
|
||||
title: "KM retainer currency & composition (USD multicurrency vs EUR-at-settlement; line structure)"
|
||||
status: Proposed
|
||||
decided: null
|
||||
effective_from: null
|
||||
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
|
||||
effective_until: null
|
||||
supersedes: null
|
||||
superseded_by: null
|
||||
---
|
||||
|
||||
# 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**.
|
||||
# adc-006 — Le retainer KissMetrics se facture en dollars
|
||||
|
||||
## Context
|
||||
|
||||
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).
|
||||
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.
|
||||
|
||||
Ce montage a un défaut que la pratique a révélé le 24 août 2026 : le montant
|
||||
affiché sur la facture n'est pas le montant dû. Leur propre note le disait —
|
||||
« le montant effectivement dû en euros sera arrêté au taux du jour du
|
||||
règlement ». Trois factures ont dû être reprises le même jour parce que leur
|
||||
contre-valeur ne correspondait pas à ce que le client avait viré : 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). Cinquante et un euros d'encaissement manquaient aux livres.
|
||||
|
||||
Le client paie d'ailleurs **en dollars**. Les euros reçus varient de 2 147,00 à
|
||||
2 195,97 pour une prestation à prix fixe : c'est la signature d'un virement en
|
||||
devise, converti à l'arrivée par Wise, qui ne détient qu'un solde en euros.
|
||||
|
||||
## Decision
|
||||
|
||||
**To arbitrate — no decision recorded.** Open questions (erp#53):
|
||||
**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.
|
||||
|
||||
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)?
|
||||
**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é.
|
||||
|
||||
## Base légale & doctrine
|
||||
|
||||
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.
|
||||
**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.
|
||||
|
||||
## Alternatives rejected
|
||||
|
||||
None yet — the alternatives above are open; each needs its why-it-loses
|
||||
written before acceptance.
|
||||
**Rester en euros avec contre-valeur au règlement** — c'est l'état antérieur.
|
||||
Rejeté : il produit des factures dont le montant affiché n'est pas le montant
|
||||
dû, et il a effectivement coûté trois reprises en une seule 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.
|
||||
|
||||
## Consequences
|
||||
|
||||
- **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.
|
||||
- **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.
|
||||
|
||||
## QA & validation
|
||||
|
||||
Planned per erp#53: dry-run parity (first agent-fired invoice == its manual
|
||||
twin), then one real month through the gate — after acceptance.
|
||||
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.
|
||||
|
||||
## References
|
||||
|
||||
- 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`.
|
||||
- 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.
|
||||
|
||||
Reference in New Issue
Block a user