Alquileres

Contrato

Contrato de alquiler.

Esquemas: ContractDto

{
  "id": "id_8f2a1c",
  "contractNumber": "string",
  "status": "draft",
  "operativeStatus": "pending",
  "signed": true,
  "signedAt": "2026-09-01T08:00:00Z",
  "contactId": "string",
  "orderId": "string",
  "orderNumber": "string",
  "projectId": "string",
  "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"
}

Generado a partir del esquema

Un contrato de alquiler con su estado de documento (status) y su estado de firma (operativeStatus), que cambian por separado: validar un contrato no lo firma. Apunta al pedido, al contacto y al proyecto a los que pertenece. Las cláusulas legales y la instantánea fiscal del cliente no se publican. Los contratos están acotados a la suscripción que posee la clave.

Atributos

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.

Valores

status: draft, validated, voided
operativeStatus: pending, signed, cancelled

Lo devuelven

GET /api/v1/contracts — Listar contratos
GET /api/v1/contracts/{contractId} — Obtener un contrato

Lo modifican

POST /api/v1/contracts/{contractId}/validate — Validar un contrato
POST /api/v1/contracts/{contractId}/sign — Registrar la firma de un contrato
POST /api/v1/contracts/{contractId}/void — Anular un contrato
POST /api/v1/contracts/{contractId}/cancel — Cancelar un contrato a efectos operativos

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Valores

Lo devuelven

Lo modifican