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

# Auctions

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## POST /auctions/{id}/lots/{lotId}/bids

Enregistrer une mise pour un contact existant

`place_auction_bid`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:bid en plus des lectures d’enchères/contacts. Appelle une fois le vrai moteur poserMise avec amount, maxAmount/discreet facultatifs, profil du contact et acteur API explicite. Le moteur conserve ses règles de tribu, lots aveugles, offres automatiques, paliers, concurrence, prolongation et notification du meneur dépassé. Le plafond est une entrée confidentielle, jamais le prix affiché ni l’obligation finale ; maxAmount doit être null ou au moins amount, et est refusé pour un lot aveugle. Une mise acceptée peut être battue immédiatement ou ne pas mener ; le reçu n’identifie aucun gagnant ni position garantie. Un refus natif connu produit REJECTED et un code sûr, sans offre acceptée. Ne pas augmenter le montant ni changer de clé automatiquement. Aucune promesse, aucun paiement ni adjudication n’est inventé pour satisfaire la mise.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:bid",
  "additional": [
    "auctions:read",
    "contacts:read"
  ]
}
```

### Paramètres

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

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "contactId": {
            "type": "string",
            "format": "uuid"
          },
          "amount": {
            "type": "number",
            "maximum": 1000000000,
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "maxAmount": {
            "type": "number",
            "maximum": 1000000000,
            "minimum": 0,
            "exclusiveMinimum": true,
            "nullable": true
          },
          "discreet": {
            "type": "boolean"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "contactId",
          "amount"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

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

## POST /auctions/{id}/lots/{lotId}/bids/{bidId}/withdraw

Retirer une mise active avec le moteur natif

`withdraw_auction_bid`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:bid, les lectures d’enchères/contacts et un reason non vide. bidId doit être une mise ACTIVE de ce lot/vente exact. Le propriétaire retirerMise conserve la mise RETIREE, retire ses réponses automatiques et recalcule le meneur depuis les offres réellement restantes ; les plafonds ne sortent jamais. Les candidats/réponses sont admis avant mutation. Les achats fixes/immédiats et lots déjà adjugés sont refusés : retirer une mise ne restitue pas un stock et n’annule pas une adjudication financière. Aucun historique, promesse ou paiement n’est effacé ou remboursé.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:bid",
  "additional": [
    "auctions:read",
    "contacts:read"
  ]
}
```

### Paramètres

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

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

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

### Corps de la requête

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

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

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

## POST /auctions/{id}/lots/{lotId}/awards

Enregistrer un résultat oral ou décidé par un responsable

`record_auction_award`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:adjudicate, promesses:write, les lectures d’enchères/contacts et acknowledgePledgesAndNotifications:true. Appelle saisirResultatOral avec contact et montant positif explicitement choisis. États natifs admis : FINALE_ORALE, CLOS, OUVERT, INVENDU et A_VERIFIER ; cela peut attribuer le lot encore ouvert et ne constitue donc pas une mise ordinaire. Le propriétaire efface l’attribution de groupe pour ce gagnant choisi, enregistre l’origine ORAL et matérialise l’adjudication. Cette étape peut créer des promesses, liens et notifications aux gagnants. Elle n’enregistre aucun encaissement, ne réutilise aucun moyen du contact et ne prouve pas le paiement. Une matérialisation manquante/incertaine reste UNKNOWN et n’autorise pas une promesse ordinaire en doublon.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:adjudicate",
  "additional": [
    "auctions:read",
    "contacts:read",
    "promesses:write"
  ]
}
```

### Paramètres

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

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "contactId": {
            "type": "string",
            "format": "uuid"
          },
          "amount": {
            "type": "number",
            "maximum": 1000000000,
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "acknowledgePledgesAndNotifications": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "contactId",
          "amount",
          "acknowledgePledgesAndNotifications"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "auctions:adjudicate",
  "x-unisoft-additional-scopes": [
    "auctions:read",
    "contacts:read",
    "promesses:write"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /auctions/{id}/lots/{lotId}/awards/validate

Valider un lot en attente d’adjudication

`validate_auction_award`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:adjudicate, promesses:write, les lectures d’enchères/contacts et acknowledgePledgesAndNotifications:true. Seul un lot A_VERIFIER avec un meneur exact et un montant courant positif est admis. Le serveur transmet ces valeurs natives observées à saisirResultatOral comme dans la route du responsable, sans remplacement de gagnant/montant par le client. L’adjudication/matérialisation peut créer promesses, liens et emails. C’est une décision explicite, pas une lecture ni un paiement.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:adjudicate",
  "additional": [
    "auctions:read",
    "contacts:read",
    "promesses:write"
  ]
}
```

### Paramètres

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

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgePledgesAndNotifications": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgePledgesAndNotifications"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "auctions:adjudicate",
  "x-unisoft-additional-scopes": [
    "auctions:read",
    "contacts:read",
    "promesses:write"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /auctions/{id}/lots/{lotId}/awards/cancel

Annuler une adjudication sans effacer l’argent reçu

`cancel_auction_award`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:adjudicate, promesses:write, promesses:read, paiements:read, les lectures d’enchères/contacts, reason et acknowledgeCancellation:true. Les relations actuelles adjudication/promesses doivent être exactes. Le contrôle natif recherchant une promesse par son ID, l’identité globale unique de chaque ID est vérifiée dans la même organisation. L’admission existante d’historique des promesses et son propriétaire canonique de solde sont réutilisés ; tout versement imputé observé bloque l’annulation (VERSEMENT_DEJA_IMPUTE). Les sources financières inconnues sont refusées, jamais zéro par défaut. annulerAdjudication applique ensuite sa propre garde native, passe les promesses CANCELED et le lot INVENDU en conservant l’historique. Aucun paiement n’est supprimé ou remboursé et aucun règlement bancaire n’est affirmé. Un refus natif après effets possibles reste UNKNOWN.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:adjudicate",
  "additional": [
    "auctions:read",
    "contacts:read",
    "promesses:write",
    "promesses:read",
    "paiements:read"
  ]
}
```

### Paramètres

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

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

### Corps de la requête

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

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "auctions:adjudicate",
  "x-unisoft-additional-scopes": [
    "auctions:read",
    "contacts:read",
    "promesses:write",
    "promesses:read",
    "paiements:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /auctions/{id}/lots/{lotId}/awards/reassign

Réattribuer un lot au prochain enchérisseur réel

`reassign_auction_award`

Mutation administrative autorisée pour une vente id et son lotId exact dans l’organisation courante. Tous les montants de mise/adjudication sont en unités MAJOR avec au plus deux décimales (180 EUR signifie 180, pas les 18000 unités mineures d’un paiement), dans la devise observée de la vente. Les UUID de contact doivent désigner des contacts actuels autorisés ; un nom de bénéficiaire ou alias n’est pas un payeur. Chaque appel exige auctions:read, contacts:read et les droits distincts de l’opération. Les clés limitées à des collectes sont refusées. Lire get_auction_command_context et transmettre sa revision en expectedRevision avec un UUID idempotencyKey stable pour l’action voulue. Le journal partagé durable et le verrou de vente précèdent le moteur natif. Un rejeu identique rend seulement le reçu, sans appel propriétaire ; changer action, contenu ou lot sous la même clé est refusé. success:true accuse le traitement du reçu : lire state et journalState, au-delà du seul HTTP 200. COMPLETED est un acquittement natif de l’action d’enchère, jamais un paiement ; REJECTED est un refus confirmé de l’effet métier demandé (une réservation technique native d’idempotence peut subsister). UNKNOWN/RUNNING/ADMITTING et journalState UNCONFIRMED peuvent inclure des effets partiels et n’autorisent aucun rejeu ; canRetry vaut false. Lire get_auction_command, sans changer de clé pour contourner un verrou incertain. L’interface humaine et le daemon natifs ne deviennent pas transactionnels. Les offres actives sont admises jusqu’à 2000 par lot ; identités, relations, valeurs financières ambiguës ou sources trop grandes sont refusées avant l’effet. Aucun groupe/session, achat fixe/immédiat ou changement de bénéficiaire n’est implicite. Identités, plafonds privés, données prestataire, URL de capacité et erreurs brutes restent exclus des réponses. paymentStatus vaut toujours NOT_OBSERVED. Exige auctions:adjudicate, promesses:write, promesses:read, paiements:read, les lectures d’enchères/contacts, reason et acknowledgeCancellationAndNewPledges:true. Reprend les offres actives réelles et le tri natif reattribuerAuSuivant, sans montant ni partage inventés. Candidats, contacts, groupes et relations financières sont admis ; un versement imputé sur l’ancienne adjudication bloque l’action. Un autre candidat enregistré est requis avant de commencer. Le propriétaire peut annuler les anciennes promesses, attribuer l’offre suivante, matérialiser les nouvelles promesses/liens et notifier son gagnant. AUCUN_SUIVANT peut survenir après annulation lors d’une concurrence : tout effet partiel possible reste UNKNOWN et conserve le verrou. Ce n’est ni une relance automatique pour impayé ni un remboursement.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:adjudicate",
  "additional": [
    "auctions:read",
    "contacts:read",
    "promesses:write",
    "promesses:read",
    "paiements:read"
  ]
}
```

### Paramètres

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

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

### Corps de la requête

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

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu enregistré de commande d’enchères ; examiner son état.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, du droit, de l’organisation/référence exacte, de la source, de la révision ou du journal. Aucun diagnostic privé ; examiner un reçu incertain sans relancer l’action."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "auctions:adjudicate",
  "x-unisoft-additional-scopes": [
    "auctions:read",
    "contacts:read",
    "promesses:write",
    "promesses:read",
    "paiements:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /auctions

Lister les ventes aux enchères

`list_auction_sales`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Liste les ventes non désactivées et les archives conservées, y compris les brouillons. BROUILLON, OUVERTE, CLOSE et ARCHIVEE décrivent la vente, jamais un état de paiement. limit facultatif : entier de 1 à 50 (50 par défaut) ; after : UUID nextAfter de la page précédente. L’ordre est celui des UUID croissants avec collation simple, pas un ordre chronologique ; hasMore et nextAfter décrivent la page parcourue, jamais un total de vente. Continuer avec le même parent/filtre jusqu’à hasMore false. La position ne donne aucun droit ; les modifications concurrentes peuvent affecter les pages suivantes.

### Authentification

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

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "after",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSalesPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## GET /auctions/{id}

Lire une vente aux enchères

`get_auction_sale`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Lit l’association, la devise observée et les instants enregistrés d’ouverture/clôture. Les paramètres privés du module restent exclus ; aucun slug public n’est résolu.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSaleResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## GET /auctions/{id}/lots

Lister les lots d’une vente aux enchères

`list_auction_lots`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Liste tous les lots enregistrés de la vente autorisée, y compris brouillons et annulations. AUCTION désigne des offres concurrentes ; FIXED désigne des achats de quantités. ONLINE, ORAL_FINAL et ONSITE sont des modes, pas une autorisation de miser. currentAmount reste une observation provisoire, jamais la dette du gagnant ni un paiement. quantityLeft null ne prouve pas un stock illimité. limit facultatif : entier de 1 à 50 (50 par défaut) ; after : UUID nextAfter de la page précédente. L’ordre est celui des UUID croissants avec collation simple, pas un ordre chronologique ; hasMore et nextAfter décrivent la page parcourue, jamais un total de vente. Continuer avec le même parent/filtre jusqu’à hasMore false. La position ne donne aucun droit ; les modifications concurrentes peuvent affecter les pages suivantes.

### Authentification

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

### Permissions requises

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

### Paramètres

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

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

```json
{
  "name": "after",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionLotsPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## PUT /auctions/{id}/lots

Gérer la liste complète des lots d’une vente

`replace_auction_lots`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:write, auctions:read et acknowledgeReplacement:true. Remplace la liste native gérée, au plus 200 lignes, sur une vente BROUILLON ou OUVERTE. Un id fourni doit déjà appartenir à cette vente ; omettre id pour un nouveau lot déterministe dans la commande. label, kind, mode, startPrice et quantity sont requis ; les champs facultatifs absents reprennent leurs défauts natifs, donc fournir les valeurs souhaitées pour une ligne existante. Les lots ADJUGE/A_VERIFIER restent inchangés. Les lots omis avec des mises, ADJUGE/A_VERIFIER/FINALE_ORALE, restent conservés et figurent dans preservedLotIds ; les autres omis passent ANNULE, sans suppression physique. L’adaptation équivalente préserve les quantités fixes déjà vendues et incrémente les versions en édition, sans réinitialiser le stock. Les nouveaux lots héritent des dates/état de la vente. lotIds désigne les lots soumis/créés, pas un registre financier complet. Une panne partielle peut laisser des effets et produire UNKNOWN.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "lots": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/UnisoftRequest_f9fb3ca75a042a162608"
            }
          },
          "acknowledgeReplacement": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "lots",
          "acknowledgeReplacement"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## GET /auctions/lots/{lotId}

Lire un lot aux enchères

`get_auction_lot`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Lit le lot après autorisation de sa vente parente exacte. FINALE_ORALE et A_VERIFIER nécessitent une décision distincte du responsable ; ADJUGE seul ne prouve ni promesse ni encaissement. Les montants administratifs d’un lot aveugle sont accessibles avec auctions:read ; les plafonds automatiques restent toujours exclus.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionLotResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## GET /auctions/lots/{lotId}/bids

Lister les mises et achats enregistrés d’un lot

`list_auction_bids`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Liste offres, retraits et réservations d’idempotence sans identités, plafonds ni détails de refus. ACTIVE est une offre, RETIREE une offre retirée, EN_COURS une réservation non résolue et REFUSEE une tentative refusée ; aucun de ces états ne prouve une adjudication. quantity concerne seulement l’achat à prix fixe ; amount est son total en unités majeures. Les montants d’un lot aveugle sont des observations administratives. Il ne s’agit pas du journal complet des événements. limit facultatif : entier de 1 à 50 (50 par défaut) ; after : UUID nextAfter de la page précédente. L’ordre est celui des UUID croissants avec collation simple, pas un ordre chronologique ; hasMore et nextAfter décrivent la page parcourue, jamais un total de vente. Continuer avec le même parent/filtre jusqu’à hasMore false. La position ne donne aucun droit ; les modifications concurrentes peuvent affecter les pages suivantes.

### Authentification

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

### Permissions requises

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

### Paramètres

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

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

```json
{
  "name": "after",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidsPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## GET /auctions/lots/{lotId}/result

Lire le résultat enregistré d’un lot

`get_auction_result`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. RECORDED_AWARD signifie qu’un objet d’adjudication est enregistré sur un lot ADJUGE ; examiner ses montant, origine et dates éventuellement null. NO_RECORDED_AWARD indique l’absence d’adjudication courante enregistrée, sans exclure une obligation antérieure. FIXED_LOT_COMPLETED est un lot à prix fixe épuisé sans adjudication unique ; ne pas inventer de gagnant ni d’obligation. UNKNOWN conserve une incohérence historique. materializedAt marque une étape du producteur, pas une promesse actuelle validée ni un encaissement. requirement PROMESSE, PAIEMENT ou VALIDATION est une exigence attendue, pas un état payé. paymentStatus vaut toujours NOT_OBSERVED. La lecture des liens, autorisée indépendamment, fournit les références actuelles de promesse ; les outils de promesses/paiements répondent séparément à la question financière.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionResultResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## GET /auctions/lots/{lotId}/settlement-links

Lire un lien de règlement existant d’un lot

`get_auction_settlement_links`

Droit requis : auctions:read (attribution explicite). Observation administrative en lecture seule dans l’organisation authentifiée ; les clés limitées à des campagnes de collecte sont refusées. Une vente est une occasion d’enchères, distincte d’une collecte ou d’une campagne de communication. Lot, mise, adjudication, promesse et paiement sont des objets distincts. Résoudre les UUID existants par des lectures autorisées ; les libellés et slugs publics ne sont pas des identifiants. Tous les montants du domaine enchères, y compris amount d’une mise, sont en unités MAJOR (180 EUR signifie 180), contrairement à amount des paiements en unités mineures. Une devise, valeur historique ou date inconnue reste null, sans EUR supposé ni zéro fabriqué. Les dates sont des instants UTC ISO ; une échéance dépassée ne clôture pas un lot. Cette lecture ne déclenche ni clôture, ni adjudication, ni matérialisation de promesse, ni création de paiement/lien, ni notification, ni rapprochement, ni écriture de cache. Aucune identité de participant/contact/bénéficiaire, composition de groupe, plafond, session ou acteur n’est renvoyée, même avec d’autres droits. Les résultats sont des observations courantes, pas un instantané transactionnel. Paramètres/types inconnus et corps GET non vide : 400 ; objets absents/étrangers ou identités scalaires ambiguës : 404 ; sources bornées incohérentes : 409 AUCTION_DATA_UNAVAILABLE ; échec de persistance : 500 INTERNAL_ERROR. Un refus ou une observation incertaine n’autorise aucune écriture ni relance automatique. Exige aussi auctions:payment-links:read et promesses:read ; ni les droits financiers ordinaires ni auctions:read seul n’autorisent cette capacité URL. Chaque référence de promesse est admise contre son organisation et ses relations exactes au lot et à la vente actuels. Renvoie au plus 100 pledgeIds et uniquement l’URL déjà enregistrée pour une promesse unique, après validation de la cible du lien PAIEMENT et de la base actuelle du site de l’organisation. AVAILABLE prouve un lien enregistré autorisé, jamais son caractère encore payable ni un paiement réussi. NOT_RECORDED indique qu’aucun lien unique n’est enregistré sur cette adjudication ; les participants d’un groupe peuvent avoir leurs propres liens et les achats à prix fixe n’ont pas forcément une adjudication unique. Aucune promesse ni aucun lien manquant n’est créé ou actualisé. Cible absente/étrangère/obsolète : 404 ; références ou URL mal formées/invérifiables : 409. paymentStatus vaut toujours NOT_OBSERVED ; consulter séparément les promesses/paiements autorisés. Ne publier une URL de capacité renvoyée que si l’utilisateur le demande.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:read",
  "additional": [
    "auctions:payment-links:read",
    "promesses:read"
  ]
}
```

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée des enchères.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSettlementLinksResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 401

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 403

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 404

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 409

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

#### HTTP 500

```json
{
  "description": "La requête, les droits, l’appartenance ou la source n’ont pas été admis ; aucune action d’enchère ou financière n’a été effectuée."
}
```

### OpenAPI

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

## POST /auctions/preparations

Préparer une vente aux enchères en brouillon

`prepare_auction_sale`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:write et auctions:read. Crée uniquement une vente native BROUILLON, avec un nouvel UUID déterministe dérivé de l’organisation et de la clé. associationId doit être une association actuelle ; sa devise est observée, jamais EUR par défaut. Le calendrier natif exige les coordonnées réelles de l’organisation et dérive hardCloseAt de la prochaine période chômée moins marginMinutes (60 par défaut) ; closesAt est plafonné à cette limite. Aucun fuseau de remplacement n’est inventé. closesAt doit être futur et opensAt antérieur à la clôture effective. L’option et l’activation du module sont contrôlées. Les règles restent celles des défauts natifs ; les règles personnalisées et images SEO ne sont pas modifiables ici. Un slug canonique en minuscules doit être libre. Aucun lot, publication, mise, promesse ou paiement n’est créé.

### Authentification

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

### Permissions requises

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "slug": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "nullable": true
          },
          "occasion": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "kind": {
                "type": "string",
                "minLength": 0,
                "maxLength": 40,
                "nullable": true
              },
              "date": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              }
            },
            "required": [
              "label"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "opensAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closesAt": {
            "type": "string",
            "format": "date-time"
          },
          "associationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "marginMinutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1440
          }
        },
        "required": [
          "idempotencyKey",
          "label",
          "associationId",
          "closesAt"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## GET /auctions/{id}/command-context

Lire une révision pour commander une vente

`get_auction_command_context`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige seulement auctions:read. Renvoie la révision d’admission et les UUID de lots, sans identité ni plafond. publicationReady signifie seulement qu’une vente BROUILLON a une limite dure enregistrée et au moins un lot ; cela ne garantit ni calendrier, ni droits d’option, ni publication finale. Cette lecture ne réserve, n’initialise et n’écrit rien.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandContextResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## POST /auctions/{id}/edit

Modifier les informations et dates d’une vente

`edit_auction_sale`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:write et auctions:read. Modifie uniquement label, slug canonique, occasion, opensAt et closesAt fournis sur une vente BROUILLON ou OUVERTE. Association, devise et paramètres privés restent figés. closesAt est plafonné au hardCloseAt existant, qui ne peut être prolongé. Modifier les dates de la vente ne réécrit pas rétroactivement les dates de tous les lots. L’écriture conditionnelle vérifie la source admise ; une révision obsolète produit un reçu refusé.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "changes": {
            "type": "object",
            "minProperties": 1,
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "slug": {
                "type": "string",
                "maxLength": 80,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
                "nullable": true
              },
              "occasion": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "kind": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 40,
                    "nullable": true
                  },
                  "date": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "label"
                ],
                "additionalProperties": false,
                "nullable": true
              },
              "opensAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "closesAt": {
                "type": "string",
                "format": "date-time"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "changes"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## POST /auctions/{id}/publish

Publier et ouvrir une vente préparée

`publish_auction_sale`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:publish et auctions:read, droits distincts. Ouvre la vente BROUILLON et ses lots en brouillon avec le propriétaire natif ouvrirVente. Une limite hardCloseAt valide et au moins un lot sont requis ; l’option et l’activation du module sont relues. Le cache natif est invalidé sans message marketing. C’est une ouverture publique réelle, pas un aperçu ni un brouillon conservé. Les échéances natives enregistrées des lots font autorité. Aucun paiement n’est encaissé.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## POST /auctions/{id}/close

Clôturer une vente avec les propriétaires natifs

`close_auction_sale`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:close, auctions:read, auctions:adjudicate et promesses:write, avec acknowledgeAwardsAndPledges:true. Sur une vente OUVERTE, clôture chaque lot OUVERT avec les règles natives : les lots oraux/sur place peuvent passer FINALE_ORALE, les réserves/règles peuvent laisser A_VERIFIER, les lots en ligne peuvent être adjugés. Chaque nouveau lot ADJUGE est matérialisé par le propriétaire d’adjudication, qui peut créer des promesses, liens et emails aux gagnants. Contacts/groupes/parts/promesses actuels sont admis avant de commencer ; aucun partage ni résultat financier n’est recalculé ici. La vente est ensuite enregistrée CLOSE, comme dans la route native. Ce n’est ni un gagnant forcé ni une confirmation de paiement. Une clôture/matérialisation partielle reste UNKNOWN et ne doit pas être relancée sous une nouvelle clé.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "auctions:close",
  "additional": [
    "auctions:read",
    "auctions:adjudicate",
    "promesses:write"
  ]
}
```

### Paramètres

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeAwardsAndPledges": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeAwardsAndPledges"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "auctions:close",
  "x-unisoft-additional-scopes": [
    "auctions:read",
    "auctions:adjudicate",
    "promesses:write"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /auctions/{id}/archive

Archiver une vente sans adjudication

`archive_auction_sale`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige auctions:write, auctions:read et acknowledgeArchive:true. Applique la transition native active:false/state:ARCHIVEE seulement sans lot actuellement ADJUGE. Vente et lots sont conservés ; aucune adjudication, promesse ou paiement n’est annulé ou remboursé. Une vente adjugée est refusée par cette capacité ; ne pas supprimer ses obligations financières pour contourner la garde.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeArchive": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeArchive"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## GET /auctions/commands/{commandId}

Lire le reçu d’une commande d’enchères

`get_auction_command`

Commande administrative d’enchères dans l’organisation authentifiée ; les clés limitées à des collectes sont refusées. Vente, lot, formulaire, collecte et campagne de communication sont des objets distincts. Les prix des enchères sont en unités MAJOR, avec au plus deux décimales ; aucun montant de paiement n’est accepté. Toute mutation exige un UUID idempotencyKey stable. Avant une mutation existante, lire get_auction_command_context et transmettre sa révision SHA-256 expectedRevision (vente et au plus 200 lots). Un journal durable et un verrou d’intégration par vente précèdent les effets. Un rejeu identique restitue le reçu sans rappeler le propriétaire ; changer contenu/action sous la même clé est refusé. success:true accuse le traitement du reçu, pas nécessairement l’effet : examiner state et journalState. COMPLETED signifie que le propriétaire a acquitté la commande ; REJECTED désigne un refus confirmé de l’effet métier demandé (une réservation technique native de mise peut subsister) ; UNKNOWN, RUNNING, ADMITTING et journalState UNCONFIRMED n’autorisent aucun réessai. canRetry vaut toujours false. L’incertitude conserve le verrou : une nouvelle clé ne le contourne pas. Lire get_auction_command ; un reçu absent ne prouve pas que la demande n’a pas commencé. Admission de révision et verrou externe ne rendent pas transactionnels les autres producteurs natifs (interface humaine/daemon). Les effets partiels restent UNKNOWN et ne sont jamais rejoués. Aucune identité de participant, aucun plafond, référence réutilisable ou URL de paiement n’est renvoyé. paymentStatus vaut NOT_OBSERVED : adjudication, promesse et lien ne prouvent pas l’encaissement. Aucune identité ADMIN n’est fabriquée. Les champs/query/types inconnus, listes trop longues et corps de lecture sont refusés. Exige seulement auctions:read. Lit le reçu durable externe du cycle de vie pour cette organisation, sans rejeu, reprise, reprise de verrou obsolète ou lecture/écriture métier. Les commandes absentes et étrangères partagent NOT_FOUND. Un acquittement final perdu peut laisser le reçu RUNNING après un effet ; vérifier la commande initiale et les objets autorisés sans resoumettre.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observation de commande d’enchères ; examiner son état enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 401

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 403

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 404

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 409

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 422

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 500

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

#### HTTP 503

```json
{
  "description": "Échec d’admission de l’entrée, d’un droit indépendant, de l’organisation, de la source actuelle, de la révision ou du journal. Aucun diagnostic privé n’est renvoyé ; examiner un reçu incertain sans le rejouer."
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "schemas": {
      "AuctionBidCommandReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionBidCommandReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "AuctionBidCommandReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "PREPARE",
              "EDIT",
              "REPLACE_LOTS",
              "PUBLISH",
              "CLOSE",
              "ARCHIVE",
              "BID",
              "WITHDRAW_BID",
              "RECORD_AWARD",
              "VALIDATE_AWARD",
              "CANCEL_AWARD",
              "REASSIGN_AWARD"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "ADMITTING",
              "RUNNING",
              "COMPLETED",
              "REJECTED",
              "UNKNOWN"
            ]
          },
          "journalState": {
            "type": "string",
            "enum": [
              "ADMITTING",
              "RUNNING",
              "COMPLETED",
              "REJECTED",
              "UNKNOWN",
              "UNCONFIRMED"
            ]
          },
          "lotIds": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "preservedLotIds": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "bidId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "canRetry": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "paymentStatus": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED"
            ]
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "commandId",
          "saleId",
          "action",
          "state",
          "journalState",
          "lotIds",
          "preservedLotIds",
          "bidId",
          "canRetry",
          "paymentStatus",
          "error",
          "createdAt",
          "finishedAt"
        ]
      },
      "AuctionSalesPageResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionSalesPage"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionSalesPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AuctionSale"
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextAfter": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextAfter"
        ],
        "additionalProperties": false
      },
      "AuctionSale": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "label": {
            "type": "string",
            "nullable": true
          },
          "slug": {
            "type": "string",
            "nullable": true
          },
          "associationId": {
            "type": "string",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "state": {
            "type": "string",
            "enum": [
              "BROUILLON",
              "OUVERTE",
              "CLOSE",
              "ARCHIVEE",
              null
            ],
            "nullable": true
          },
          "opensAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closesAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "hardCloseAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "openedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "id",
          "label",
          "slug",
          "associationId",
          "currency",
          "state",
          "opensAt",
          "closesAt",
          "hardCloseAt",
          "openedAt",
          "closedAt",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "AuctionSaleResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionSale"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionLotsPageResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionLotsPage"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionLotsPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AuctionLot"
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextAfter": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextAfter"
        ],
        "additionalProperties": false
      },
      "AuctionLot": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "label": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "day": {
            "type": "string",
            "nullable": true
          },
          "office": {
            "type": "string",
            "nullable": true
          },
          "order": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "kind": {
            "type": "string",
            "enum": [
              "AUCTION",
              "FIXED",
              null
            ],
            "nullable": true
          },
          "mode": {
            "type": "string",
            "enum": [
              "ONLINE",
              "ORAL_FINAL",
              "ONSITE",
              null
            ],
            "nullable": true
          },
          "blind": {
            "type": "boolean",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "amountUnit": {
            "type": "string",
            "enum": [
              "MAJOR"
            ]
          },
          "startPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "reservePrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "buyNowPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "fixedPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "quantity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "quantityLeft": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "state": {
            "type": "string",
            "enum": [
              "BROUILLON",
              "OUVERT",
              "CLOS",
              "FINALE_ORALE",
              "A_VERIFIER",
              "ADJUGE",
              "INVENDU",
              "ANNULE",
              null
            ],
            "nullable": true
          },
          "currentAmount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "bidsCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "closesAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "hardCloseAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "id",
          "saleId",
          "label",
          "description",
          "day",
          "office",
          "order",
          "kind",
          "mode",
          "blind",
          "currency",
          "amountUnit",
          "startPrice",
          "reservePrice",
          "buyNowPrice",
          "fixedPrice",
          "quantity",
          "quantityLeft",
          "state",
          "currentAmount",
          "bidsCount",
          "closesAt",
          "hardCloseAt",
          "closedAt",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "UnisoftRequest_f9fb3ca75a042a162608": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000,
            "nullable": true
          },
          "day": {
            "type": "string",
            "minLength": 0,
            "maxLength": 20,
            "nullable": true
          },
          "office": {
            "type": "string",
            "minLength": 0,
            "maxLength": 60,
            "nullable": true
          },
          "kind": {
            "type": "string",
            "enum": [
              "AUCTION",
              "FIXED"
            ]
          },
          "mode": {
            "type": "string",
            "enum": [
              "ONLINE",
              "ORAL_FINAL",
              "ONSITE"
            ]
          },
          "blind": {
            "type": "boolean"
          },
          "startPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000
          },
          "reservePrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "nullable": true
          },
          "buyNowPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "nullable": true
          },
          "fixedPrice": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "nullable": true
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000000
          },
          "restrictTribu": {
            "type": "string",
            "enum": [
              "COHEN",
              "LEVI",
              "ISRAEL",
              null
            ],
            "nullable": true
          }
        },
        "required": [
          "label",
          "kind",
          "mode",
          "startPrice",
          "quantity"
        ],
        "additionalProperties": false
      },
      "AuctionCommandReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionCommandReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "AuctionCommandReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "PREPARE",
              "EDIT",
              "REPLACE_LOTS",
              "PUBLISH",
              "CLOSE",
              "ARCHIVE",
              "BID",
              "WITHDRAW_BID",
              "RECORD_AWARD",
              "VALIDATE_AWARD",
              "CANCEL_AWARD",
              "REASSIGN_AWARD"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "ADMITTING",
              "RUNNING",
              "COMPLETED",
              "REJECTED",
              "UNKNOWN"
            ]
          },
          "journalState": {
            "type": "string",
            "enum": [
              "ADMITTING",
              "RUNNING",
              "COMPLETED",
              "REJECTED",
              "UNKNOWN",
              "UNCONFIRMED"
            ]
          },
          "lotIds": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "preservedLotIds": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "bidId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "canRetry": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "paymentStatus": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED"
            ]
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "commandId",
          "saleId",
          "action",
          "state",
          "journalState",
          "lotIds",
          "preservedLotIds",
          "bidId",
          "canRetry",
          "paymentStatus",
          "error",
          "createdAt",
          "finishedAt"
        ]
      },
      "AuctionLotResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionLot"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionBidsPageResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionBidsPage"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionBidsPage": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AuctionBid"
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextAfter": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextAfter"
        ],
        "additionalProperties": false
      },
      "AuctionBid": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "lotId": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "RETIREE",
              "REFUSEE",
              "EN_COURS",
              null
            ],
            "nullable": true
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "amountUnit": {
            "type": "string",
            "enum": [
              "MAJOR"
            ]
          },
          "quantity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "fixedPricePurchase": {
            "type": "boolean",
            "nullable": true
          },
          "buyNow": {
            "type": "boolean",
            "nullable": true
          },
          "automatic": {
            "type": "boolean",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "id",
          "lotId",
          "saleId",
          "state",
          "amount",
          "currency",
          "amountUnit",
          "quantity",
          "fixedPricePurchase",
          "buyNow",
          "automatic",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "AuctionResultResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionResult"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionResult": {
        "type": "object",
        "properties": {
          "lotId": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "lotState": {
            "type": "string",
            "enum": [
              "BROUILLON",
              "OUVERT",
              "CLOS",
              "FINALE_ORALE",
              "A_VERIFIER",
              "ADJUGE",
              "INVENDU",
              "ANNULE",
              null
            ],
            "nullable": true
          },
          "status": {
            "type": "string",
            "enum": [
              "RECORDED_AWARD",
              "FIXED_LOT_COMPLETED",
              "NO_RECORDED_AWARD",
              "UNKNOWN"
            ]
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409.9,
            "nullable": true
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "amountUnit": {
            "type": "string",
            "enum": [
              "MAJOR"
            ]
          },
          "origin": {
            "type": "string",
            "enum": [
              "ONLINE",
              "ORAL",
              "ACHAT_IMMEDIAT",
              "REATTRIBUTION",
              null
            ],
            "nullable": true
          },
          "requirement": {
            "type": "string",
            "enum": [
              "PROMESSE",
              "PAIEMENT",
              "VALIDATION",
              null
            ],
            "nullable": true
          },
          "decidedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "materializedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dueAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "paymentStatus": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED"
            ]
          }
        },
        "required": [
          "lotId",
          "saleId",
          "lotState",
          "status",
          "amount",
          "currency",
          "amountUnit",
          "origin",
          "requirement",
          "decidedAt",
          "materializedAt",
          "dueAt",
          "paymentStatus"
        ],
        "additionalProperties": false
      },
      "AuctionSettlementLinksResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionSettlementLinks"
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      },
      "AuctionSettlementLinks": {
        "type": "object",
        "properties": {
          "lotId": {
            "type": "string",
            "format": "uuid"
          },
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "pledgeIds": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "NOT_RECORDED"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "paymentStatus": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED"
            ]
          }
        },
        "required": [
          "lotId",
          "saleId",
          "pledgeIds",
          "status",
          "url",
          "paymentStatus"
        ],
        "additionalProperties": false
      },
      "AuctionCommandContextResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AuctionCommandContext"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "AuctionCommandContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "saleId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "state": {
            "type": "string",
            "enum": [
              "BROUILLON",
              "OUVERTE",
              "CLOSE",
              "ARCHIVEE"
            ]
          },
          "lotIds": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "lotCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 200
          },
          "publicationReady": {
            "type": "boolean"
          },
          "snapshotGuaranteed": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "saleId",
          "revision",
          "state",
          "lotIds",
          "lotCount",
          "publicationReady",
          "snapshotGuaranteed"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
