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

# Budget operations

OpenAPI 3.0.3 · API 2.0.0

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

## פעולות

## GET /banking/operations

List accounting income, expenses and allocation transfers

`list_budget_operations`

Organisation-scoped analytical Budget operations, distinct from bank debits/transfers, donations and provider settlement. Scopes budgets:read and budgets:write are independent, explicitly granted; campaign-restricted keys are refused. amountMajor is a decimal string in MAJOR currency units with at most two decimals, never payment minor units. Writes require a strictly positive amount; an explicitly recorded historical zero may be read. fromBudgetId/toBudgetId describe the native input/output budget accounts; OTHER is an external accounting counterpart, not a bank account. MAIN is an association; GENERAL/PRINCIPAL is the main analytical budget. Historical unknown values remain null/UNKNOWN. No bank/provider request, debit, refund, document movement, recurring copies, account settlement or currency conversion occurs. Current association currency must be explicit and match the association for writes. No credentials, source snapshots or attachments are returned. Unknown arguments and non-empty bodies on GET are rejected. Shared authentication may record key usage. Requires budgets:read. Required assoc/currency select one current association denomination, without total or conversion. Sorts UUID ascending; after is the last UUID returned, tied by the client to the same association/currency. Concurrent changes do not form a snapshot. A historical ambiguous identity returns 409.

### אימות

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

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

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

### פרמטרים

```json
{
  "name": "assoc",
  "in": "query",
  "description": "Required current legal association ID from list_associations.",
  "schema": {
    "type": "string"
  },
  "required": true
}
```

```json
{
  "name": "currency",
  "in": "query",
  "description": "Required exact lowercase association currency.",
  "schema": {
    "type": "string",
    "pattern": "^[a-z]{3}$"
  },
  "required": true
}
```

```json
{
  "name": "limit",
  "in": "query",
  "description": "Page size 1–200, default 50.",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  },
  "required": false
}
```

```json
{
  "name": "after",
  "in": "query",
  "description": "Last returned operation UUID with the same association/currency filters.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": false
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Current admitted operation or durable command outcome.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid input, date, decimal amount, UUID, allocation, version or unexpected query/body.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, disabled organisation or CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND: unavailable operation, command or association.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE or COMMAND_HISTORY_LIMIT. No automatic retry or internal bypass.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR with no private diagnostics. An uncertain write must be resolved using the same commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /banking/operations

Create one manual accounting operation

`create_budget_operation`

Organisation-scoped analytical Budget operations, distinct from bank debits/transfers, donations and provider settlement. Scopes budgets:read and budgets:write are independent, explicitly granted; campaign-restricted keys are refused. amountMajor is a decimal string in MAJOR currency units with at most two decimals, never payment minor units. Writes require a strictly positive amount; an explicitly recorded historical zero may be read. fromBudgetId/toBudgetId describe the native input/output budget accounts; OTHER is an external accounting counterpart, not a bank account. MAIN is an association; GENERAL/PRINCIPAL is the main analytical budget. Historical unknown values remain null/UNKNOWN. No bank/provider request, debit, refund, document movement, recurring copies, account settlement or currency conversion occurs. Current association currency must be explicit and match the association for writes. No credentials, source snapshots or attachments are returned. Unknown arguments and non-empty bodies on GET are rejected. Shared authentication may record key usage. Requires budgets:write. Discover targets with list_banking_budgets, then submit exact type/id pairs. INCOME requires only to (native OTHER → budget, entree=true); EXPENSE requires only from (budget → OTHER, entree=false); TRANSFER requires distinct from/to (entree=false). Targets must belong to the organisation/association and be available, never legacy SERVICE or archived. Categories use the native normaliser. date is required, exact UTC YYYY-MM-DDTHH:mm:ss.sssZ; future accounting dates are allowed. The command changes only one manual operation. A correction fully supplies the exposed accounting fields and needs the version returned by a current read; attachments and other private metadata are preserved, convertedAmount is reset to null as in the native editor. Automatic, accounting-imported or bank-linked operations are refused; use the corresponding authorised workflow. CAS detects changes to native financial fields, including internal edits; linked-account checking is a preflight, not a distributed transaction with the internal bank UI. commandId is a caller-generated UUID scoped to the current API principal and organisation. Reuse it only with the identical request. A durable private journal and same-document marker prevent duplicate effects. APPLIED returns the acknowledged command snapshot, which may differ from a later current read. Claims require acknowledged:true and the exact insertedId, and all effect/CAS/terminal writes force majority+j:true with positive driver acknowledgement. A lost, absent or false acknowledgement returns COMMAND_UNCERTAIN; only a later read may resolve the durable marker without repeating an effect. COMMAND_UNCERTAIN never permits a new commandId or automatic write retry: use get_budget_operation_command for read-only recovery. The same command is never executed a second time.

### אימות

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

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

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

### גוף הבקשה

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

### תגובות

#### HTTP 200

```json
{
  "description": "Current admitted operation or durable command outcome.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid input, date, decimal amount, UUID, allocation, version or unexpected query/body.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, disabled organisation or CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND: unavailable operation, command or association.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE or COMMAND_HISTORY_LIMIT. No automatic retry or internal bypass.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR with no private diagnostics. An uncertain write must be resolved using the same commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /banking/operations/{id}

Read one accounting operation and its version

`get_budget_operation`

Organisation-scoped analytical Budget operations, distinct from bank debits/transfers, donations and provider settlement. Scopes budgets:read and budgets:write are independent, explicitly granted; campaign-restricted keys are refused. amountMajor is a decimal string in MAJOR currency units with at most two decimals, never payment minor units. Writes require a strictly positive amount; an explicitly recorded historical zero may be read. fromBudgetId/toBudgetId describe the native input/output budget accounts; OTHER is an external accounting counterpart, not a bank account. MAIN is an association; GENERAL/PRINCIPAL is the main analytical budget. Historical unknown values remain null/UNKNOWN. No bank/provider request, debit, refund, document movement, recurring copies, account settlement or currency conversion occurs. Current association currency must be explicit and match the association for writes. No credentials, source snapshots or attachments are returned. Unknown arguments and non-empty bodies on GET are rejected. Shared authentication may record key usage. Requires budgets:read. Does not certify editability: bank links and accounting ownership are rechecked before any correction. Missing, deleted and foreign operations share 404.

### אימות

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

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

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

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "description": "Local operation UUID from list_budget_operations or a command receipt; not a bank transaction, payment, association or budget UUID.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Current admitted operation or durable command outcome.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid input, date, decimal amount, UUID, allocation, version or unexpected query/body.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, disabled organisation or CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND: unavailable operation, command or association.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE or COMMAND_HISTORY_LIMIT. No automatic retry or internal bypass.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR with no private diagnostics. An uncertain write must be resolved using the same commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

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

## PUT /banking/operations/{id}

Correct a manual operation and its budget allocation

`correct_budget_operation`

Organisation-scoped analytical Budget operations, distinct from bank debits/transfers, donations and provider settlement. Scopes budgets:read and budgets:write are independent, explicitly granted; campaign-restricted keys are refused. amountMajor is a decimal string in MAJOR currency units with at most two decimals, never payment minor units. Writes require a strictly positive amount; an explicitly recorded historical zero may be read. fromBudgetId/toBudgetId describe the native input/output budget accounts; OTHER is an external accounting counterpart, not a bank account. MAIN is an association; GENERAL/PRINCIPAL is the main analytical budget. Historical unknown values remain null/UNKNOWN. No bank/provider request, debit, refund, document movement, recurring copies, account settlement or currency conversion occurs. Current association currency must be explicit and match the association for writes. No credentials, source snapshots or attachments are returned. Unknown arguments and non-empty bodies on GET are rejected. Shared authentication may record key usage. Requires budgets:write. Discover targets with list_banking_budgets, then submit exact type/id pairs. INCOME requires only to (native OTHER → budget, entree=true); EXPENSE requires only from (budget → OTHER, entree=false); TRANSFER requires distinct from/to (entree=false). Targets must belong to the organisation/association and be available, never legacy SERVICE or archived. Categories use the native normaliser. date is required, exact UTC YYYY-MM-DDTHH:mm:ss.sssZ; future accounting dates are allowed. The command changes only one manual operation. A correction fully supplies the exposed accounting fields and needs the version returned by a current read; attachments and other private metadata are preserved, convertedAmount is reset to null as in the native editor. Automatic, accounting-imported or bank-linked operations are refused; use the corresponding authorised workflow. CAS detects changes to native financial fields, including internal edits; linked-account checking is a preflight, not a distributed transaction with the internal bank UI. commandId is a caller-generated UUID scoped to the current API principal and organisation. Reuse it only with the identical request. A durable private journal and same-document marker prevent duplicate effects. APPLIED returns the acknowledged command snapshot, which may differ from a later current read. Claims require acknowledged:true and the exact insertedId, and all effect/CAS/terminal writes force majority+j:true with positive driver acknowledgement. A lost, absent or false acknowledgement returns COMMAND_UNCERTAIN; only a later read may resolve the durable marker without repeating an effect. COMMAND_UNCERTAIN never permits a new commandId or automatic write retry: use get_budget_operation_command for read-only recovery. The same command is never executed a second time.

### אימות

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

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

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

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "description": "Local operation UUID from list_budget_operations or a command receipt; not a bank transaction, payment, association or budget UUID.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### גוף הבקשה

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

### תגובות

#### HTTP 200

```json
{
  "description": "Current admitted operation or durable command outcome.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid input, date, decimal amount, UUID, allocation, version or unexpected query/body.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, disabled organisation or CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND: unavailable operation, command or association.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE or COMMAND_HISTORY_LIMIT. No automatic retry or internal bypass.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR with no private diagnostics. An uncertain write must be resolved using the same commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

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

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

Resolve an accounting command without repeating its write

`get_budget_operation_command`

Organisation-scoped analytical Budget operations, distinct from bank debits/transfers, donations and provider settlement. Scopes budgets:read and budgets:write are independent, explicitly granted; campaign-restricted keys are refused. amountMajor is a decimal string in MAJOR currency units with at most two decimals, never payment minor units. Writes require a strictly positive amount; an explicitly recorded historical zero may be read. fromBudgetId/toBudgetId describe the native input/output budget accounts; OTHER is an external accounting counterpart, not a bank account. MAIN is an association; GENERAL/PRINCIPAL is the main analytical budget. Historical unknown values remain null/UNKNOWN. No bank/provider request, debit, refund, document movement, recurring copies, account settlement or currency conversion occurs. Current association currency must be explicit and match the association for writes. No credentials, source snapshots or attachments are returned. Unknown arguments and non-empty bodies on GET are rejected. Shared authentication may record key usage. Requires budgets:write, limited to the current principal’s own command. APPLIED is established only by the matching marker on the current organisation-owned operation; REJECTED describes a known CAS refusal. Missing proof returns COMMAND_UNCERTAIN, never permission to execute again. The returned data is the original acknowledged snapshot, not the operation’s current state. No query parameter is accepted.

### אימות

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

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

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

### פרמטרים

```json
{
  "name": "commandId",
  "in": "path",
  "description": "The original command UUID used with this API principal. Preserve it after a timeout.",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "required": true
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Current admitted operation or durable command outcome.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid input, date, decimal amount, UUID, allocation, version or unexpected query/body.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, disabled organisation or CAMPAIGN_RESTRICTED_KEY.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND: unavailable operation, command or association.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "STALE_OPERATION, COMMAND_ID_REUSED, COMMAND_UNCERTAIN, COMMAND_CONTEXT_CHANGED, AMBIGUOUS_OPERATION, INVALID_COMMAND_HISTORY, OPERATION_LINKED_TO_BANK, AUTO_OPERATION_REQUIRES_BANK_WORKFLOW, ACCOUNTING_OWNED_OPERATION, ASSOCIATION_CURRENCY_MISMATCH, BUDGET_TARGET_UNAVAILABLE or COMMAND_HISTORY_LIMIT. No automatic retry or internal bypass.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR with no private diagnostics. An uncertain write must be resolved using the same commandId.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/BudgetOperationError"
      }
    }
  }
}
```

### OpenAPI

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

## סכמות

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