Contratos

Obtener un contrato

Devuelve el detalle de un contrato por su identificador.

Herramienta

filmo_contracts_get

Lecturacontracts:read

contracts:read
120/min
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

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

{
  "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": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generado desde el esquema

Argumentos

contractIdstringObligatorio

Identificador del contrato.

Límites: longitud mín. 1

Resultado

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

Ver los atributos de data

idstring

Identificador único del contrato.

contractNumberstring | null

Número del contrato, por ejemplo "C260001"; null mientras es un borrador.

statusstring

Estado del documento.

Opciones disponibles: draft, validated, voided

operativeStatusstring

Estado de la firma.

Opciones disponibles: pending, signed, cancelled

signedboolean

true si el contrato consta como firmado. Es lo que decide si el equipo puede salir.

signedAtstring<date-time> | null

Fecha de firma en ISO 8601 UTC; null si no está firmado.

contactIdstring | null

Identificador del cliente; null en borradores sin cliente.

orderIdstring | null

Pedido asociado; null si no tiene.

orderNumberstring | null

Número del pedido asociado; null si no tiene.

projectIdstring | null

Proyecto asociado; null si no tiene.

contractDatestring<date-time> | null

Fecha del contrato en ISO 8601 UTC; null si no está definida.

startDatestring<date-time> | null

Inicio de la vigencia en ISO 8601 UTC; null si no aplica.

endDatestring<date-time> | null

Fin de la vigencia en ISO 8601 UTC; null si no aplica.

grossPricestring | null

Importe total con impuestos como cadena decimal "1234.50"; null si no aplica.

Límites: patrón ^-?\d+\.\d{2}$

createdAtstring<date-time> | null

Fecha de creación en ISO 8601 UTC; null si no consta.

updatedAtstring<date-time> | null

Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/contracts/{contractId}.

Contratos
Obtener un contrato
Devuelve el detalle de un contrato por su identificador.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Obtener un contrato

Escrituras seguras

Errores