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

# Progetti: Robaws Progetti

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

- Catalogo: `Robaws`
- Schema: `Projects`
- Chiavi primarie: `id`
- Etichetta: Progetti

Cerca

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

## Codice sorgente dell'API

- Punto finale: `/api/v2/projects`
- Operazione: `get /api/v2/projects`

## Caratteristiche prestazionali

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

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

## Parametri

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

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `Projects`. 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 |
|---|---|---|:---:|---|---|
| `archivedAt` | `datetime` | Archiviato in | [ ] | filtri sulla piattaforma, modificabili, `archivedAt` |  |
| `checkInAtWork` | `varchar2` | Check-in al lavoro | [ ] | filtri sulla piattaforma, modificabili, `checkInAtWork` |  |
| `clientContactId` | `varchar2` | ID di contatto del cliente | [ ] | filtri sulla piattaforma, modificabili, `clientContactId` |  |
| `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` |  |
| `createdAt` | `datetime` | Creato il | [ ] | filtri sulla piattaforma, modificabili, `createdAt` |  |
| `date` | `datetime` | Date | [ ] | filtri sulla piattaforma, modificabili, `date` |  |
| `deletedAt` | `datetime` | Eliminato alle | [ ] | filtri sulla piattaforma, modificabili, `deletedAt` |  |
| `distance` | `int32` | Distance | [ ] | filtri sulla piattaforma, modificabili, `distance` |  |
| `endClientContactId` | `varchar2` | ID di contatto del cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientContactId` |  |
| `endClientId` | `varchar2` | ID cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientId` |  |
| `executorId` | `varchar2` | ID dell'esecutore | [ ] | filtri sulla piattaforma, modificabili, `executorId` |  |
| `extraFields` | `varchar2` | Campi aggiuntivi | [ ] | writable | Il testo JSON dell'oggetto annidato. |
| `geofence` | `varchar2` | Geofence | [ ] | filtri sulla piattaforma, modificabili, `geofence` |  |
| `id` | `varchar2` | ID | [ ] | filtri sulla piattaforma, modificabili, `id` |  |
| `lockedAt` | `datetime` | Bloccato su | [ ] | filtri sulla piattaforma, modificabili, `lockedAt` |  |
| `logicId` | `varchar2` | ID logico | [ ] | filtri sulla piattaforma, modificabili, `logicId` |  |
| `marginArticleCost` | `double` | Costo marginale dell'articolo | [ ] | filtri sulla piattaforma, modificabili, `marginArticleCost` |  |
| `marginMaterialCost` | `double` | Costo dei materiali di margine | [ ] | filtri sulla piattaforma, modificabili, `marginMaterialCost` |  |
| `marginSubcontractorCost` | `double` | Costo del subappaltatore (margine) | [ ] | filtri sulla piattaforma, modificabili, `marginSubcontractorCost` |  |
| `marginWorkCost` | `double` | Costo della manodopera per la lavorazione dei bordi | [ ] | filtri sulla piattaforma, modificabili, `marginWorkCost` |  |
| `nssoDeclarationOfWorks` | `varchar2` | Dichiarazione dei lavori dell'NSSO | [ ] | filtri sulla piattaforma, modificabili, `nssoDeclarationOfWorks` |  |
| `planningGroup` | `varchar2` | Gruppo di pianificazione | [ ] | filtri sulla piattaforma, modificabili, `planningGroup` |  |
| `planningName` | `varchar2` | Nome del progetto | [ ] | filtri sulla piattaforma, modificabili, `planningName` |  |
| `priceGroupId` | `varchar2` | ID gruppo di prezzi | [ ] | filtri sulla piattaforma, modificabili, `priceGroupId` |  |
| `renderedWorkOrderInfo` | `varchar2` | Informazioni sull'ordine di lavoro elaborato | [ ] | filtri sulla piattaforma, modificabili, `renderedWorkOrderInfo` | In lettura, presente solo se richiesto tramite il parametro di query 'include', altrimenti null. |
| `siteAddress_addressLine1` | `varchar2` | Indirizzo del sito - Riga 1 | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.addressLine1` |  |
| `siteAddress_addressLine2` | `varchar2` | Indirizzo del sito - Riga 2 | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.addressLine2` |  |
| `siteAddress_city` | `varchar2` | Indirizzo del sito Città | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.city` |  |
| `siteAddress_country` | `varchar2` | Indirizzo del sito Paese | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.country` |  |
| `siteAddress_latitude` | `double` | Latitudine dell'indirizzo del sito | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.latitude` |  |
| `siteAddress_longitude` | `double` | Indirizzo del sito - Longitudine | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.longitude` |  |
| `siteAddress_postalCode` | `varchar2` | Indirizzo del sito Codice postale | [ ] | filtri sulla piattaforma, modificabili, `siteAddress.postalCode` |  |
| `siteManagerId` | `varchar2` | ID responsabile del sito | [ ] | filtri sulla piattaforma, modificabili, `siteManagerId` |  |
| `siteNssoIdNumber` | `varchar2` | Numero identificativo NSSO del sito | [ ] | filtri sulla piattaforma, modificabili, `siteNssoIdNumber` |  |
| `statistics_claimStateGrandTotal` | `decimal` | Statistiche - Totale complessivo dello Stato | [ ] | filtri sulla piattaforma, modificabili, `statistics.claimStateGrandTotal` |  |
| `statistics_internalSupplyOrderTotalCostPrice` | `decimal` | Statistiche: Ordini interni di approvvigionamento - Costo totale - Prezzo | [ ] | filtri sulla piattaforma, modificabili, `statistics.internalSupplyOrderTotalCostPrice` |  |
| `statistics_offerGrandTotal` | `decimal` | Statistiche: Totale complessivo | [ ] | filtri sulla piattaforma, modificabili, `statistics.offerGrandTotal` |  |
| `statistics_offerTotalCostPrice` | `decimal` | Statistiche sul prezzo di costo totale | [ ] | filtri sulla piattaforma, modificabili, `statistics.offerTotalCostPrice` |  |
| `statistics_offerTotalIndirectCosts` | `decimal` | Le statistiche indicano i costi indiretti totali | [ ] | filtri sulla piattaforma, modificabili, `statistics.offerTotalIndirectCosts` |  |
| `statistics_purchaseInvoiceGrandTotal` | `decimal` | Statistiche Fattura di acquisto Totale complessivo | [ ] | filtri sulla piattaforma, modificabili, `statistics.purchaseInvoiceGrandTotal` |  |
| `statistics_realisedIndirectCosts` | `decimal` | Statistiche sui costi indiretti effettivi | [ ] | filtri sulla piattaforma, modificabili, `statistics.realisedIndirectCosts` |  |
| `statistics_salesInvoiceGrandTotal` | `decimal` | Statistiche - Fatture di vendita - Totale complessivo | [ ] | filtri sulla piattaforma, modificabili, `statistics.salesInvoiceGrandTotal` |  |
| `statistics_settlementGrandTotal` | `decimal` | Statistiche - Totale complessivo del regolamento | [ ] | filtri sulla piattaforma, modificabili, `statistics.settlementGrandTotal` |  |
| `statistics_settlementTotalCostPrice` | `decimal` | Statistiche Liquidazione Costo totale Prezzo | [ ] | filtri sulla piattaforma, modificabili, `statistics.settlementTotalCostPrice` |  |
| `statistics_settlementTotalIndirectCosts` | `decimal` | Statistiche - Liquidazione - Costi indiretti totali | [ ] | filtri sulla piattaforma, modificabili, `statistics.settlementTotalIndirectCosts` |  |
| `statistics_totalBudgetedCosts` | `decimal` | Statistiche: costi totali previsti in bilancio | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalBudgetedCosts` |  |
| `statistics_totalBudgetedHours` | `decimal` | Statistiche: totale delle ore previste in bilancio | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalBudgetedHours` |  |
| `statistics_totalBudgetedIncome` | `decimal` | Statistiche: Entrate totali previste in bilancio | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalBudgetedIncome` |  |
| `statistics_totalForecastedCosts` | `decimal` | Statistiche: costi totali previsti | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalForecastedCosts` |  |
| `statistics_totalForecastedIncome` | `decimal` | Statistiche: reddito totale previsto | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalForecastedIncome` |  |
| `statistics_totalForecastedIndirectCosts` | `decimal` | Statistiche: Totale dei costi indiretti previsti | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalForecastedIndirectCosts` |  |
| `statistics_totalRealisedCosts` | `decimal` | Statistiche sui costi totali effettivi | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalRealisedCosts` |  |
| `statistics_totalRealisedIncome` | `decimal` | Statistiche: reddito totale realizzato | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalRealisedIncome` |  |
| `statistics_workOrderTotalCostPrice` | `decimal` | Statistiche Ordine di lavoro Costo totale Prezzo | [ ] | filtri sulla piattaforma, modificabili, `statistics.workOrderTotalCostPrice` |  |
| `statistics_workOrderTotalHours` | `decimal` | Statistiche relative alle ore totali degli ordini di lavoro | [ ] | filtri sulla piattaforma, modificabili, `statistics.workOrderTotalHours` |  |
| `status` | `varchar2` | Status | [ ] | filtri sulla piattaforma, modificabili, `status` |  |
| `statusDetails_color` | `varchar2` | Dettagli stato Colore | [ ] | filtri sulla piattaforma, modificabili, `statusDetails.color` |  |
| `statusDetails_name` | `varchar2` | Stato Dettagli Nome | [ ] | filtri sulla piattaforma, modificabili, `statusDetails.name` |  |
| `updatedAt` | `datetime` | Aggiornato il | [ ] | filtri sulla piattaforma, modificabili, `updatedAt` |  |
| `workOrderInfo` | `varchar2` | Informazioni sull'ordine di lavoro | [ ] | filtri sulla piattaforma, modificabili, `workOrderInfo` | In lettura, presente solo se richiesto tramite il parametro di query 'include', altrimenti null.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.In scrittura, ometterlo o inviare null per mantenere il testo attuale; inviare una stringa vuota per cancellarlo. |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `Projects_clientContactId_txt` | `clientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `Projects_clientId_txt` | `clientId` | [Clients](Robaws.Clients.Clients)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `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 | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |
| `Projects_siteManagerId_txt` | `siteManagerId` | [Users](Robaws.Users.Users)`.id` | Textual | La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento. |

## Riferito da

- [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes) `projectId` (Testuale)
- [Installations](Robaws.Installations.Installations) `assignedProjectId` (Testuale)
- [Materiali](Robaws.Materials.Materials) `assignedProjectId` (Testuale)
- [ProjectConstructionPartners](Robaws.ProjectConstructionPartners.ProjectConstructionPartners) `projectId` (Key)
- [SalesInvoiceLineItems](Robaws.SalesInvoiceLineItems.SalesInvoiceLineItems) `projectId` (Testuale)
- [SalesOrders](Robaws.SalesOrders.SalesOrders) `projectId` (Testuale)
- [Settlements](Robaws.Settlements.Settlements) `projectId` (Testuale)
- [StockReservations](Robaws.StockReservations.StockReservations) `projectId` (Testuale)
- [SubscriptionLineItems](Robaws.SubscriptionLineItems.SubscriptionLineItems) `projectId` (Key)
- [TimeRegistrations](Robaws.TimeRegistrations.TimeRegistrations) `projectId` (Testuale)

## Esempi di Query

```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
```


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