Files

T

arcodangeandClaude Opus 5 81cc3df13c feat(erp): enregistrer les charges sociales — script + runbook rationalisés

Dolibarr n'expose AUCUNE API REST pour les charges sociales (/taxes,
/socialcontributions, /chargesociales répondent tous « API not found »). Le
module est actif, seule l'API manque : le pipeline de promotion, qui parle REST,
ne peut pas porter cette opération. D'où un script UI, gardé par guard.ts.

La sandbox a joué son rôle : quatre doublons y ont été créés pendant la
découverte, sans conséquence, et les quatre pièges du formulaire sont désormais
documentés au lieu d'être redécouverts.

- recordSocialCharge.ts : idempotent (cherche la charge avant de créer),
  vérifie par LECTURE de la liste, type TNS par défaut, --dry-run.
- RUNBOOK_charges_sociales.md : écrit pour être suivi par un agent moins
  performant ou un harness limité — la commande, les garanties, les quatre
  pièges, et ce que le script ne garantit PAS (ni juge, ni artefact de gate).

Les quatre pièges, tous rencontrés :
1. La date visible est décorative : le backend ne lit que les champs CACHÉS
   echday/echmonth/echyear. Remplir le champ texte crée l'enregistrement avec
   une période aberrante (20/06/2000 observé) au lieu d'échouer.
2. Le bouton de soumission n'a pas d'attribut name — le cibler par value.
3. L'URL après soumission ne porte pas d'id : vérifier par l'URL fait conclure
   à un échec sur une création réussie. C'est ce qui a produit les doublons.
4. Les milliers portent une espace insécable (« 1 215,00 ») : une comparaison
   littérale casse au-delà de 999 € et l'idempotence saute en silence.

Correction comptable : 645x → 646 dans known-patterns.json. Les cotisations d'un
gérant TNS sont des cotisations personnelles du dirigeant (646), pas des
cotisations patronales sur salaires (645) — Arcodange n'a aucun salarié.

Appliqué en production : les trois échéances URSSAF 2026, toutes IMPAYÉES.
Reste à vérifier dans le dictionnaire Dolibarr que le type « indépendants »
porte bien le code comptable 646.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_01VRShc4QhLLU73FLHx9vskh

2026-08-13 17:27:17 +02:00

4.9 KiB

Raw Permalink Blame History

Runbook — enregistrer une charge sociale ou fiscale (URSSAF, CFE, TVA…)

Public : un agent, quel que soit son modèle, ou l'opérateur. Écrit pour être suivi sans redécouvrir le terrain — cette routine a coûté une heure la première fois, elle doit en coûter deux minutes ensuite.

Pourquoi ce n'est pas une facture fournisseur

L'URSSAF n'est pas un fournisseur. Sa cotisation va au compte 646 (cotisations personnelles du dirigeant), pas au compte fournisseur — l'inscrire en facture fournisseur pollue le grand livre auxiliaire, les balances âgées et les états de dettes fournisseurs.

645 contre 646, la distinction qui décide de tout :

Compte	Pour qui
645	cotisations patronales sur salaires — suppose des salariés
646	cotisations personnelles du dirigeant TNS

Arcodange n'a aucun salarié et Gabriel est gérant associé unique d'une SARLU, donc TNS : tout va en 646. Le compte 645 doit rester vide.

Dans Dolibarr, cela se pilote par le type de charge, jamais par une saisie manuelle du compte :

Securite sociale (URSSAF / MSA) → régime salarié → 645
Securite sociale des indépendants (URSSAF) → TNS → 646 ← celui-ci

Warning

Le code comptable de chaque type vit dans Configuration → Dictionnaires → Types de charges sociales. Vérifier une fois que la ligne « indépendants » porte bien 646 : si elle porte autre chose, le bon type enverra quand même l'écriture au mauvais compte. Non vérifié à ce jour.

La commande

cd test
DOLIBARR_ADDRESS=https://erp-sandbox.arcodange.lab \
  deno run -A recordSocialCharge.ts \
    --label "URSSAF 2026 — 2e échéance" \
    --due 2026-08-05 --amount 1215.00 --period 2026-08-05

Production — double opt-in explicite, comme toute écriture de production :

DOLIBARR_ADDRESS=https://erp.arcodange.lab \
ARCO_ALLOW_PRODUCTION=erp.arcodange.lab \
ARCO_PROD_CONFIRM=I-UNDERSTAND-THIS-WRITES-PROD \
  deno run -A recordSocialCharge.ts --label "…" --due … --amount … --period …

--dry-run affiche ce qui serait soumis sans rien écrire. --type "CFE" (ou tout autre motif) pour une charge qui n'est pas URSSAF ; le script liste les types disponibles s'il ne trouve pas de correspondance.

La charge est créée impayée. Le règlement s'enregistre séparément, quand il a réellement eu lieu — jamais par anticipation.

Ce que le script garantit

Idempotent : il cherche d'abord la charge dans la liste (libellé + montant) et ne fait rien si elle existe. Un rejeu ne crée pas de doublon.
Vérifié par lecture : après soumission il relit la liste, pas l'URL.
Garde d'hôte : guard.ts refuse toute cible qui n'est pas la sandbox, sauf double opt-in production.

Les quatre pièges, tous rencontrés

La date est un piège à double fond. Le champ visible ech est décoratif : le backend ne lit que les champs cachés echday / echmonth / echyear, alimentés par le datepicker jQuery. Remplir le champ texte soumet une date vide — et Dolibarr crée quand même l'enregistrement, avec une période aberrante (20/06/2000 observé). Même chose pour period.
Le bouton n'a pas de name. Le cibler par value="Ajouter".
L'URL après soumission ne porte pas d'id. Vérifier par l'URL fait conclure à un échec sur une création réussie — c'est ainsi que quatre doublons sont apparus en sandbox pendant que le script affichait « non créée ». Toujours vérifier par la liste.
Les milliers s'affichent avec une espace insécable : 1215.00 devient « 1 215,00 ». Une comparaison littérale échoue au-delà de 999 €, et l'idempotence saute silencieusement. Comparer sans les espaces.

Pourquoi pas le pipeline de promotion

Dolibarr n'expose aucune API REST pour les charges sociales : /taxes, /socialcontributions et /chargesociales répondent tous « API not found ». Le module est actif (le droit 91 existe), seule l'API manque. Le pipeline fleet/harness/promote/ parle REST : il ne peut pas porter cette opération.

Ce script en conserve la discipline — répétition sandbox, relecture du résultat, opt-in production explicite — mais pas le juge indépendant ni l'artefact de gate. Acceptable pour une opération à trois champs ; à ne pas généraliser.

Après l'enregistrement

Rapprocher le prélèvement bancaire quand il apparaît (Qonto pour Arcodange).
Le calendrier fleet/profile/calendar.yaml porte les échéances URSSAF 2026 : 493,00 (22/05) + 1 215,00 (05/08) + 1 333,00 (05/11) = 3 041,00 €.
L'échéancier officiel n'est disponible que dans l'espace urssaf.fr : les notifications par mail ne contiennent aucun montant, et le transfert Gmail → Zoho remplace même leur contenu par un texte générique. Récupérer le PDF à la main reste nécessaire.

4.9 KiB Raw Permalink Blame History