---
title: "Projects (Robaws)"
description: "Projects"
language: de
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/de/datamodels/robaws/Robaws.Projects.Projects
original: https://documentation.invantive.eu/en/datamodels/robaws/Robaws.Projects.Projects
updated: 2026-11-18T23:43:02Z
license: https://documentation.invantive.eu/de/
---

# Projekte: Robaws-Projekte

`insert` `update` `delete` `REST`

- Katalog: `Robaws`
- Schema: `Projects`
- Primärschlüssel: `id`
- Bezeichnung: Projekte

Suchen

Mit `insert`, `update` und `delete` können Daten abgerufen und geändert werden.

## API-Quelle

- Endpunkt: `/api/v2/projects`
- Operation: `get /api/v2/projects`

## Leistungsmerkmale

| Characteristic | Value |
|---|---:|
| Durchschnittliche Zugriffsverzögerung (ms) | 96 |
| Anzahl der Vollscan-Zeilen pro Minute | 21,800 |
| Anzahl der Query-Zeilen pro Minute | 988 |
| Zeilen pro Minute schreiben | 539 |

Das Ergebnis kann auf dem Client im Cache zwischengespeichert werden.

## Parameter

| Name | Datentyp | Required | Default | Documentation |
|---|---|:---:|---|---|
| `clientId` | `` | [ ] |  |  |
| `logicId` | `` | [ ] |  |  |
| `purchaseInvoiceId` | `` | [ ] |  |  |
| `salesInvoiceId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `subscriptionId` | `` | [ ] |  |  |
| `supplierId` | `` | [ ] |  |  |
| `supplyOrderId` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Tabellenspalten

Die Spalten der Tabelle `Projects` sind unten aufgeführt. Jede Spalte hat einen SQL-Datentyp. Beim Einfügen und Aktualisieren muss für jede erforderliche Spalte jederzeit ein neuer Wert angegeben werden der nicht Null ist.

| Name | Datentyp | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `archivedAt` | `datetime` | Archiviert am | [ ] | Filter auf der Plattform, beschreibbar, `archivedAt` |  |
| `checkInAtWork` | `varchar2` | Anmeldung am Arbeitsplatz | [ ] | Filter auf der Plattform, beschreibbar, `checkInAtWork` |  |
| `clientContactId` | `varchar2` | Client ID | [ ] | Filter auf der Plattform, beschreibbar, `clientContactId` |  |
| `clientId` | `varchar2` | Client-ID | [ ] | Filter auf der Plattform, beschreibbar, `clientId` |  |
| `clientReference` | `varchar2` | Geschäftszeichen (Kunde) | [ ] | Filter auf der Plattform, beschreibbar, `clientReference` |  |
| `companyId` | `varchar2` | Firmen ID | [ ] | Filter auf der Plattform, beschreibbar, `companyId` |  |
| `createdAt` | `datetime` | Erstellt bei | [ ] | Filter auf der Plattform, beschreibbar, `createdAt` |  |
| `date` | `datetime` | Date | [ ] | Filter auf der Plattform, beschreibbar, `date` |  |
| `deletedAt` | `datetime` | Gelöscht am | [ ] | Filter auf der Plattform, beschreibbar, `deletedAt` |  |
| `distance` | `int32` | Distance | [ ] | Filter auf der Plattform, beschreibbar, `distance` |  |
| `endClientContactId` | `varchar2` | ID des Endkundenkontakts | [ ] | Filter auf der Plattform, beschreibbar, `endClientContactId` |  |
| `endClientId` | `varchar2` | End client ID | [ ] | Filter auf der Plattform, beschreibbar, `endClientId` |  |
| `executorId` | `varchar2` | Ausführende ID | [ ] | Filter auf der Plattform, beschreibbar, `executorId` |  |
| `extraFields` | `varchar2` | Zusätzliche Felder | [ ] | writable | Der JSON-Text des verschachtelten Objekts. |
| `geofence` | `varchar2` | Geofence | [ ] | Filter auf der Plattform, beschreibbar, `geofence` |  |
| `id` | `varchar2` | ID | [ ] | Filter auf der Plattform, beschreibbar, `id` |  |
| `lockedAt` | `datetime` | Gesperrt bei | [ ] | Filter auf der Plattform, beschreibbar, `lockedAt` |  |
| `logicId` | `varchar2` | Logische ID | [ ] | Filter auf der Plattform, beschreibbar, `logicId` |  |
| `marginArticleCost` | `double` | Marge Artikelkosten | [ ] | Filter auf der Plattform, beschreibbar, `marginArticleCost` |  |
| `marginMaterialCost` | `double` | Materialkostenmarge | [ ] | Filter auf der Plattform, beschreibbar, `marginMaterialCost` |  |
| `marginSubcontractorCost` | `double` | Marge für Subunternehmerkosten | [ ] | Filter auf der Plattform, beschreibbar, `marginSubcontractorCost` |  |
| `marginWorkCost` | `double` | Kosten für die Randbearbeitung | [ ] | Filter auf der Plattform, beschreibbar, `marginWorkCost` |  |
| `nssoDeclarationOfWorks` | `varchar2` | NSSO-Leistungsbeschreibung | [ ] | Filter auf der Plattform, beschreibbar, `nssoDeclarationOfWorks` |  |
| `planningGroup` | `varchar2` | Planungsgruppe | [ ] | Filter auf der Plattform, beschreibbar, `planningGroup` |  |
| `planningName` | `varchar2` | Name des Planungsprojekts | [ ] | Filter auf der Plattform, beschreibbar, `planningName` |  |
| `priceGroupId` | `varchar2` | Preisgruppen-ID | [ ] | Filter auf der Plattform, beschreibbar, `priceGroupId` |  |
| `renderedWorkOrderInfo` | `varchar2` | Informationen zum ausgeführten Arbeitsauftrag | [ ] | Filter auf der Plattform, beschreibbar, `renderedWorkOrderInfo` | Beim Lesen nur vorhanden, wenn über den Abfrageparameter 'include' angefordert, andernfalls null. |
| `siteAddress_addressLine1` | `varchar2` | Standortadresse, Zeile 1 | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.addressLine1` |  |
| `siteAddress_addressLine2` | `varchar2` | Standortadresse, Zeile 2 | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.addressLine2` |  |
| `siteAddress_city` | `varchar2` | Standortadresse Ort | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.city` |  |
| `siteAddress_country` | `varchar2` | Standortadresse Land | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.country` |  |
| `siteAddress_latitude` | `double` | Standortadresse Breitengrad | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.latitude` |  |
| `siteAddress_longitude` | `double` | Längengrad des Standorts | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.longitude` |  |
| `siteAddress_postalCode` | `varchar2` | Standortadresse Postleitzahl | [ ] | Filter auf der Plattform, beschreibbar, `siteAddress.postalCode` |  |
| `siteManagerId` | `varchar2` | Standortleiter-ID | [ ] | Filter auf der Plattform, beschreibbar, `siteManagerId` |  |
| `siteNssoIdNumber` | `varchar2` | Standort-NSSO-Identifikationsnummer | [ ] | Filter auf der Plattform, beschreibbar, `siteNssoIdNumber` |  |
| `statistics_claimStateGrandTotal` | `decimal` | Statistik – Anspruch – Bundesland – Gesamtsumme | [ ] | Filter auf der Plattform, beschreibbar, `statistics.claimStateGrandTotal` |  |
| `statistics_internalSupplyOrderTotalCostPrice` | `decimal` | Statistik Interne Beschaffung Bestellung Gesamtkosten Preis | [ ] | Filter auf der Plattform, beschreibbar, `statistics.internalSupplyOrderTotalCostPrice` |  |
| `statistics_offerGrandTotal` | `decimal` | Statistiken: Gesamtsumme | [ ] | Filter auf der Plattform, beschreibbar, `statistics.offerGrandTotal` |  |
| `statistics_offerTotalCostPrice` | `decimal` | Statistiken zeigen den Gesamtkostenpreis an | [ ] | Filter auf der Plattform, beschreibbar, `statistics.offerTotalCostPrice` |  |
| `statistics_offerTotalIndirectCosts` | `decimal` | Statistiken zu den gesamten indirekten Kosten | [ ] | Filter auf der Plattform, beschreibbar, `statistics.offerTotalIndirectCosts` |  |
| `statistics_purchaseInvoiceGrandTotal` | `decimal` | Statistik – Rechnungsbetrag – Endsumme | [ ] | Filter auf der Plattform, beschreibbar, `statistics.purchaseInvoiceGrandTotal` |  |
| `statistics_realisedIndirectCosts` | `decimal` | Statistik der angefallenen indirekten Kosten | [ ] | Filter auf der Plattform, beschreibbar, `statistics.realisedIndirectCosts` |  |
| `statistics_salesInvoiceGrandTotal` | `decimal` | Statistik – Umsatz – Rechnungs-Gesamtsumme | [ ] | Filter auf der Plattform, beschreibbar, `statistics.salesInvoiceGrandTotal` |  |
| `statistics_settlementGrandTotal` | `decimal` | Statistik – Abrechnung – Gesamtsumme | [ ] | Filter auf der Plattform, beschreibbar, `statistics.settlementGrandTotal` |  |
| `statistics_settlementTotalCostPrice` | `decimal` | Statistik Abrechnung Gesamtkosten Preis | [ ] | Filter auf der Plattform, beschreibbar, `statistics.settlementTotalCostPrice` |  |
| `statistics_settlementTotalIndirectCosts` | `decimal` | Statistik Abrechnung Gesamtbetrag der indirekten Kosten | [ ] | Filter auf der Plattform, beschreibbar, `statistics.settlementTotalIndirectCosts` |  |
| `statistics_totalBudgetedCosts` | `decimal` | Statistik: Gesamtkosten im Haushalt | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalBudgetedCosts` |  |
| `statistics_totalBudgetedHours` | `decimal` | Statistik: Gesamtzahl der veranschlagten Stunden | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalBudgetedHours` |  |
| `statistics_totalBudgetedIncome` | `decimal` | Statistik: Gesamtbudgetierte Einnahmen | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalBudgetedIncome` |  |
| `statistics_totalForecastedCosts` | `decimal` | Statistik: Prognostizierte Gesamtkosten | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalForecastedCosts` |  |
| `statistics_totalForecastedIncome` | `decimal` | Statistik: Prognostizierte Gesamteinnahmen | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalForecastedIncome` |  |
| `statistics_totalForecastedIndirectCosts` | `decimal` | Statistik: Prognostizierte indirekte Kosten insgesamt | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalForecastedIndirectCosts` |  |
| `statistics_totalRealisedCosts` | `decimal` | Statistik: Gesamtkosten (tatsächlich angefallen) | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalRealisedCosts` |  |
| `statistics_totalRealisedIncome` | `decimal` | Statistik: Gesamte erzielte Einnahmen | [ ] | Filter auf der Plattform, beschreibbar, `statistics.totalRealisedIncome` |  |
| `statistics_workOrderTotalCostPrice` | `decimal` | Statistik: Auftrag – Gesamtkosten – Preis | [ ] | Filter auf der Plattform, beschreibbar, `statistics.workOrderTotalCostPrice` |  |
| `statistics_workOrderTotalHours` | `decimal` | Statistik: Gesamtstundenzahl der Arbeitsaufträge | [ ] | Filter auf der Plattform, beschreibbar, `statistics.workOrderTotalHours` |  |
| `status` | `varchar2` | Status | [ ] | Filter auf der Plattform, beschreibbar, `status` |  |
| `statusDetails_color` | `varchar2` | Statusdetails Farbe | [ ] | Filter auf der Plattform, beschreibbar, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Status Details Name | [ ] | Filter auf der Plattform, beschreibbar, `statusDetails.name` |  |
| `updatedAt` | `datetime` | Aktualisiert am | [ ] | Filter auf der Plattform, beschreibbar, `updatedAt` |  |
| `workOrderInfo` | `varchar2` | Informationen zum Arbeitsauftrag | [ ] | Filter auf der Plattform, beschreibbar, `workOrderInfo` | Beim Lesen nur vorhanden, wenn über den Abfrageparameter 'include' angefordert, andernfalls null.HTML-Inhalt.Eingebettete Bilder werden anhand des Request-Headers 'x-robaws-html-image-mode' in URLs aufgelöst: TEMPORARY_URL (Standard) liefert zeitlich begrenzte signierte URLs, die keine Authentifizierung erfordern; PERMANENT_URL liefert stabile URLs, die eine authentifizierte Sitzung erfordern; NONE liefert das gespeicherte HTML, wobei jedes Bild ein <img> mit einer data-robaws-id und einem leeren src ist – behalten Sie dieses Tag und seine data-robaws-id beim Zurückschreiben des HTML bei, sonst geht das Bild verloren.Jeder andere Wert (z. B.BASE64_INLINE) gibt 400 Bad Request zurück.Beim Schreiben weglassen oder null senden, um den aktuellen Text beizubehalten; einen leeren String senden, um ihn zu leeren. |

## Tasten

| Key | Column | Bezieht sich auf | Kind | Description |
|---|---|---|---|---|
| `Projects_clientContactId_txt` | `clientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Projects_clientId_txt` | `clientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Projects_companyId_fk` | `companyId` | [Companies](Robaws.Companies.Companies)`.id` | Key |  |
| `Projects_endClientContactId_fk` | `endClientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Key |  |
| `Projects_endClientId_txt` | `endClientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |
| `Projects_siteManagerId_txt` | `siteManagerId` | [Users](Robaws.Users.Users)`.id` | Textual | Die referenzierte Zeile, solange Robaws sie noch auflistet: Eine gelöschte oder bereinigte Zeile wird nicht mehr aufgelistet, und ein Dokument kann weiterhin auf sie verweisen. |

## Verwiesen von

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `projectId` (Text)
- [Installationen](Robaws.Installations.Installations) `assignedProjectId` (Textuell)
- [Materialien](Robaws.Materials.Materials) `assignedProjectId` (Textuell)
- [ProjectConstructionPartners](Robaws.ProjectConstructionPartners.ProjectConstructionPartners) `projectId` (Key)
- [SalesInvoiceLineItems](Robaws.SalesInvoiceLineItems.SalesInvoiceLineItems) `projectId` (Text)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `projectId` (Text)
- [Abrechnungen](Robaws.Settlements.Settlements) `projectId` (Textuell)
- [StockReservations](Robaws.StockReservations.StockReservations) `projectId` (Text)
- [SubscriptionLineItems](Robaws.SubscriptionLineItems.SubscriptionLineItems) `projectId` (Key)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `projectId` (Text)

## Beispiel-Queries

```sql
select prj.logicId
,      prj.date
,      prj.siteAddress_city site_city
,      cnt.name client_name
from   Robaws.Projects.Projects prj
join   Robaws.Clients.Clients cnt
on     cnt.id = prj.clientId
where  prj.archivedAt is null
```


## Anmerkungen zu dieser Version

Was hat sich in den Tabellen, Spalten, Attributen und Funktionen des Treibers mit jeder neuen Version geändert:

- [ROBAWS](/de/release-notes/drivers?driver=robaws)
