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

# SEPA mandates

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## GET /sepa/mandates

Lister les statuts des mandats SEPA sans données privées

`list_sepa_mandates`

Les scopes financiers sont attribués explicitement et vérifiés séparément ; les clés limitées à des collectes sont refusées. L’organisation, l’association, l’activation SEPA et les objets liés sont réadmis actuellement avec des identités scalaires. Les montants sont en unités MINEURES EUR (5000 = 50 EUR), sans conversion ni zéro inventé. Les inconnues restent null/UNKNOWN. USABLE décrit la règle native ACTIVE et 36 mois d’utilisation, jamais une acceptation bancaire ni un règlement. Les réponses JSON excluent IBAN, comptes bancaires, RUM, identité du payeur/donateur, signature, document, réglages, jeton, secret réutilisable, XML et erreur privée. Les GET lisent uniquement les données persistées, sans génération, récupération native mutante, initialisation, index, fournisseur, daemon, notification ni paiement. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige sepa:read et abonnements:read. Identifiant de mandat distinct de celui de l’abonnement ; association actuelle obligatoire.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "assoc",
  "in": "query",
  "required": true,
  "description": "Association actuelle MAIN ou UUID.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "name": "after",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de mandat qualifiées ou reçu natif établi.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateList"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Demande invalide : identifiant/UUID, commande, révision/hash, sélection, date, ordinal, motif, pagination, champ/query inconnu ou corps GET non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Scope financier indépendant absent, clé limitée aux collectes, organisation désactivée ou acteur API indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource ou preuve explicite d’export absente pour le principal, l’organisation et l’association actuels.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Propriété/historique ambigu ; précondition native refusée ; échéancier, aperçu, XML, paiement, mandat, notification ou configuration modifiés ; fence/verrou ; commande réutilisée ou preuve incertaine. Conserver l’ID initial, sans nouvel ID ni réessai automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur interne sans XML, donnée bancaire/personnelle ni diagnostic privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Index natifs existants ou chiffrement indisponibles ; aucune migration automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "sepa:read",
  "x-unisoft-additional-scopes": [
    "abonnements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /sepa/mandates/{id}

Lire le statut d’un mandat SEPA

`get_sepa_mandate`

Les scopes financiers sont attribués explicitement et vérifiés séparément ; les clés limitées à des collectes sont refusées. L’organisation, l’association, l’activation SEPA et les objets liés sont réadmis actuellement avec des identités scalaires. Les montants sont en unités MINEURES EUR (5000 = 50 EUR), sans conversion ni zéro inventé. Les inconnues restent null/UNKNOWN. USABLE décrit la règle native ACTIVE et 36 mois d’utilisation, jamais une acceptation bancaire ni un règlement. Les réponses JSON excluent IBAN, comptes bancaires, RUM, identité du payeur/donateur, signature, document, réglages, jeton, secret réutilisable, XML et erreur privée. Les GET lisent uniquement les données persistées, sans génération, récupération native mutante, initialisation, index, fournisseur, daemon, notification ni paiement. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Exige sepa:read et abonnements:read. Identifiant de mandat distinct de celui de l’abonnement ; association actuelle obligatoire.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128
  }
}
```

```json
{
  "name": "assoc",
  "in": "query",
  "required": true,
  "description": "Association actuelle MAIN ou UUID.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 128
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de mandat qualifiées ou reçu natif établi.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Demande invalide : identifiant/UUID, commande, révision/hash, sélection, date, ordinal, motif, pagination, champ/query inconnu ou corps GET non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Scope financier indépendant absent, clé limitée aux collectes, organisation désactivée ou acteur API indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource ou preuve explicite d’export absente pour le principal, l’organisation et l’association actuels.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Propriété/historique ambigu ; précondition native refusée ; échéancier, aperçu, XML, paiement, mandat, notification ou configuration modifiés ; fence/verrou ; commande réutilisée ou preuve incertaine. Conserver l’ID initial, sans nouvel ID ni réessai automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur interne sans XML, donnée bancaire/personnelle ni diagnostic privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Index natifs existants ou chiffrement indisponibles ; aucune migration automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "sepa:read",
  "x-unisoft-additional-scopes": [
    "abonnements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /sepa/subscriptions/{id}/replacement-mandates

Trouver les mandats de remplacement natifs déjà signés

`list_sepa_replacement_mandates`

Les scopes financiers sont attribués explicitement et vérifiés séparément ; les clés limitées à des collectes sont refusées. L’organisation, l’association, l’activation SEPA et les objets liés sont réadmis actuellement avec des identités scalaires. Les montants sont en unités MINEURES EUR (5000 = 50 EUR), sans conversion ni zéro inventé. Les inconnues restent null/UNKNOWN. USABLE décrit la règle native ACTIVE et 36 mois d’utilisation, jamais une acceptation bancaire ni un règlement. Les réponses JSON excluent IBAN, comptes bancaires, RUM, identité du payeur/donateur, signature, document, réglages, jeton, secret réutilisable, XML et erreur privée. Les GET lisent uniquement les données persistées, sans génération, récupération native mutante, initialisation, index, fournisseur, daemon, notification ni paiement. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Les candidats sont des mandats natifs déjà signés, utilisables, dont montant, devise, durée, donateur et libellé concordent ; le contrat d’origine est ACTIVE et sans paiement. Leur liste exige aussi paiements:read. La création d’une demande sécurisée de renouvellement reste UNAVAILABLE/SECURE_RENEWAL_OWNER_REQUIRED : le propriétaire d’enregistrement actuel exige réellement la source ADMIN, tandis qu’un checkout public crée un autre contrat actif susceptible de démarrer. Aucun faux ADMIN ni second checkout présenté comme renouvellement. Faire signer/enregistrer par le parcours existant autorisé avant de sélectionner un candidat. Exige sepa:read et abonnements:read en plus de paiements:read.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "sepa:read",
  "additional": [
    "abonnements:read",
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID actuel de l’abonnement SEPA_XML.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de mandat qualifiées ou reçu natif établi.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateCandidates"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Demande invalide : identifiant/UUID, commande, révision/hash, sélection, date, ordinal, motif, pagination, champ/query inconnu ou corps GET non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Scope financier indépendant absent, clé limitée aux collectes, organisation désactivée ou acteur API indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource ou preuve explicite d’export absente pour le principal, l’organisation et l’association actuels.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Propriété/historique ambigu ; précondition native refusée ; échéancier, aperçu, XML, paiement, mandat, notification ou configuration modifiés ; fence/verrou ; commande réutilisée ou preuve incertaine. Conserver l’ID initial, sans nouvel ID ni réessai automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur interne sans XML, donnée bancaire/personnelle ni diagnostic privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Index natifs existants ou chiffrement indisponibles ; aucune migration automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "sepa:read",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /sepa/subscriptions/{id}/mandate-replacement

Appliquer un mandat signé de remplacement par son propriétaire natif

`replace_sepa_subscription_mandate`

Les scopes financiers sont attribués explicitement et vérifiés séparément ; les clés limitées à des collectes sont refusées. L’organisation, l’association, l’activation SEPA et les objets liés sont réadmis actuellement avec des identités scalaires. Les montants sont en unités MINEURES EUR (5000 = 50 EUR), sans conversion ni zéro inventé. Les inconnues restent null/UNKNOWN. USABLE décrit la règle native ACTIVE et 36 mois d’utilisation, jamais une acceptation bancaire ni un règlement. Les réponses JSON excluent IBAN, comptes bancaires, RUM, identité du payeur/donateur, signature, document, réglages, jeton, secret réutilisable, XML et erreur privée. Les GET lisent uniquement les données persistées, sans génération, récupération native mutante, initialisation, index, fournisseur, daemon, notification ni paiement. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Les candidats sont des mandats natifs déjà signés, utilisables, dont montant, devise, durée, donateur et libellé concordent ; le contrat d’origine est ACTIVE et sans paiement. Leur liste exige aussi paiements:read. La création d’une demande sécurisée de renouvellement reste UNAVAILABLE/SECURE_RENEWAL_OWNER_REQUIRED : le propriétaire d’enregistrement actuel exige réellement la source ADMIN, tandis qu’un checkout public crée un autre contrat actif susceptible de démarrer. Aucun faux ADMIN ni second checkout présenté comme renouvellement. Faire signer/enregistrer par le parcours existant autorisé avant de sélectionner un candidat. La commande exige un commandId UUID généré par le client, propre à l’organisation et au principal API, et les préconditions actuelles de l’opération. Le vrai propriétaire natif et son commandBus restent utilisés ; l’acteur APIKEY_<id de clé> est visible, SYSTEM est uniquement sa classification d’audit et n’accorde aucun droit. Aucun ADMIN n’est fabriqué. Les index natifs existants sont vérifiés sans migration. Le fence commun de chaque abonnement est acquis avant l’entrée du propriétaire ; il est supprimé uniquement après achèvement natif acquitté et finalisation acquittée du journal. Une incertitude le conserve, sans TTL, vol ni nettoyage en GET. Les claims exigent acknowledged:true et insertedId exact ; les écritures natives et finales forcent majority+j:true et un acquittement positif du pilote. Acquittement perdu, absent ou false : SEPA_COMMAND_UNCERTAIN. Une lecture ultérieure peut résoudre une preuve native DONE sans nouvel effet. Rejeu identique : lecture du reçu seulement ; contenu différent : refus. Conserver l’ID initial, sans nouvel ID automatique, réessai financier ni reprise native implicite. Exige sepa:mandates:write, sepa:read, abonnements:read, paiements:read et abonnements:write. expectedRevision et expectedMandateId sont obligatoires. Les verrous du repository canonique des deux contrats sont acquis et la révision est vérifiée sous verrou ; une entrée native interrompue conserve ces verrous pour examen. Appelle replaceMandate, conserve l’historique, passe l’ancien mandat à SUPERSEDED et le contrat d’origine du candidat à REPLACED. Les échéances PREPARED/RESERVED/EXPORTED bloquent. Aucun débit rejoué, aucune reprise implicite de MANUAL/PAUSE.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "sepa:mandates:write",
  "additional": [
    "sepa:read",
    "abonnements:read",
    "paiements:read",
    "abonnements:write"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID actuel de l’abonnement SEPA_XML.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "expectedMandateId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "newMandateId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "reason": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "commandId",
          "expectedRevision",
          "expectedMandateId",
          "newMandateId",
          "reason"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de mandat qualifiées ou reçu natif établi.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateCommand"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Demande invalide : identifiant/UUID, commande, révision/hash, sélection, date, ordinal, motif, pagination, champ/query inconnu ou corps GET non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Scope financier indépendant absent, clé limitée aux collectes, organisation désactivée ou acteur API indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource ou preuve explicite d’export absente pour le principal, l’organisation et l’association actuels.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Propriété/historique ambigu ; précondition native refusée ; échéancier, aperçu, XML, paiement, mandat, notification ou configuration modifiés ; fence/verrou ; commande réutilisée ou preuve incertaine. Conserver l’ID initial, sans nouvel ID ni réessai automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur interne sans XML, donnée bancaire/personnelle ni diagnostic privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Index natifs existants ou chiffrement indisponibles ; aucune migration automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "sepa:mandates:write",
  "x-unisoft-additional-scopes": [
    "sepa:read",
    "abonnements:read",
    "paiements:read",
    "abonnements:write"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /sepa/mandate-commands/{commandId}

Lire un reçu natif de remplacement de mandat sans réessai

`get_sepa_mandate_command`

Les scopes financiers sont attribués explicitement et vérifiés séparément ; les clés limitées à des collectes sont refusées. L’organisation, l’association, l’activation SEPA et les objets liés sont réadmis actuellement avec des identités scalaires. Les montants sont en unités MINEURES EUR (5000 = 50 EUR), sans conversion ni zéro inventé. Les inconnues restent null/UNKNOWN. USABLE décrit la règle native ACTIVE et 36 mois d’utilisation, jamais une acceptation bancaire ni un règlement. Les réponses JSON excluent IBAN, comptes bancaires, RUM, identité du payeur/donateur, signature, document, réglages, jeton, secret réutilisable, XML et erreur privée. Les GET lisent uniquement les données persistées, sans génération, récupération native mutante, initialisation, index, fournisseur, daemon, notification ni paiement. Arguments inconnus et corps GET non vides sont refusés. L’authentification partagée peut enregistrer l’usage de la clé. Les candidats sont des mandats natifs déjà signés, utilisables, dont montant, devise, durée, donateur et libellé concordent ; le contrat d’origine est ACTIVE et sans paiement. Leur liste exige aussi paiements:read. La création d’une demande sécurisée de renouvellement reste UNAVAILABLE/SECURE_RENEWAL_OWNER_REQUIRED : le propriétaire d’enregistrement actuel exige réellement la source ADMIN, tandis qu’un checkout public crée un autre contrat actif susceptible de démarrer. Aucun faux ADMIN ni second checkout présenté comme renouvellement. Faire signer/enregistrer par le parcours existant autorisé avant de sélectionner un candidat. Exige les cinq scopes de la commande de remplacement. Lecture seule du journal du principal et de sa preuve native DONE ; aucun verrou acquis/libéré, remplacement, enregistrement ou effet financier. Une preuve manquante reste SEPA_COMMAND_UNCERTAIN.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "sepa:mandates:write",
  "additional": [
    "sepa:read",
    "abonnements:read",
    "paiements:read",
    "abonnements:write"
  ]
}
```

### Paramètres

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Métadonnées de mandat qualifiées ou reçu natif établi.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateCommand"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Demande invalide : identifiant/UUID, commande, révision/hash, sélection, date, ordinal, motif, pagination, champ/query inconnu ou corps GET non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Scope financier indépendant absent, clé limitée aux collectes, organisation désactivée ou acteur API indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource ou preuve explicite d’export absente pour le principal, l’organisation et l’association actuels.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Propriété/historique ambigu ; précondition native refusée ; échéancier, aperçu, XML, paiement, mandat, notification ou configuration modifiés ; fence/verrou ; commande réutilisée ou preuve incertaine. Conserver l’ID initial, sans nouvel ID ni réessai automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur interne sans XML, donnée bancaire/personnelle ni diagnostic privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Index natifs existants ou chiffrement indisponibles ; aucune migration automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SepaMandateError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "sepa:mandates:write",
  "x-unisoft-additional-scopes": [
    "sepa:read",
    "abonnements:read",
    "paiements:read",
    "abonnements:write"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "SepaMandateList": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SepaMandate"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "hasMore",
              "after"
            ],
            "properties": {
              "hasMore": {
                "type": "boolean"
              },
              "after": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "nullable": true
              }
            }
          }
        }
      },
      "SepaMandate": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "assoc",
          "state",
          "usability",
          "subscriptionId",
          "amountMinor",
          "currency",
          "signedAt",
          "lastUsedAt",
          "revision"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "state": {
            "type": "string",
            "enum": [
              "DRAFT",
              "ACTIVE",
              "REVOKED",
              "EXPIRED",
              "SUPERSEDED",
              "UNUSABLE",
              "UNKNOWN"
            ]
          },
          "usability": {
            "type": "string",
            "enum": [
              "USABLE",
              "UNUSABLE",
              "UNKNOWN"
            ]
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "amountMinor": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "currency": {
            "type": "string",
            "enum": [
              "eur",
              null
            ],
            "nullable": true
          },
          "signedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastUsedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        }
      },
      "SepaMandateError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      },
      "SepaMandateResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SepaMandate"
          }
        }
      },
      "SepaMandateCandidates": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "context",
          "secureRequest"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SepaMandate"
            }
          },
          "context": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "subscriptionId",
              "expectedMandateId",
              "revision"
            ],
            "properties": {
              "subscriptionId": {
                "type": "string",
                "format": "uuid"
              },
              "expectedMandateId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "revision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              }
            }
          },
          "secureRequest": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "availability",
              "reason"
            ],
            "properties": {
              "availability": {
                "type": "string",
                "enum": [
                  "UNAVAILABLE"
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "SECURE_RENEWAL_OWNER_REQUIRED"
                ]
              }
            }
          }
        }
      },
      "SepaMandateCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "commandId",
          "outcome",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "APPLIED"
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "subscriptionId",
              "mandateId",
              "state"
            ],
            "properties": {
              "subscriptionId": {
                "type": "string",
                "format": "uuid"
              },
              "mandateId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "state": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
