**גרסאות API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=he)

# Auctions

OpenAPI 3.0.3 · API 2.0.0

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

## פעולות

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

Record a bid for an existing contact

`place_auction_bid`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:bid in addition to read/contact permissions. Calls the real poserMise engine once with the supplied amount and optional private maxAmount/discreet flag, contact profile and an explicit API actor. The engine retains its eligibility, tribe, blind-lot, auto-bid, increment, version-race, extension and displaced-leader notification rules. A ceiling is confidential input only, never a returned price or final obligation; maxAmount must be null or at least amount and is refused for a blind lot. An accepted bid can be immediately beaten or not lead; the receipt does not identify a winner or guarantee leading. A known native refusal returns REJECTED and a safe code without accepting an offer; do not automatically raise the amount or retry with a new key. No pledge, payment or award is invented to satisfy a bid request.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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
{
  "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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

Withdraw an active bid through the native engine

`withdraw_auction_bid`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:bid plus read/contact permissions and a nonblank reason. bidId must identify an ACTIVE bid of this exact lot/sale. The native retirerMise owner preserves the bid as RETIREE, withdraws its automatic responses and recalculates the current leader from the actual remaining offers; ceilings never leave the server. Its candidate and response references are admitted before mutation. This capability refuses fixed-price purchases, buy-now bids and lots with a current award: a bid withdrawal is not stock restoration or cancellation of a financial award. It does not erase the history, cancel a pledge or refund money.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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"
  }
}
```

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

Record an oral or responsible auction result

`record_auction_award`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:adjudicate and promesses:write plus read/contact permissions, with acknowledgePledgesAndNotifications:true. Calls saisirResultatOral with the explicitly selected contact and positive amount. Native supported states are FINALE_ORALE, CLOS, OUVERT, INVENDU and A_VERIFIER; this can assign a result while the lot is open, so it is not an ordinary bid. The owner clears the previous bidding-group attribution for this chosen winner, records origin ORAL and materialises the award. Materialisation can create existing-domain pledges, stored payment links and winner notifications. It does not register money, reuse a contact's payment instrument or prove collection. Missing or uncertain materialisation remains UNKNOWN, never permission to create an ordinary duplicate pledge.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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
{
  "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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

Validate a lot awaiting responsible adjudication

`validate_auction_award`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:adjudicate and promesses:write plus read/contact permissions, with acknowledgePledgesAndNotifications:true. Only an A_VERIFIER lot with an exact existing current leader and positive current amount is admitted. The server uses those observed native values through saisirResultatOral, just as the responsible-person validation route; no caller winner/amount override is accepted. The native award/materialisation can create pledges, links and winner emails. This is an explicit decision, not a read or a payment.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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
{
  "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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

Cancel a native award without erasing received money

`cancel_auction_award`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:adjudicate, promesses:write, promesses:read and paiements:read plus read/contact permissions, reason and acknowledgeCancellation:true. Existing award/pledge relationships must be exact and current. Because the native balance guard looks up a pledge by ID, every referenced pledge ID is independently checked for unique global identity in the same organisation. The audited pledge-history admission and canonical balance owner are reused; any observed paid allocation blocks cancellation (VERSEMENT_DEJA_IMPUTE). Unknown financial sources are refused, never treated as zero. Then annulerAdjudication performs its own native guard, marks linked pledges CANCELED and the lot INVENDU, preserving audit history. No payment is deleted or refunded, and no bank settlement is asserted. A native refusal after possible effects remains UNKNOWN.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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
{
  "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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

Reassign a lot to the next actual bidder

`reassign_auction_award`

Authorised administrative auction mutation for an existing sale id and its exact lotId in the current organisation. All bid/award amounts are MAJOR currency units with at most two decimals (180 EUR means 180, not 18000 payment minor units); the sale's observed currency is authoritative. Contact UUIDs must be current authorised contacts; a beneficiary name or display alias is not a payer ID. Every call requires auctions:read and contacts:read plus the independent operation scopes below. Campaign-restricted keys are refused. First read get_auction_command_context for the sale and send its revision as expectedRevision, with a stable UUID idempotencyKey for this intended action. The shared durable journal and per-sale integration lock precede the native owner. Matching replay returns only the recorded receipt; changed action/content/lot with the same key is refused. success:true acknowledges receipt processing: inspect state and journalState, not just HTTP 200. COMPLETED is a native acknowledgement of the requested auction action, never proof of payment; REJECTED is a confirmed refusal of that requested business effect (a native technical idempotency reservation can still exist). UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED can include partial effects and never authorises replay; canRetry is always false. Inspect get_auction_command; never change keys to bypass an uncertain sale lock. Native human/daemon writers are not made transactional by integration revision/locks. Active bids are admitted up to 2000 per lot; ambiguous identities, relationships, monetary values or excessive sources are refused before the owner. No group creation/joining, participant session, fixed-price purchase, buy-now or beneficiary editing is implicit. The API never returns bidder identity, private ceilings, provider data, capability URLs or native raw errors. paymentStatus is always NOT_OBSERVED. Requires auctions:adjudicate, promesses:write, promesses:read and paiements:read plus read/contact permissions, reason and acknowledgeCancellationAndNewPledges:true. Uses the actual active offers and native reattribuerAuSuivant ordering, never an invented amount or equal share. All candidate contact/group/financial references are admitted; a paid allocation on the existing award blocks the action. A next eligible stored bidder is required before starting. The native owner can cancel old pledges, assign the next actual bid, materialise new pledges/links and notify its winner. Its AUCUN_SUIVANT can occur after cancellation under a concurrent change; any such possible partial effect is UNKNOWN and retains the lock. This is not a retry for overdue payment or a refund command.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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
{
  "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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction command receipt; inspect its state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 401

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 403

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 404

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 409

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 422

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 500

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the action."
}
```

#### HTTP 503

```json
{
  "description": "Input, scope, exact organisation/reference, source, revision or journal admission failed. No private diagnostics; inspect an uncertain receipt without retrying the 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

List auction sales

`list_auction_sales`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Lists stored non-deactivated sales and retained archives, including drafts. Sale states BROUILLON, OUVERTE, CLOSE and ARCHIVEE describe the sale, never payment status. Optional limit is an integer 1–50 (default 50); after is the previous nextAfter UUID. Pages use ascending UUID order with simple collation, not chronological order; hasMore and nextAfter describe the scanned page, never a full-sale total. Continue with the same parent/filter until hasMore is false. The cursor is a position, not authority; concurrent changes can affect later pages.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

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

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSalesPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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}

Read an auction sale

`get_auction_sale`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Reads the sale's association, observed currency and recorded opening/closing instants. It does not expose private module settings or resolve a public slug.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSaleResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

List lots of an auction sale

`list_auction_lots`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Lists all stored lots of an authorised sale, including drafts and cancelled lots. AUCTION means competing offers; FIXED means purchases of quantities. ONLINE, ORAL_FINAL and ONSITE are sale modes, not permission to bid. A currentAmount is a provisional observation, never the winner's debt or a payment. A null quantityLeft does not prove unlimited stock. Optional limit is an integer 1–50 (default 50); after is the previous nextAfter UUID. Pages use ascending UUID order with simple collation, not chronological order; hasMore and nextAfter describe the scanned page, never a full-sale total. Continue with the same parent/filter until hasMore is false. The cursor is a position, not authority; concurrent changes can affect later pages.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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"
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionLotsPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

Manage the complete lot list of an auction sale

`replace_auction_lots`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:write and auctions:read plus acknowledgeReplacement:true. Replaces the native managed list, at most 200 entries, on a BROUILLON or OUVERTE sale. Existing id values must belong to this exact sale; omit id for a new lot (its new UUID is deterministic within this command). Label/kind/mode/startPrice/quantity are required; absent optional fields use native defaults, so include desired values when replacing an existing lot. Protected ADJUGE/A_VERIFIER lots remain unchanged; omitted lots with bids, ADJUGE/A_VERIFIER/FINALE_ORALE also remain and are reported in preservedLotIds. Other omitted lots are marked ANNULE, never physically deleted. The owner-equivalent inline adapter preserves already sold fixed-price quantities and increments versions on edits; it does not reset stock. New lots inherit current sale timing/state. Return lotIds identifies submitted/new lots, not a complete unchanged financial ledger. Multi-object failures can leave partial effects and return UNKNOWN.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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}

Read an auction lot

`get_auction_lot`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Reads the lot only after authorising its exact parent sale. Lot states FINALE_ORALE and A_VERIFIER require a separate responsible decision; ADJUGE alone proves neither a pledge nor collection. Blind auction administrative amounts are readable with auctions:read; private automatic ceilings are always excluded.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionLotResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

List recorded bids and purchases for a lot

`list_auction_bids`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Lists recorded offers, withdrawals and idempotency reservations without identities, ceilings or refusal details. ACTIVE is an offer, RETIREE a withdrawn offer, EN_COURS an unresolved reservation and REFUSEE a refused attempt; none proves an award. quantity is recorded only for fixed-price purchases and amount is their total in major units. Blind lot amounts are administrative observations. This is not the complete event/audit log. Optional limit is an integer 1–50 (default 50); after is the previous nextAfter UUID. Pages use ascending UUID order with simple collation, not chronological order; hasMore and nextAfter describe the scanned page, never a full-sale total. Continue with the same parent/filter until hasMore is false. The cursor is a position, not authority; concurrent changes can affect later pages.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

```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"
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionBidsPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

Read a recorded auction result

`get_auction_result`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. status RECORDED_AWARD means an award object is stored on an ADJUGE lot; inspect its nullable amount, origin and timestamps. NO_RECORDED_AWARD means no current award is stored, not that no earlier obligation exists. FIXED_LOT_COMPLETED means an exhausted fixed-price lot without a single award; do not invent a winner or an obligation. UNKNOWN preserves inconsistent historical data. materializedAt records the auction writer's step, not a currently validated pledge or collection. requirement PROMESSE, PAIEMENT or VALIDATION is an expected settlement rule, not a paid status. paymentStatus is always NOT_OBSERVED. Use the independently authorised settlement-link read for current pledge references, and pledge history/payment tools for the separate financial question.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionResultResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

Read an existing auction settlement link

`get_auction_settlement_links`

Required scope: auctions:read (explicit opt-in). Read-only administrative auction observation in the authenticated organisation; campaign-restricted keys are refused. A sale is an auction occasion, not a fundraising or message campaign; a lot, bid, award, pledge and payment are distinct objects. Resolve existing UUIDs from authorised auction reads; labels and public slugs are not IDs. All auction amounts, including bid amount, are in MAJOR currency units (180 EUR means 180), unlike payment amount in minor units. currency, malformed historical values and unavailable dates are null, never assumed EUR or fabricated zero. Dates are UTC ISO instants; a passed deadline does not close a lot. No closing, award, pledge materialisation, payment/link creation, notification, reconciliation or cache write is triggered. No bidder/contact/beneficiary identity, group membership, bid ceiling, session or actor is returned, even with other scopes. Results are live observations, not an atomic snapshot. Unknown parameters/types and nonempty GET bodies return 400; missing/foreign or ambiguous scalar identities return 404, inconsistent bounded sources return 409 AUCTION_DATA_UNAVAILABLE, persistence failures return 500 INTERNAL_ERROR. A refusal or uncertain observation authorises no write or automatic retry. Additionally requires auctions:payment-links:read and promesses:read; neither ordinary finance permissions nor auctions:read alone grant this URL capability. Admits every stored pledge reference against its current exact organisation and auction lot/sale relation. Returns at most 100 pledgeIds and only the existing single-pledge award URL after validating its stored PAIEMENT link target and current organisation website base. AVAILABLE proves an authorised stored link, never that it remains payable or that a payment succeeded. NOT_RECORDED means no single link is stored on this award; group participants can have separate pledge links and fixed-price purchases need not have one award. No missing link or pledge is created and no link is refreshed. Missing foreign/stale targets return 404; malformed or unverifiable stored URLs/references return 409. paymentStatus is always NOT_OBSERVED; use permitted pledge/payment reads separately. Do not publish a returned capability URL unless the user requests it.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Recorded auction observation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionSettlementLinksResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 401

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 403

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 404

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 409

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

#### HTTP 500

```json
{
  "description": "Request, permission, ownership or source admission failed; no auction or financial action was performed."
}
```

### 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

Prepare a draft auction sale

`prepare_auction_sale`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:write and auctions:read. Creates only a native BROUILLON sale, using a deterministic new sale UUID derived from organisation and key. associationId must be a current organisation association; its observed currency is required, never assumed EUR. The native calendar owner must have real organisation coordinates; it derives hardCloseAt from the next rest window minus marginMinutes (default 60), and the requested closesAt is clamped to that limit. No generic timezone substitute is used. Future closesAt is required; opensAt, if supplied, must precede the effective close. The native organisation auction entitlement and enabled module are required. Sale rules use the native module defaults; custom rule/SEO-image editing is not exposed here. Canonical lowercase slugs must be unused. No lot, publication, bid, pledge or payment is created.

### אימות

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

### הרשאות נדרשות

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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

Read an auction command revision

`get_auction_command_context`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:read only. Returns an admission revision and the existing lot UUIDs without bidder identities or bid ceilings. publicationReady means a BROUILLON sale has a recorded hard closing limit and at least one lot; it is not a calendar, entitlement or final publication guarantee. The read does not reserve, initialise or write anything.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandContextResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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

Edit auction sale metadata and timing

`edit_auction_sale`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:write and auctions:read. Updates only supplied label, canonical slug, occasion and opening/closing instants on a current BROUILLON or OUVERTE sale. Association/currency and private settings cannot change. closesAt is clamped to the existing native hardCloseAt; the limit itself is never extended. Root sale timing changes do not retroactively rewrite every lot deadline. The conditional update checks the admitted source; stale revision returns a refused receipt.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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

Publish and open a prepared auction sale

`publish_auction_sale`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:publish and auctions:read (separate opt-in). Opens an existing BROUILLON sale and its draft lots through the native ouvrirVente owner. A recorded valid hardCloseAt and at least one current lot are required; current module entitlement/activation are rechecked. The native cache is invalidated; no marketing message is sent by this operation. This is a real public opening, not a preview or a retained draft. Recorded native lot deadlines remain authoritative. No payment is collected.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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

Close an auction sale through the native result owner

`close_auction_sale`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:close, auctions:read, auctions:adjudicate and promesses:write plus acknowledgeAwardsAndPledges:true. On an OUVERTE sale, closes each currently OUVERT non-draft lot using the real native closing rules; oral/on-site lots can become FINALE_ORALE, reserve/rule decisions can remain A_VERIFIER, and online lots can be awarded. Each newly ADJUGE lot is materialised through the native adjudication owner, which can create existing-domain pledges/payment links and winner emails. Every current contact/group/share/pledge relation is admitted before starting; no group split or monetary outcome is recalculated here. Then records the sale CLOSE state, exactly as the native close route. This is not an arbitrary force-winner command and not a payment confirmation. A partial close/materialisation remains UNKNOWN and cannot be retried by changing keys.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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

Archive an unengaged auction sale

`archive_auction_sale`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:write and auctions:read plus acknowledgeArchive:true. Uses the native source transition active:false/state:ARCHIVEE only when no current lot is ADJUGE. It preserves the sale and lot records, never cancels an award/pledge/payment or refunds anything. An awarded sale is refused by this capability; do not delete financial obligations to bypass that guard.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### גוף הבקשה

```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
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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}

Read an auction command receipt

`get_auction_command`

Administrative auction command in the authenticated organisation; campaign-restricted keys are refused. Sale/lot UUIDs are distinct from forms, fundraising campaigns and message campaigns. All auction prices are MAJOR currency units, with at most two decimals; no payment amount is accepted. Every mutation requires one stable UUID idempotencyKey. Read get_auction_command_context before changing an existing sale and send its expectedRevision (SHA-256 observation of the current sale and at most 200 lots). A durable command journal and per-sale integration lock precede any business effect. A matching replay returns the existing receipt without calling the owner again; changed content/action with that key is refused. success:true acknowledges receipt processing, not necessarily the business effect: inspect state and journalState. COMPLETED means the owner acknowledged this command; REJECTED means the requested business effect was refused (a native technical idempotency reservation may remain); UNKNOWN/RUNNING/ADMITTING or journalState UNCONFIRMED never authorises a retry. canRetry is always false. An uncertain command retains its sale lock and a new key cannot bypass it. Read get_auction_command; a missing receipt does not prove that a request never started. Revision admission and integration locks do not make the native human/daemon writers transactional or prevent their concurrent changes. Partial native multi-object effects remain UNKNOWN and are never replayed. No bidder identity, private ceiling, reusable payment reference or capability URL is returned. paymentStatus is always NOT_OBSERVED; award/pledge/link creation does not prove collection. No system ADMIN identity is fabricated. Unknown fields/query parameters, invalid scalars, excessive lists and bodies on reads are refused. Requires auctions:read only. Reads the durable external lifecycle command receipt for this organisation, without replay, recovery, stale-lock takeover or another business read/write. Missing/foreign commands share NOT_FOUND. An unconfirmed final journal update can leave the stored receipt RUNNING even after an effect; inspect the original command and the authorised objects without resubmitting.

### אימות

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

### הרשאות נדרשות

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

### פרמטרים

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

### תגובות

#### HTTP 200

```json
{
  "description": "Auction command observation; inspect its recorded state.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AuctionCommandReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 401

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 403

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 404

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 409

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 422

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 500

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

#### HTTP 503

```json
{
  "description": "Input, independent permission, organisation, current source, revision or journal admission failed. No private diagnostics are returned; an uncertain receipt must be inspected without replay."
}
```

### 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
  }
}
```

## סכמות

```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"
      }
    }
  }
}
```
