docs(erp): transmettre le choix de l'instrument aux agents suivants
L'erreur rattrapée par l'opérateur — ouvrir une fiche fournisseur au nom du gérant — n'était pas un défaut d'exécution mais un choix d'instrument. Rien dans le dépôt ne l'empêchait de se reproduire. RUNBOOK_quel_instrument.md pose la question qui tranche — à qui la société doit-elle cet argent ? — et sa table de décision : fournisseur réel → facture fournisseur ; organisme social ou fiscal → charge ; l'associé lui-même → paiement divers sur CCA1, sans aucun tiers. Il distingue les deux usages du compte courant, que l'on confond facilement : le gérant AVANCE une dépense (adc-005, le tiers est le fournisseur) contre la société DOIT au gérant (adc-010, aucun tiers). adc-010 enregistre la décision et sa base : le compte 455 porte les sommes dues à l'associé, le poste fournisseurs les dettes d'exploitation envers des tiers ayant fourni biens ou services. Le gérant qui met une pièce à disposition n'y entre pas — même raisonnement qu'adc-008 et le runbook charges sociales opposent déjà à l'URSSAF. AGENTS.md porte désormais la règle dans les operating rules, avec la leçon généralisable : une écriture dont le modèle contredit celles déjà au grand livre est presque toujours fausse, et la vérification coûte une requête. La règle dit aussi que le choix décide de la voie technique — ni les charges sociales ni les paiements divers n'ayant d'API REST, le promote gated ne peut pas les porter. Le calendrier porte la décision de l'opérateur du 13/08 : pas de rémunération de gérance en 2026, arbitrage reporté à 2027, avec ses conséquences — aucun trimestre de retraite validé, et une régularisation URSSAF probablement à la baisse puisque l'assiette réelle sera quasi nulle. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
This commit is contained in:
Claude Opus 5
@@ -0,0 +1,128 @@
|
||||
# Runbook — quel instrument pour quelle dette
|
||||
|
||||
Public : un agent, quel que soit son modèle, ou l'opérateur.
|
||||
|
||||
**Lire ceci AVANT d'enregistrer quoi que ce soit.** Le choix de l'instrument
|
||||
décide de tout ce qui suit : le compte comptable, les rapports où l'écriture
|
||||
apparaîtra, et jusqu'à la voie technique disponible. Une opération parfaitement
|
||||
exécutée avec le mauvais instrument reste une erreur, et elle est plus coûteuse
|
||||
à défaire qu'à éviter.
|
||||
|
||||
## La question qui tranche
|
||||
|
||||
> **À qui la société doit-elle cet argent ?**
|
||||
|
||||
| Le créancier est… | Instrument | Écran Dolibarr |
|
||||
| --- | --- | --- |
|
||||
| un **fournisseur réel** (prestataire, éditeur, greffe, La Poste…) | **facture fournisseur** | Facturation → Factures fournisseur |
|
||||
| un **organisme social ou fiscal** (URSSAF, CFE, TVA…) | **charge sociale ou fiscale** | Comptabilité → Charges sociales/fiscales |
|
||||
| **l'associé lui-même**, ou personne (régularisation interne) | **paiement divers** | Banques → Paiements divers |
|
||||
|
||||
### Le piège, et il a été payé deux fois
|
||||
|
||||
**Ni l'URSSAF ni le gérant ne sont des fournisseurs.** Leur ouvrir une fiche
|
||||
fournisseur les fait apparaître au grand livre auxiliaire, dans les balances
|
||||
âgées et dans les états de dettes fournisseurs — des états censés ne montrer que
|
||||
le poste fournisseurs. L'erreur est invisible à la saisie et se découvre à la
|
||||
clôture.
|
||||
|
||||
Le contrôle qui la révèle est gratuit : **regarder l'existant**. Les dettes déjà
|
||||
portées au compte courant d'associé sont toutes des factures de fournisseurs
|
||||
réels payées personnellement par le gérant — le tiers y est le fournisseur,
|
||||
jamais le gérant. Un modèle qui contredit celui déjà en place est presque
|
||||
toujours le mauvais.
|
||||
|
||||
## Le compte courant d'associé : deux usages à ne pas confondre
|
||||
|
||||
Le compte bancaire **`CCA1` (id 3)** porte le numéro comptable **45511** et son
|
||||
propre journal comptable. Il sert dans deux cas *différents* :
|
||||
|
||||
**1. Le gérant a avancé une dépense** — un fournisseur réel a facturé, le gérant
|
||||
a payé de sa poche. → facture fournisseur au nom du **fournisseur**, puis
|
||||
règlement sur le compte 3. C'est `adc-005`.
|
||||
|
||||
**2. La société doit quelque chose au gérant lui-même** — indemnité
|
||||
d'occupation, remboursement forfaitaire. → **paiement divers** sur le compte 3,
|
||||
sans aucun tiers.
|
||||
|
||||
```bash
|
||||
cd test
|
||||
DOLIBARR_ADDRESS=https://erp-sandbox.arcodange.lab \
|
||||
deno run -A recordVariousPayment.ts \
|
||||
--label "Indemnité d'occupation — mars 2026" \
|
||||
--amount 220.00 --date 2026-03-31
|
||||
```
|
||||
|
||||
Production — double opt-in explicite, comme toute écriture de production :
|
||||
|
||||
```bash
|
||||
DOLIBARR_ADDRESS=https://erp.arcodange.lab \
|
||||
ARCO_ALLOW_PRODUCTION=erp.arcodange.lab \
|
||||
ARCO_PROD_CONFIRM=I-UNDERSTAND-THIS-WRITES-PROD \
|
||||
deno run -A recordVariousPayment.ts --label "…" --amount … --date …
|
||||
```
|
||||
|
||||
Défauts : `--account 3` (compte courant), `--code 613` (Locations),
|
||||
`--sens 0` (débit). `--dry-run` affiche sans écrire.
|
||||
|
||||
L'écriture produite :
|
||||
|
||||
```
|
||||
débit 613000 Locations (la charge)
|
||||
crédit 45511 G. RADUREAU, compte courant (la dette envers l'associé)
|
||||
```
|
||||
|
||||
## Le plan comptable est chargé — nuance à connaître
|
||||
|
||||
**358 comptes sont disponibles** dans le sélecteur des paiements divers, dont un
|
||||
`455110` déjà dédié au compte courant du gérant. Ne pas confondre trois choses :
|
||||
|
||||
- le **plan comptable** est chargé et utilisable depuis ce formulaire ;
|
||||
- l'**API REST comptable** n'est pas exposée (`/accountancy/*` → 404) ;
|
||||
- le **dictionnaire des types de charges sociales** ne porte aucun code
|
||||
comptable (colonne vide pour tous les types, `TAXSSI` compris).
|
||||
|
||||
Conclusion pratique : sur un paiement divers, le compte se choisit et **est
|
||||
enregistré**. Sur une charge sociale, le type n'est qu'un libellé et l'imputation
|
||||
vit dans le grand livre de l'expert-comptable.
|
||||
|
||||
## Ce que le pipeline gated ne peut pas porter
|
||||
|
||||
`fleet/harness/promote/` parle REST. Or **ni les charges sociales ni les
|
||||
paiements divers n'ont d'API** : `/taxes`, `/socialcontributions`,
|
||||
`/chargesociales`, `/variouspayments` répondent tous « API not found ».
|
||||
|
||||
Le choix de l'instrument décide donc de la voie disponible. Facture fournisseur
|
||||
→ pipeline gated complet, avec juge et artefact de gate. Charge sociale ou
|
||||
paiement divers → script UI, qui garde la discipline (répétition sandbox,
|
||||
relecture par la liste, opt-in production) **sans** juge indépendant ni gate.
|
||||
Ne pas choisir l'instrument pour la commodité de la voie : c'est la nature de la
|
||||
dette qui décide, et la voie s'ajuste.
|
||||
|
||||
## Les pièges, tous rencontrés
|
||||
|
||||
1. **Les dates sont un piège à double fond.** Le champ visible est décoratif :
|
||||
le backend ne lit que les champs **cachés** `{nom}day` / `{nom}month` /
|
||||
`{nom}year`. Remplir le champ texte seul soumet une date vide. Vaut pour
|
||||
`datep`, `datev`, `ech`, `period`.
|
||||
2. **Vérifier par la LISTE, jamais par l'URL.** Dolibarr renvoie des pages sans
|
||||
identifiant : conclure d'après l'URL fait déclarer un échec sur une création
|
||||
réussie — c'est ainsi que quatre doublons sont apparus en sandbox.
|
||||
3. **Comparer le libellé ENTIER, jamais un préfixe.** Une version comparait les
|
||||
24 premiers caractères ; « Indemnité d'occupation — » en fait exactement 24,
|
||||
si bien que mars reconnaissait février et se déclarait déjà enregistré — six
|
||||
mois silencieusement sautés. Un préfixe ne distingue que ce qui diffère avant
|
||||
lui. *(`recordSocialCharge.ts` porte encore ce défaut, latent : ses libellés
|
||||
diffèrent avant le 24ᵉ caractère, aujourd'hui seulement.)*
|
||||
4. **Les milliers s'affichent avec une espace insécable** : `1215.00` devient
|
||||
« 1 215,00 ». Comparer sans les espaces, sinon l'idempotence saute au-delà de
|
||||
999 €.
|
||||
5. **En zsh, `set -- $var` ne découpe pas les mots** (contrairement à bash) : une
|
||||
boucle de saisie a produit des dates `2026--`. Écrire les appels
|
||||
explicitement, ou utiliser un tableau.
|
||||
|
||||
## Après l'enregistrement
|
||||
|
||||
- Rapprocher le mouvement bancaire réel quand il a lieu — un paiement divers sur
|
||||
le compte courant ne déplace **aucune trésorerie**, il constate une dette.
|
||||
- Attacher le justificatif à l'objet concerné : voir `RUNBOOK_ged.md`.
|
||||
Reference in New Issue
Block a user