Aller au contenu

📄 Contracts API

Übersicht

Verwaltet Mietverträge für Immobilien-Einheiten.

Endpoints

GET /api/contracts

Alle Verträge für einen Tenant abrufen.

Headers:

X-Tenant-ID: your-tenant-id (required)

Response:

[
  {
    "id": "clx123...",
    "tenantId": "tenant-abc",
    "unitId": "unit-123",
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": null,
    "rentAmount": 1200.00,
    "status": "ACTIVE"
  }
]

GET /api/contracts/:id

Einzelnen Vertrag abrufen.

Response:

{
  "id": "clx123...",
  "tenantId": "tenant-abc",
  "unitId": "unit-123",
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": null,
  "rentAmount": 1200.00,
  "status": "ACTIVE",
  "msGraphId": null,
  "sevdeskId": "12345"
}

POST /api/contracts

Neuen Vertrag erstellen.

Body:

{
  "tenantId": "tenant-abc",
  "unitId": "unit-123",
  "startDate": "2024-01-01",
  "rentAmount": 1200.00,
  "status": "DRAFT"
}

PATCH /api/contracts/:id/status

Vertragsstatus ändern.

Body:

{
  "status": "ACTIVE"
}

Mögliche Status:

Status Description
DRAFT Entwurf
ACTIVE Aktiv
TERMINATED Gekündigt
EXPIRED Abgelaufen