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

# Offerte: Robaws Offers

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

- Catalogo: `Robaws`
- Schema: `Offers`
- Chiavi primarie: `id`
- Etichetta: Offerte

Cerca

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

## Codice sorgente dell'API

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

## Caratteristiche prestazionali

| Characteristic | Value |
|---|---:|
| Latenza media di accesso (ms) | 152 |
| Righe di scansione completa al minuto | 6,260 |
| Numero di righe di Query al minuto | 683 |
| Scrittura di righe al minuto | 539 |

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

## Parametri

| Name | Tipo di dati | Required | Default | Documentation |
|---|---|:---:|---|---|
| `calculated` | `` | [ ] |  |  |
| `clientId` | `` | [ ] |  |  |
| `groupId` | `` | [ ] |  |  |
| `projectId` | `` | [ ] |  |  |
| `salesInvoiceId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `Offers`. 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 |
|---|---|---|:---:|---|---|
| `activeOnProject` | `char` | Attivo nel progetto | [ ] | filtri sulla piattaforma, modificabili, `activeOnProject` |  |
| `addressDistance_unit` | `varchar2` | Indirizzo Distanza Unità di misura | [ ] | filtri sulla piattaforma, modificabili, `addressDistance.unit` |  |
| `addressDistance_value` | `int32` | Indirizzo Distanza Valore | [ ] | filtri sulla piattaforma, modificabili, `addressDistance.value` |  |
| `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` |  |
| `assignedUserId` | `varchar2` | ID utente assegnato | [ ] | filtri sulla piattaforma, modificabili, `assignedUserId` |  |
| `calculated` | `char` | Calculated | [ ] | filtri sulla piattaforma, modificabili, `calculated` |  |
| `calculationStatus` | `varchar2` | Stato del calcolo | [ ] | filtri sulla piattaforma, modificabili, `calculationStatus` |  |
| `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` |  |
| `commission` | `decimal` | Commission | [ ] | filtri sulla piattaforma, modificabili, `commission` |  |
| `commissionAmount` | `decimal` | Importo della commissione | [ ] | filtri sulla piattaforma, modificabili, `commissionAmount` |  |
| `companyId` | `varchar2` | ID dell'azienda | [ ] | filtri sulla piattaforma, modificabili, `companyId` |  |
| `createdAt` | `datetime` | Creato il | [ ] | filtri sulla piattaforma, modificabili, `createdAt` |  |
| `currency` | `varchar2` | Currency | [ ] | filtri sulla piattaforma, modificabili, `currency` |  |
| `date` | `datetime` | Date | [ ] | filtri sulla piattaforma, modificabili, `date` |  |
| `deadlineDate` | `datetime` | Data di scadenza | [ ] | filtri sulla piattaforma, modificabili, `deadlineDate` |  |
| `deletedAt` | `datetime` | Eliminato alle | [ ] | filtri sulla piattaforma, modificabili, `deletedAt` |  |
| `endClientContactId` | `varchar2` | ID di contatto del cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientContactId` |  |
| `endClientId` | `varchar2` | ID cliente finale | [ ] | filtri sulla piattaforma, modificabili, `endClientId` |  |
| `expireDate` | `datetime` | Data di scadenza | [ ] | filtri sulla piattaforma, modificabili, `expireDate` |  |
| `extraFields` | `varchar2` | Campi aggiuntivi | [ ] | writable | Il testo JSON dell'oggetto annidato. |
| `followUpDate` | `datetime` | Data di follow-up | [ ] | filtri sulla piattaforma, modificabili, `followUpDate` |  |
| `footerText` | `varchar2` | Testo del piè di pagina | [ ] | filtri sulla piattaforma, modificabili, `footerText` | 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. |
| `groupId` | `varchar2` | ID del gruppo | [ ] | filtri sulla piattaforma, modificabili, `groupId` |  |
| `id` | `varchar2` | ID | [ ] | filtri sulla piattaforma, modificabili, `id` |  |
| `introText` | `varchar2` | Testo introduttivo | [ ] | filtri sulla piattaforma, modificabili, `introText` | 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. |
| `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` |  |
| `marginOtherCost` | `double` | Margine Altri costi | [ ] | filtri sulla piattaforma, modificabili, `marginOtherCost` |  |
| `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` |  |
| `projectId` | `varchar2` | Identificatore del progetto | [ ] | filtri sulla piattaforma, modificabili, `projectId` |  |
| `receivedDate` | `datetime` | Data di ricezione | [ ] | filtri sulla piattaforma, modificabili, `receivedDate` |  |
| `statistics_totalArticleCost` | `decimal` | Statistiche - Costo totale dell'articolo | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalArticleCost` |  |
| `statistics_totalLaborCost` | `decimal` | Statistiche sul costo totale del lavoro | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalLaborCost` |  |
| `statistics_totalLaborHours` | `decimal` | Statistiche: ore di lavoro totali | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalLaborHours` |  |
| `statistics_totalMaterialCost` | `decimal` | Statistiche: costo totale dei materiali | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalMaterialCost` |  |
| `statistics_totalSubcontractorCost` | `decimal` | Statistiche: costo totale dei subappaltatori | [ ] | filtri sulla piattaforma, modificabili, `statistics.totalSubcontractorCost` |  |
| `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` |  |
| `statusSuccessPercentage` | `decimal` | Stato Percentuale di successo | [ ] | filtri sulla piattaforma, modificabili, `statusSuccessPercentage` |  |
| `tenderDate` | `datetime` | Data di gara | [ ] | filtri sulla piattaforma, modificabili, `tenderDate` |  |
| `title` | `varchar2` | Title | [ ] | filtri sulla piattaforma, modificabili, `title` |  |
| `totalCostPrice` | `decimal` | Prezzo di costo totale | [ ] | filtri sulla piattaforma, modificabili, `totalCostPrice` |  |
| `totalExclVat` | `decimal` | Totale IVA esclusa | [ ] | filtri sulla piattaforma, modificabili, `totalExclVat` |  |
| `totalInclVat` | `decimal` | Totale IVA inclusa | [ ] | filtri sulla piattaforma, modificabili, `totalInclVat` |  |
| `totalIndirectCosts` | `decimal` | Costi indiretti totali | [ ] | filtri sulla piattaforma, modificabili, `totalIndirectCosts` |  |
| `totalMargin` | `decimal` | Margine totale | [ ] | filtri sulla piattaforma, modificabili, `totalMargin` |  |
| `updatedAt` | `datetime` | Aggiornato il | [ ] | filtri sulla piattaforma, modificabili, `updatedAt` |  |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `Offers_assignedUserId_txt` | `assignedUserId` | [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. |
| `Offers_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. |
| `Offers_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. |
| `Offers_companyId_fk` | `companyId` | [Companies](Robaws.Companies.Companies)`.id` | Key |  |
| `Offers_endClientContactId_fk` | `endClientContactId` | [Contacts](Robaws.Contacts.Contacts)`.id` | Key |  |
| `Offers_endClientId_fk` | `endClientId` | [Clients](Robaws.Clients.Clients)`.id` | 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)
