**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Budget operations

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Opérations

## GET /banking/operations

Lister recettes, dépenses et transferts d’affectation

`list_budget_operations`

Opérations analytiques Budget de l’organisation, distinctes des débits/virements bancaires, dons et règlements prestataires. Les scopes budgets:read et budgets:write sont indépendants et attribués explicitement ; les clés limitées à des collectes sont refusées. amountMajor est une chaîne décimale en unités MAJEURES, avec au plus deux décimales, jamais en unités mineures de paiement. L’écriture exige un montant strictement positif ; un zéro historique explicite peut être lu. fromBudgetId/toBudgetId décrivent les comptes input/output natifs ; OTHER est une contrepartie comptable externe, pas un compte bancaire. MAIN est une association ; GENERAL/PRINCIPAL est le budget principal. Les inconnues historiques restent null/UNKNOWN. Aucun appel banque/prestataire, débit, remboursement, déplacement documentaire, copie récurrente, solde de compte ni conversion. La devise actuelle de l’association doit être explicite et correspondre pour une écriture. Aucun secret, snapshot source ni pièce jointe n’est renvoyé. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige budgets:read. assoc/currency obligatoires sélectionnent la devise d’une association actuelle, sans total ni conversion. Trie les UUID par ordre croissant ; after est le dernier UUID renvoyé, que le client conserve avec les mêmes filtres association/devise. Les changements concurrents ne forment pas un snapshot. Une identité historique ambiguë renvoie 409.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "budgets:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "assoc",
  "in": "query",
  "description": "Identifiant obligatoire d’association légale actuelle issu de list_associations.",
  "schema": {
    "type": "string"
  },
  "required": true
}
```

```json
{
  "name": "currency",
  "in": "query",
  "description": "Devise exacte de l’association, obligatoire en minuscules.",
  "schema": {
    "type": "string",
    "pattern": "^[a-z]{3}$"
  },
  "required": true
}
```

```json
{
  "name": "limit",
  "in": "query",
  "description": "Taille de page 1–200, par défaut 50.",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  },
  "required": false
}
```

```json
{
  "name": "after",
  "in": "query",
  "description": "Dernier UUID d’opération renvoyé avec les mêmes filtres association/devise.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": false
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Opération actuelle admise ou résultat durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée, date, montant décimal, UUID, affectation ou version invalide, ou query/body inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : opération, commande ou association indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE ou COMMAND_HISTORY_LIMIT. Aucun réessai automatique ni contournement interne.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR sans diagnostic privé. Une écriture incertaine doit être résolue avec le même commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "budgets:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /banking/operations

Créer une opération comptable manuelle

`create_budget_operation`

Opérations analytiques Budget de l’organisation, distinctes des débits/virements bancaires, dons et règlements prestataires. Les scopes budgets:read et budgets:write sont indépendants et attribués explicitement ; les clés limitées à des collectes sont refusées. amountMajor est une chaîne décimale en unités MAJEURES, avec au plus deux décimales, jamais en unités mineures de paiement. L’écriture exige un montant strictement positif ; un zéro historique explicite peut être lu. fromBudgetId/toBudgetId décrivent les comptes input/output natifs ; OTHER est une contrepartie comptable externe, pas un compte bancaire. MAIN est une association ; GENERAL/PRINCIPAL est le budget principal. Les inconnues historiques restent null/UNKNOWN. Aucun appel banque/prestataire, débit, remboursement, déplacement documentaire, copie récurrente, solde de compte ni conversion. La devise actuelle de l’association doit être explicite et correspondre pour une écriture. Aucun secret, snapshot source ni pièce jointe n’est renvoyé. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige budgets:write. Découvrir les cibles avec list_banking_budgets puis transmettre les couples type/id exacts. INCOME exige uniquement to (OTHER → budget natif, entree=true) ; EXPENSE exige uniquement from (budget → OTHER, entree=false) ; TRANSFER exige from/to distincts (entree=false). Les cibles appartiennent à l’organisation/association et sont disponibles, hors ancien SERVICE et cibles archivées. Les catégories utilisent le normaliseur natif. date est obligatoire en UTC exact YYYY-MM-DDTHH:mm:ss.sssZ ; une date comptable future est autorisée. La commande modifie une seule opération manuelle. Une correction fournit entièrement les champs exposés et exige la version d’une lecture actuelle ; pièces jointes et métadonnées privées sont conservées, convertedAmount est remis à null comme dans l’éditeur natif. Les opérations automatiques, importées comptables ou liées à la banque sont refusées ; utiliser leur parcours autorisé. Le CAS détecte les changements des champs financiers natifs, y compris les éditions internes ; le contrôle des liens bancaires est un préalable, pas une transaction distribuée avec l’interface bancaire interne. commandId est un UUID généré par le client, propre au principal API et à l’organisation. Le réutiliser uniquement avec la demande identique. Un journal privé durable et un marqueur du même document évitent les effets dupliqués. APPLIED renvoie le snapshot acquitté, éventuellement distinct d’une lecture actuelle ultérieure. Les claims exigent acknowledged:true et insertedId exact ; les effets, CAS et finalisations forcent majority+j:true et un acquittement positif du pilote. Un acquittement perdu, absent ou false donne COMMAND_UNCERTAIN ; seule une lecture ultérieure peut résoudre le marqueur durable, sans répéter un effet. COMMAND_UNCERTAIN n’autorise jamais un nouvel ID ni un réessai automatique : utiliser get_budget_operation_command pour récupération en lecture seule. La même commande n’est jamais exécutée une seconde fois.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "budgets:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_3e4a1cef5aa9e1e60d5c"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Opération actuelle admise ou résultat durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée, date, montant décimal, UUID, affectation ou version invalide, ou query/body inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : opération, commande ou association indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE ou COMMAND_HISTORY_LIMIT. Aucun réessai automatique ni contournement interne.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR sans diagnostic privé. Une écriture incertaine doit être résolue avec le même commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "budgets:write",
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /banking/operations/{id}

Lire une opération comptable et sa version

`get_budget_operation`

Opérations analytiques Budget de l’organisation, distinctes des débits/virements bancaires, dons et règlements prestataires. Les scopes budgets:read et budgets:write sont indépendants et attribués explicitement ; les clés limitées à des collectes sont refusées. amountMajor est une chaîne décimale en unités MAJEURES, avec au plus deux décimales, jamais en unités mineures de paiement. L’écriture exige un montant strictement positif ; un zéro historique explicite peut être lu. fromBudgetId/toBudgetId décrivent les comptes input/output natifs ; OTHER est une contrepartie comptable externe, pas un compte bancaire. MAIN est une association ; GENERAL/PRINCIPAL est le budget principal. Les inconnues historiques restent null/UNKNOWN. Aucun appel banque/prestataire, débit, remboursement, déplacement documentaire, copie récurrente, solde de compte ni conversion. La devise actuelle de l’association doit être explicite et correspondre pour une écriture. Aucun secret, snapshot source ni pièce jointe n’est renvoyé. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige budgets:read. Ne certifie pas que l’opération est modifiable : liens bancaires et origine comptable sont revérifiés avant correction. Opérations absentes, supprimées et étrangères partagent le même 404.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "budgets:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "description": "UUID local d’opération issu de list_budget_operations ou d’un reçu de commande ; distinct d’une transaction bancaire, d’un paiement, d’une association et d’un budget.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Opération actuelle admise ou résultat durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée, date, montant décimal, UUID, affectation ou version invalide, ou query/body inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : opération, commande ou association indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE ou COMMAND_HISTORY_LIMIT. Aucun réessai automatique ni contournement interne.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR sans diagnostic privé. Une écriture incertaine doit être résolue avec le même commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "budgets:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PUT /banking/operations/{id}

Corriger une opération et son affectation budgétaire

`correct_budget_operation`

Opérations analytiques Budget de l’organisation, distinctes des débits/virements bancaires, dons et règlements prestataires. Les scopes budgets:read et budgets:write sont indépendants et attribués explicitement ; les clés limitées à des collectes sont refusées. amountMajor est une chaîne décimale en unités MAJEURES, avec au plus deux décimales, jamais en unités mineures de paiement. L’écriture exige un montant strictement positif ; un zéro historique explicite peut être lu. fromBudgetId/toBudgetId décrivent les comptes input/output natifs ; OTHER est une contrepartie comptable externe, pas un compte bancaire. MAIN est une association ; GENERAL/PRINCIPAL est le budget principal. Les inconnues historiques restent null/UNKNOWN. Aucun appel banque/prestataire, débit, remboursement, déplacement documentaire, copie récurrente, solde de compte ni conversion. La devise actuelle de l’association doit être explicite et correspondre pour une écriture. Aucun secret, snapshot source ni pièce jointe n’est renvoyé. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige budgets:write. Découvrir les cibles avec list_banking_budgets puis transmettre les couples type/id exacts. INCOME exige uniquement to (OTHER → budget natif, entree=true) ; EXPENSE exige uniquement from (budget → OTHER, entree=false) ; TRANSFER exige from/to distincts (entree=false). Les cibles appartiennent à l’organisation/association et sont disponibles, hors ancien SERVICE et cibles archivées. Les catégories utilisent le normaliseur natif. date est obligatoire en UTC exact YYYY-MM-DDTHH:mm:ss.sssZ ; une date comptable future est autorisée. La commande modifie une seule opération manuelle. Une correction fournit entièrement les champs exposés et exige la version d’une lecture actuelle ; pièces jointes et métadonnées privées sont conservées, convertedAmount est remis à null comme dans l’éditeur natif. Les opérations automatiques, importées comptables ou liées à la banque sont refusées ; utiliser leur parcours autorisé. Le CAS détecte les changements des champs financiers natifs, y compris les éditions internes ; le contrôle des liens bancaires est un préalable, pas une transaction distribuée avec l’interface bancaire interne. commandId est un UUID généré par le client, propre au principal API et à l’organisation. Le réutiliser uniquement avec la demande identique. Un journal privé durable et un marqueur du même document évitent les effets dupliqués. APPLIED renvoie le snapshot acquitté, éventuellement distinct d’une lecture actuelle ultérieure. Les claims exigent acknowledged:true et insertedId exact ; les effets, CAS et finalisations forcent majority+j:true et un acquittement positif du pilote. Un acquittement perdu, absent ou false donne COMMAND_UNCERTAIN ; seule une lecture ultérieure peut résoudre le marqueur durable, sans répéter un effet. COMMAND_UNCERTAIN n’autorise jamais un nouvel ID ni un réessai automatique : utiliser get_budget_operation_command pour récupération en lecture seule. La même commande n’est jamais exécutée une seconde fois.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "budgets:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "description": "UUID local d’opération issu de list_budget_operations ou d’un reçu de commande ; distinct d’une transaction bancaire, d’un paiement, d’une association et d’un budget.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_adaa5d7e720abfc1922b"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Opération actuelle admise ou résultat durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée, date, montant décimal, UUID, affectation ou version invalide, ou query/body inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : opération, commande ou association indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE ou COMMAND_HISTORY_LIMIT. Aucun réessai automatique ni contournement interne.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR sans diagnostic privé. Une écriture incertaine doit être résolue avec le même commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "budgets:write",
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /banking/operation-commands/{commandId}

Résoudre une commande comptable sans répéter son écriture

`get_budget_operation_command`

Opérations analytiques Budget de l’organisation, distinctes des débits/virements bancaires, dons et règlements prestataires. Les scopes budgets:read et budgets:write sont indépendants et attribués explicitement ; les clés limitées à des collectes sont refusées. amountMajor est une chaîne décimale en unités MAJEURES, avec au plus deux décimales, jamais en unités mineures de paiement. L’écriture exige un montant strictement positif ; un zéro historique explicite peut être lu. fromBudgetId/toBudgetId décrivent les comptes input/output natifs ; OTHER est une contrepartie comptable externe, pas un compte bancaire. MAIN est une association ; GENERAL/PRINCIPAL est le budget principal. Les inconnues historiques restent null/UNKNOWN. Aucun appel banque/prestataire, débit, remboursement, déplacement documentaire, copie récurrente, solde de compte ni conversion. La devise actuelle de l’association doit être explicite et correspondre pour une écriture. Aucun secret, snapshot source ni pièce jointe n’est renvoyé. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige budgets:write et ne concerne que la commande du principal actuel. APPLIED exige le marqueur correspondant sur l’opération actuelle de l’organisation ; REJECTED décrit un refus CAS connu. Une preuve absente donne COMMAND_UNCERTAIN, jamais une autorisation de rejouer. Les données sont le snapshot acquitté initial, pas l’état actuel. Aucun paramètre de requête n’est accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "budgets:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "commandId",
  "in": "path",
  "description": "UUID de commande initial utilisé avec ce principal API. Le conserver après un délai dépassé.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Opération actuelle admise ou résultat durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée, date, montant décimal, UUID, affectation ou version invalide, ou query/body inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, organisation désactivée ou CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : opération, commande ou association indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE ou COMMAND_HISTORY_LIMIT. Aucun réessai automatique ni contournement interne.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR sans diagnostic privé. Une écriture incertaine doit être résolue avec le même commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "budgets:write",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "BudgetOperationsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BudgetOperation"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "hasMore",
              "after"
            ],
            "properties": {
              "hasMore": {
                "type": "boolean"
              },
              "after": {
                "type": "string",
                "nullable": true,
                "format": "uuid"
              }
            }
          }
        }
      },
      "BudgetOperation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "assoc",
          "currency",
          "kind",
          "amountMajor",
          "label",
          "date",
          "fromBudgetId",
          "toBudgetId",
          "categories",
          "version",
          "editing"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "assoc": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "kind": {
            "type": "string",
            "enum": [
              "INCOME",
              "EXPENSE",
              "TRANSFER",
              "UNKNOWN"
            ]
          },
          "amountMajor": {
            "type": "string",
            "nullable": true
          },
          "label": {
            "type": "string",
            "nullable": true
          },
          "date": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "fromBudgetId": {
            "type": "string",
            "nullable": true
          },
          "toBudgetId": {
            "type": "string",
            "nullable": true
          },
          "categories": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          },
          "version": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "editing": {
            "type": "string",
            "enum": [
              "MANUAL",
              "AUTO_OPERATION",
              "ACCOUNTING_OWNED"
            ]
          }
        }
      },
      "BudgetOperationError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      },
      "UnisoftRequest_3e4a1cef5aa9e1e60d5c": {
        "type": "object",
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "assoc": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "INCOME",
              "EXPENSE",
              "TRANSFER"
            ]
          },
          "amountMajor": {
            "type": "string",
            "pattern": "^(0|[1-9]\\d*)(?:\\.\\d{1,2})?$"
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "date": {
            "type": "string",
            "format": "date-time"
          },
          "from": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "LIVRET",
                  "GROUPE_LIVRET",
                  "CAISSE",
                  "CAMPAGNE"
                ]
              },
              "id": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "to": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "LIVRET",
                  "GROUPE_LIVRET",
                  "CAISSE",
                  "CAMPAGNE"
                ]
              },
              "id": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "categories": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          }
        },
        "required": [
          "commandId",
          "assoc",
          "currency",
          "kind",
          "amountMajor",
          "label",
          "date"
        ],
        "additionalProperties": false
      },
      "BudgetOperationCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "commandId",
          "outcome"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "APPLIED",
              "REJECTED"
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/BudgetOperation"
          },
          "error": {
            "type": "string"
          }
        }
      },
      "BudgetOperationResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/BudgetOperation"
          }
        }
      },
      "UnisoftRequest_adaa5d7e720abfc1922b": {
        "type": "object",
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "assoc": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "kind": {
            "type": "string",
            "enum": [
              "INCOME",
              "EXPENSE",
              "TRANSFER"
            ]
          },
          "amountMajor": {
            "type": "string",
            "pattern": "^(0|[1-9]\\d*)(?:\\.\\d{1,2})?$"
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "date": {
            "type": "string",
            "format": "date-time"
          },
          "from": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "LIVRET",
                  "GROUPE_LIVRET",
                  "CAISSE",
                  "CAMPAGNE"
                ]
              },
              "id": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "to": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "LIVRET",
                  "GROUPE_LIVRET",
                  "CAISSE",
                  "CAMPAGNE"
                ]
              },
              "id": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "categories": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          },
          "expectedVersion": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "commandId",
          "assoc",
          "currency",
          "kind",
          "amountMajor",
          "label",
          "date",
          "expectedVersion"
        ],
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
