---
title: "PlanningItems (Robaws)"
description: "Planning Items"
language: de
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/de/datamodels/robaws/Robaws.PlanningItems.PlanningItems
original: https://documentation.invantive.eu/en/datamodels/robaws/Robaws.PlanningItems.PlanningItems
updated: 2026-11-18T23:42:59Z
license: https://documentation.invantive.eu/de/
---

# PlanningItems: Robaws Planungselemente

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

- Katalog: `Robaws`
- Schema: `PlanningItems`
- Primärschlüssel: `id`
- Bezeichnung: Planungselemente

Suchen

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

## API-Quelle

- Endpunkt: `/api/v2/planning-items`
- Operation: `get /api/v2/planning-items`

## Leistungsmerkmale

| Characteristic | Value |
|---|---:|
| Durchschnittliche Zugriffsverzögerung (ms) | 145 |
| Anzahl der Vollscan-Zeilen pro Minute | 21,036 |
| Anzahl der Query-Zeilen pro Minute | 513 |
| Zeilen pro Minute schreiben | 539 |

Das Ergebnis kann auf dem Client im Cache zwischengespeichert werden.

## Parameter

| Name | Datentyp | Required | Default | Documentation |
|---|---|:---:|---|---|
| `employeeId` | `` | [ ] |  |  |
| `fromDate` | `` | [ ] |  |  |
| `inWaitingRoom` | `` | [ ] |  |  |
| `materialId` | `` | [ ] |  |  |
| `orderId` | `` | [ ] |  |  |
| `projectId` | `` | [ ] |  |  |
| `salesOrderId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `toDate` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Tabellenspalten

Die Spalten der Tabelle `PlanningItems` 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 |
|---|---|---|:---:|---|---|
| `address_addressLine1` | `varchar2` | Adresszeile 1 | [ ] | Filter auf der Plattform, beschreibbar, `address.addressLine1` |  |
| `address_addressLine2` | `varchar2` | Adresszeile 2 | [ ] | Filter auf der Plattform, beschreibbar, `address.addressLine2` |  |
| `address_city` | `varchar2` | City | [ ] | Filter auf der Plattform, beschreibbar, `address.city` |  |
| `address_country` | `varchar2` | Country | [ ] | Filter auf der Plattform, beschreibbar, `address.country` |  |
| `address_latitude` | `double` | Adresse Breitengrad | [ ] | Filter auf der Plattform, beschreibbar, `address.latitude` |  |
| `address_longitude` | `double` | Adresse Längengrad | [ ] | Filter auf der Plattform, beschreibbar, `address.longitude` |  |
| `address_postalCode` | `varchar2` | Adresse Postleitzahl | [ ] | Filter auf der Plattform, beschreibbar, `address.postalCode` |  |
| `archivedAt` | `datetime` | Archiviert am | [ ] | Filter auf der Plattform, beschreibbar, `archivedAt` |  |
| `basePlanningItemId` | `varchar2` | ID des Basisplanungselements | [ ] | Filter auf der Plattform, beschreibbar, `basePlanningItemId` |  |
| `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` |  |
| `contactId` | `varchar2` | Kontakt-ID | [ ] | Filter auf der Plattform, beschreibbar, `contactId` |  |
| `createdAt` | `datetime` | Erstellt bei | [ ] | Filter auf der Plattform, beschreibbar, `createdAt` |  |
| `deletedAt` | `datetime` | Gelöscht am | [ ] | Filter auf der Plattform, beschreibbar, `deletedAt` |  |
| `description` | `varchar2` | Description | [ ] | Filter auf der Plattform, beschreibbar, `description` | 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. |
| `endClientContactId` | `varchar2` | ID des Endkundenkontakts | [ ] | Filter auf der Plattform, beschreibbar, `endClientContactId` |  |
| `endClientId` | `varchar2` | End client ID | [ ] | Filter auf der Plattform, beschreibbar, `endClientId` |  |
| `endDate` | `datetime` | Enddatum | [ ] | Filter auf der Plattform, beschreibbar, `endDate` | Ein Element befindet sich im Wartebereich und nicht in der Tagesplanung, solange sein Startdatum oder sein Enddatum leer ist.Um den Wartebereich abzurufen, filtern Sie danach, dass eines der beiden Datumsfelder leer ist (ein ODER beider Bedingungen).Ein Element ist in der Tagesplanung eines Zeitraums, wenn es ihn überschneidet: startDate am oder vor dem letzten Tag des Zeitraums und endDate am oder nach seinem ersten Tag; das Filtern nur nach startDate übersieht Elemente, die vor dem Zeitraum begonnen haben. |
| `executionPhaseDetail` | `varchar2` | Details zur Ausführungsphase | [ ] | Filter auf der Plattform, beschreibbar, `executionPhaseDetail` |  |
| `executionPhaseId` | `varchar2` | ID der Ausführungsphase | [ ] | Filter auf der Plattform, beschreibbar, `executionPhaseId` |  |
| `externalId` | `varchar2` | Externe ID | [ ] | Filter auf der Plattform, beschreibbar, `externalId` |  |
| `extraFields` | `varchar2` | Zusätzliche Felder | [ ] | writable | Der JSON-Text des verschachtelten Objekts. |
| `hourTypeId` | `varchar2` | Stundentyp-ID | [ ] | Filter auf der Plattform, beschreibbar, `hourTypeId` |  |
| `id` | `varchar2` | ID | [ ] | Filter auf der Plattform, beschreibbar, `id` |  |
| `lockedAt` | `datetime` | Gesperrt bei | [ ] | Filter auf der Plattform, beschreibbar, `lockedAt` |  |
| `numberOfWorkOrders` | `int32` | Anzahl der Arbeitsaufträge | [ ] | Filter auf der Plattform, beschreibbar, `numberOfWorkOrders` | Beim Lesen nur vorhanden, wenn über den Abfrageparameter 'include' angefordert, andernfalls null. |
| `phaseId` | `varchar2` | Phasen-ID | [ ] | Filter auf der Plattform, beschreibbar, `phaseId` |  |
| `planningTypeId` | `varchar2` | Planungsart-ID | [ ] | Filter auf der Plattform, beschreibbar, `planningTypeId` |  |
| `projectId` | `varchar2` | Projekt ID | [ ] | Filter auf der Plattform, beschreibbar, `projectId` |  |
| `recurrenceEndDate` | `datetime` | Enddatum der Wiederholung | [ ] | Filter auf der Plattform, beschreibbar, `recurrenceEndDate` |  |
| `recurrenceRule` | `varchar2` | Wiederholungsregel | [ ] | Filter auf der Plattform, beschreibbar, `recurrenceRule` |  |
| `recurring` | `char` | Recurring | [ ] | Filter auf der Plattform, beschreibbar, `recurring` |  |
| `recurringMode` | `varchar2` | Wiederholungsmodus | [ ] | Filter auf der Plattform, beschreibbar, `recurringMode` | Veraltet, verwenden Sie stattdessen recurrenceRule. |
| `salesOrderId` | `varchar2` | Verkaufsauftrag ID | [ ] | Filter auf der Plattform, beschreibbar, `salesOrderId` |  |
| `startDate` | `datetime` | Anfangsdatum | [ ] | Filter auf der Plattform, beschreibbar, `startDate` | Ein Element befindet sich im Wartebereich und nicht in der Tagesplanung, solange sein Startdatum oder sein Enddatum leer ist.Um den Wartebereich abzurufen, filtern Sie danach, dass eines der beiden Datumsfelder leer ist (ein ODER beider Bedingungen).Ein Element ist in der Tagesplanung eines Zeitraums, wenn es ihn überschneidet: startDate am oder vor dem letzten Tag des Zeitraums und endDate am oder nach seinem ersten Tag; das Filtern nur nach startDate übersieht Elemente, die vor dem Zeitraum begonnen haben. |
| `summary` | `varchar2` | Summary | [ ] | Filter auf der Plattform, beschreibbar, `summary` |  |
| `timeAndMaterial` | `char` | Zeit und Material | [ ] | Filter auf der Plattform, beschreibbar, `timeAndMaterial` |  |
| `timeOffCategoryId` | `varchar2` | ID der Freistellungskategorie | [ ] | Filter auf der Plattform, beschreibbar, `timeOffCategoryId` |  |
| `transportId` | `varchar2` | Transport-ID | [ ] | Filter auf der Plattform, beschreibbar, `transportId` |  |
| `unavailableReason` | `varchar2` | Grund für die Nichtverfügbarkeit | [ ] | Filter auf der Plattform, beschreibbar, `unavailableReason` | Veraltet, verwenden Sie stattdessen timeOffCategory. |
| `unavailableReasonDetails_color` | `varchar2` | Grund für die Nichtverfügbarkeit – Details – Farbe | [ ] | Filter auf der Plattform, beschreibbar, `unavailableReasonDetails.color` |  |
| `unavailableReasonDetails_name` | `varchar2` | Grund für die Nichtverfügbarkeit – Details – Name | [ ] | Filter auf der Plattform, beschreibbar, `unavailableReasonDetails.name` |  |
| `updatedAt` | `datetime` | Aktualisiert am | [ ] | Filter auf der Plattform, beschreibbar, `updatedAt` |  |

## Tasten

| Key | Column | Bezieht sich auf | Kind | Description |
|---|---|---|---|---|
| `PlanningItems_basePlanningItemId_fk` | `basePlanningItemId` | [PlanningItems](Robaws.PlanningItems.PlanningItems)`.id` | Key |  |
| `PlanningItems_clientId_fk` | `clientId` | [Clients](Robaws.Clients.Clients)`.id` | Key |  |
| `PlanningItems_companyId_fk` | `companyId` | [Companies](Robaws.Companies.Companies)`.id` | Key |  |
| `PlanningItems_contactId_fk` | `contactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Key |  |
| `PlanningItems_endClientContactId_fk` | `endClientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Key |  |
| `PlanningItems_endClientId_fk` | `endClientId` | [Clients](Robaws.Clients.Clients)`.id` | Key |  |
| `PlanningItems_executionPhaseId_fk` | `executionPhaseId` | [ExecutionPhases](Robaws.ExecutionPhases.ExecutionPhases)`.id` | Key |  |
| `PlanningItems_planningTypeId_fk` | `planningTypeId` | [PlanningTypes](Robaws.PlanningTypes.PlanningTypes)`.id` | Key |  |
| `PlanningItems_salesOrderId_fk` | `salesOrderId` | [SalesOrders](Robaws.SalesOrders.SalesOrders)`.id` | Key |  |

## Verwiesen von

- [Abwesenheiten](Robaws.Absences.Absences) `planningItemId` (Schlüssel)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `basePlanningItemId` (Key)


## 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)
