Budget & Échéancier

Cas d'usage : afficher l'état budgétaire courant d'une copropriété, avec ou sans le détail des montants déjà réalisés.

Renvoie toutes les versions de budget existantes pour cet exercice et ce type de poste — brouillons compris.

Ne renvoie que la version la plus récente, votée ou non. idAssociation est l'identifiant de l'exercice (ou de l'opération de travaux pour ce type de poste).

Réservé aux charges courantes : renvoie la version votée en ajoutant, sur chaque ligne, les montants effectivement réalisés (montantRealise, tva) — des champs absents des deux appels précédents.

La même version votée que ci-dessus, mais sans les montants réalisés — également réservé aux charges courantes. Pour les autres types de poste, l'équivalent « version votée uniquement » est exposé par une route dédiée par poste (voir la référence des endpoints) plutôt que par cette route générique.

Cas d'usage : saisir un projet de budget avant qu'il ne soit soumis au vote de l'assemblée générale.

{
  "groupeBudgetExercice": {
    "isVote": 0,
    "note": "Projet soumis à l'AG du 14/03",
    "budgets": [
      { "cle": 4821, "type": 9012, "montant": 128000 },
      { "planComptable": 55310, "montant": 42500 }
    ]
  }
}

Chaque ligne de budgets désigne un poste soit par la paire cle (clé de répartition) + type (poste comptable générique), soit directement par un planComptable existant de la copropriété. Les montants s'expriment en centimes.

Cas d'usage : entériner la version soumise à l'assemblée générale comme référence officielle de l'exercice.

Marque la version la plus récente comme votée et enregistre sa date de vote. Le vote est un appel séparé de la création : il n'existe pas de paramètre « voter » à passer directement dans le POST du Parcours B.

Cas d'usage : une fois le budget voté, produire le calendrier d'appels de fonds envoyé aux copropriétaires.

{
  "echeancier": {
    "type": 4110,
    "exercice": 3305,
    "calculer": 1,
    "echeances": [
      { "numero": 1, "type": "appel", "date": "2026-01-05 00:00:00", "part": 1, "libelle": "1er appel" },
      { "numero": 2, "type": "appel", "date": "2026-04-05 00:00:00", "part": 1, "libelle": "2e appel" }
    ]
  }
}

Le type de l'échéancier (ici 4110) est un code de calendrier propre à la comptabilité de la copropriété : ce n'est pas le même espace de valeurs que le type de poste utilisé comme paramètre de chemin dans les routes de budget (Parcours A/B). Chaque échéance porte en plus un numero d'ordre, un type (appel de fonds, ou affectation d'un paiement déjà reçu), une date et une part — le poids relatif de cette échéance parmi les échéances de même type : des parts égales répartissent le montant total à parts égales entre elles, des parts inégales le répartissent proportionnellement. Au moins une échéance est obligatoire.

Cas d'usage : ajuster le calendrier après une correction budgétaire votée en cours d'exercice.

Accepte le même format de corps que la création. La liste d'échéances soumise remplace la définition du plan, mais pas de façon purement destructrice.

Cas d'usage : consulter le détail d'un appel de fonds précis, ajouter un appel isolé sans passer par un échéancier complet, ou revenir sur une échéance saisie par erreur.

Ajoute un appel de fonds ponctuel, indépendamment de tout échéancier — utile pour un appel exceptionnel qui ne doit pas modifier le plan de financement existant.

Seule route à renvoyer details, documentsAppels et jeuxDecritures — la liste des écritures comptables déjà générées à partir de cette échéance.