*MCP › Referencia › Alquileres › Contratos*

# Validar un contrato

> Cierra un contrato en borrador: le asigna un número de la serie y lo bloquea como inmutable, en la misma transacción —sin huecos y sin doble emisión—.

> **No reversible:** Esta herramienta no se puede deshacer.

> **Requiere confirmación humana:** Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por `destructiveHint`. El servidor marca esta herramienta con `_meta["anthropic/requiresUserInteraction"]`, que los clientes que lo respetan usan para preguntar a una persona antes de cada llamada.

> **Anotación del servidor:** Valida un documento que queda bloqueado. Hoy la validación no envía el documento a la administración tributaria, pero no se puede deshacer.

Solo desde `draft`; desde cualquier otro estado rechaza la petición sin tocar nada. Mueve el estado del DOCUMENTO (`status`), no el estado de la firma (`operativeStatus`): un contrato validado sigue sin firmar hasta `/sign`. No lleva cuerpo. Requiere documentos de venta en el plan de la cuenta (402 si no están incluidos). Devuelve el contrato completo, con la misma proyección que su GET.

HERRAMIENTA `filmo_contracts_validate` · `contracts:write` · 120/min · Puede requerir un add-on · Anotación del servidor: Destructiva · Requiere confirmación humana · No reversible

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `contractId` | string | Sí | Identificador del contrato. |
| `idempotencyKey` | string | No | Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red. |
| `ifMatch` | string | No | Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones. |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del contrato. |
| `contractNumber` | string | Número del contrato, por ejemplo "C260001"; null mientras es un borrador. |
| `status` | string | Estado del documento. `draft`, `validated`, `voided` |
| `operativeStatus` | string | Estado de la firma. `pending`, `signed`, `cancelled` |
| `signed` | boolean | true si el contrato consta como firmado. Es lo que decide si el equipo puede salir. |
| `signedAt` | string<date-time> | Fecha de firma en ISO 8601 UTC; null si no está firmado. |
| `contactId` | string | Identificador del cliente; null en borradores sin cliente. |
| `orderId` | string | Pedido asociado; null si no tiene. |
| `orderNumber` | string | Número del pedido asociado; null si no tiene. |
| `projectId` | string | Proyecto asociado; null si no tiene. |
| `contractDate` | string<date-time> | Fecha del contrato en ISO 8601 UTC; null si no está definida. |
| `startDate` | string<date-time> | Inicio de la vigencia en ISO 8601 UTC; null si no aplica. |
| `endDate` | string<date-time> | Fin de la vigencia en ISO 8601 UTC; null si no aplica. |
| `grossPrice` | string | Importe total con impuestos como cadena decimal "1234.50"; null si no aplica. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC; null si no consta. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC; null si no está registrada. |

*Llamada · filmo_contracts_validate*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_contracts_validate",
    "arguments": {
      "contractId": "cont_8f2a1c"
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "contractNumber": "<contractNumber>",
      "status": "draft",
      "operativeStatus": "pending",
      "signed": true,
      "signedAt": "2026-09-01T08:00:00Z",
      "contactId": "cont_8f2a1c",
      "orderId": "orde_8f2a1c",
      "orderNumber": "<orderNumber>",
      "projectId": "proj_8f2a1c",
      "contractDate": "2026-09-01T08:00:00Z",
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z",
      "grossPrice": "1234.50",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`POST /api/v1/contracts/{contractId}/validate`](https://docs.filmo.io/es/rest-api/endpoint-reference/contracts/validate-a-contract).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/contracts/filmo-contracts-validate  
Última actualización: 2026-10-25