---
title: "PlanningItems (Robaws)"
description: "Planning Items"
language: it
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/it/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/it/
---

# PlanningItems: Robaws Planning Items

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

- Catalogo: `Robaws`
- Schema: `PlanningItems`
- Chiavi primarie: `id`
- Etichetta: Planning Items

Cerca

È possibile recuperare e modificare i dati utilizzando `insert`, `update` e `delete`.

## Codice sorgente dell'API

- Punto finale: `/api/v2/planning-items`
- Operazione: `get /api/v2/planning-items`

## Caratteristiche prestazionali

| Characteristic | Value |
|---|---:|
| Latenza media di accesso (ms) | 145 |
| Righe di scansione completa al minuto | 21,036 |
| Numero di righe di Query al minuto | 513 |
| Scrittura di righe al minuto | 539 |

Il risultato può essere memorizzato nella memoria cache sul client.

## Parametri

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

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `PlanningItems`. Ogni colonna ha un tipo di dati SQL. Un nuovo valore non nullo deve essere fornito per ogni colonna richiesta in ogni momento durante l'inserimento e l'aggiornamento.

| Name | Tipo di dati | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `address_addressLine1` | `varchar2` | Indirizzo 1 | [ ] | filtri sulla piattaforma, modificabili, `address.addressLine1` |  |
| `address_addressLine2` | `varchar2` | Indirizzo 2 | [ ] | filtri sulla piattaforma, modificabili, `address.addressLine2` |  |
| `address_city` | `varchar2` | City | [ ] | filtri sulla piattaforma, modificabili, `address.city` |  |
| `address_country` | `varchar2` | Country | [ ] | filtri sulla piattaforma, modificabili, `address.country` |  |
| `address_latitude` | `double` | Indirizzo Latitudine | [ ] | filtri sulla piattaforma, modificabili, `address.latitude` |  |
| `address_longitude` | `double` | Longitudine dell'indirizzo | [ ] | filtri sulla piattaforma, modificabili, `address.longitude` |  |
| `address_postalCode` | `varchar2` | Indirizzo Codice postale | [ ] | filtri sulla piattaforma, modificabili, `address.postalCode` |  |
| `archivedAt` | `datetime` | Archiviato in | [ ] | filtri sulla piattaforma, modificabili, `archivedAt` |  |
| `basePlanningItemId` | `varchar2` | ID articolo di pianificazione di base | [ ] | filtri sulla piattaforma, modificabili, `basePlanningItemId` |  |
| `clientId` | `varchar2` | ID del cliente | [ ] | filtri sulla piattaforma, modificabili, `clientId` |  |
| `clientReference` | `varchar2` | Referenza del cliente | [ ] | filtri sulla piattaforma, modificabili, `clientReference` |  |
| `companyId` | `varchar2` | ID dell'azienda | [ ] | filtri sulla piattaforma, modificabili, `companyId` |  |
| `contactId` | `varchar2` | ID contatto | [ ] | filtri sulla piattaforma, modificabili, `contactId` |  |
| `createdAt` | `datetime` | Creato il | [ ] | filtri sulla piattaforma, modificabili, `createdAt` |  |
| `deletedAt` | `datetime` | Eliminato alle | [ ] | filtri sulla piattaforma, modificabili, `deletedAt` |  |
| `description` | `varchar2` | Description | [ ] | filtri sulla piattaforma, modificabili, `description` | Contenuto HTML.Le immagini incorporate vengono risolte in URL in base all'intestazione della richiesta 'x-robaws-html-image-mode': TEMPORARY_URL (predefinito) restituisce URL prefirmati a tempo limitato che non richiedono autenticazione; PERMANENT_URL restituisce URL stabili che richiedono una sessione autenticata; NONE restituisce l'HTML memorizzato, in cui ogni immagine è un <img> con un data-robaws-id e un src vuoto: mantenere questo tag e il suo data-robaws-id quando si riscrive l'HTML, altrimenti l'immagine viene persa.Qualsiasi altro valore (ad es.BASE64_INLINE) restituisce 400 Bad Request. |
| `endClientContactId` | `varchar2` | ID di contatto del cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientContactId` |  |
| `endClientId` | `varchar2` | ID cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientId` |  |
| `endDate` | `datetime` | Data di fine | [ ] | filtri sulla piattaforma, modificabili, `endDate` | Un elemento si trova nella sala d'attesa, e non nella pianificazione giornaliera, finché la sua data di inizio o la sua data di fine è vuota.Per ottenere la sala d'attesa, filtrare con una delle due date vuota (un OR delle due).Un elemento si trova nella pianificazione giornaliera di un periodo quando si sovrappone ad esso: startDate uguale o precedente all'ultimo giorno del periodo e endDate uguale o successivo al suo primo giorno; filtrare solo per startDate non include gli elementi iniziati prima del periodo. |
| `executionPhaseDetail` | `varchar2` | Dettaglio della fase di esecuzione | [ ] | filtri sulla piattaforma, modificabili, `executionPhaseDetail` |  |
| `executionPhaseId` | `varchar2` | ID della fase di esecuzione | [ ] | filtri sulla piattaforma, modificabili, `executionPhaseId` |  |
| `externalId` | `varchar2` | ID esterno | [ ] | filtri sulla piattaforma, modificabili, `externalId` |  |
| `extraFields` | `varchar2` | Campi aggiuntivi | [ ] | writable | Il testo JSON dell'oggetto annidato. |
| `hourTypeId` | `varchar2` | ID tipo ora | [ ] | filtri sulla piattaforma, modificabili, `hourTypeId` |  |
| `id` | `varchar2` | ID | [ ] | filtri sulla piattaforma, modificabili, `id` |  |
| `lockedAt` | `datetime` | Bloccato su | [ ] | filtri sulla piattaforma, modificabili, `lockedAt` |  |
| `numberOfWorkOrders` | `int32` | Numero di ordini di lavoro | [ ] | filtri sulla piattaforma, modificabili, `numberOfWorkOrders` | In lettura, presente solo se richiesto tramite il parametro di query 'include', altrimenti null. |
| `phaseId` | `varchar2` | Fase dell'identificatore | [ ] | filtri sulla piattaforma, modificabili, `phaseId` |  |
| `planningTypeId` | `varchar2` | ID tipo di pianificazione | [ ] | filtri sulla piattaforma, modificabili, `planningTypeId` |  |
| `projectId` | `varchar2` | Identificatore del progetto | [ ] | filtri sulla piattaforma, modificabili, `projectId` |  |
| `recurrenceEndDate` | `datetime` | Data di fine della ricorrenza | [ ] | filtri sulla piattaforma, modificabili, `recurrenceEndDate` |  |
| `recurrenceRule` | `varchar2` | Regola di ricorrenza | [ ] | filtri sulla piattaforma, modificabili, `recurrenceRule` |  |
| `recurring` | `char` | Recurring | [ ] | filtri sulla piattaforma, modificabili, `recurring` |  |
| `recurringMode` | `varchar2` | Modalità ricorrente | [ ] | filtri sulla piattaforma, modificabili, `recurringMode` | Obsoleto, usare recurrenceRule al suo posto. |
| `salesOrderId` | `varchar2` | ID dell'ordine di vendita | [ ] | filtri sulla piattaforma, modificabili, `salesOrderId` |  |
| `startDate` | `datetime` | Data di inizio | [ ] | filtri sulla piattaforma, modificabili, `startDate` | Un elemento si trova nella sala d'attesa, e non nella pianificazione giornaliera, finché la sua data di inizio o la sua data di fine è vuota.Per ottenere la sala d'attesa, filtrare con una delle due date vuota (un OR delle due).Un elemento si trova nella pianificazione giornaliera di un periodo quando si sovrappone ad esso: startDate uguale o precedente all'ultimo giorno del periodo e endDate uguale o successivo al suo primo giorno; filtrare solo per startDate non include gli elementi iniziati prima del periodo. |
| `summary` | `varchar2` | Summary | [ ] | filtri sulla piattaforma, modificabili, `summary` |  |
| `timeAndMaterial` | `char` | Tempo e materiale | [ ] | filtri sulla piattaforma, modificabili, `timeAndMaterial` |  |
| `timeOffCategoryId` | `varchar2` | ID categoria permessi | [ ] | filtri sulla piattaforma, modificabili, `timeOffCategoryId` |  |
| `transportId` | `varchar2` | ID trasporto | [ ] | filtri sulla piattaforma, modificabili, `transportId` |  |
| `unavailableReason` | `varchar2` | Motivo della mancata disponibilità | [ ] | filtri sulla piattaforma, modificabili, `unavailableReason` | Obsoleto, usare timeOffCategory al suo posto. |
| `unavailableReasonDetails_color` | `varchar2` | Motivo della mancata disponibilità - Dettagli - Colore | [ ] | filtri sulla piattaforma, modificabili, `unavailableReasonDetails.color` |  |
| `unavailableReasonDetails_name` | `varchar2` | Motivo della mancata disponibilità Dettagli Nome | [ ] | filtri sulla piattaforma, modificabili, `unavailableReasonDetails.name` |  |
| `updatedAt` | `datetime` | Aggiornato il | [ ] | filtri sulla piattaforma, modificabili, `updatedAt` |  |

## Chiavi

| Key | Column | Si riferisce a | 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 |  |

## Riferito da

- [Absences](Robaws.Absences.Absences) `planningItemId` (Chiave)
- [PlanningItems](Robaws.PlanningItems.PlanningItems) `basePlanningItemId` (Key)


## Note di rilascio

Cosa è cambiato, versione per versione, nelle tabelle, nelle colonne, negli attributi e nelle funzionalità del driver:

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