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

# SalesInvoices: Robaws Fatture di vendita

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

- Catalogo: `Robaws`
- Schema: `SalesInvoices`
- Chiavi primarie: `id`
- Etichetta: Fatture di vendita

Cerca

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

## Codice sorgente dell'API

- Punto finale: `/api/v2/sales-invoices`
- Operazione: `get /api/v2/sales-invoices`

## Caratteristiche prestazionali

| Characteristic | Value |
|---|---:|
| Latenza media di accesso (ms) | 134 |
| Righe di scansione completa al minuto | 26,819 |
| Numero di righe di Query al minuto | 933 |
| Scrittura di righe al minuto | 539 |

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

## Parametri

| Name | Tipo di dati | Required | Default | Documentation |
|---|---|:---:|---|---|
| `articleId` | `` | [ ] |  |  |
| `clientId` | `` | [ ] |  |  |
| `deliveryNoteId` | `` | [ ] |  |  |
| `fromDate` | `` | [ ] |  |  |
| `journalId` | `` | [ ] |  |  |
| `journalName` | `` | [ ] |  |  |
| `materialId` | `` | [ ] |  |  |
| `projectId` | `` | [ ] |  |  |
| `salesOrderId` | `` | [ ] |  |  |
| `searchText` | `` | [ ] |  |  |
| `sort` | `` | [ ] |  |  |
| `subscriptionId` | `` | [ ] |  |  |
| `toDate` | `` | [ ] |  |  |
| `type` | `` | [ ] |  | Valori: INVOICE, CREDIT_NOTE. |
| `updatedFrom` | `` | [ ] |  |  |
| `withArchived` | `` | [ ] |  |  |
| `workOrderId` | `` | [ ] |  |  |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `SalesInvoices`. 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 |
|---|---|---|:---:|---|---|
| `accountancyStatus` | `varchar2` | Stato della contabilità | [ ] | filtri sulla piattaforma, modificabili, `accountancyStatus` |  |
| `advanceInvoice` | `char` | Fattura anticipata | [ ] | filtri sulla piattaforma, modificabili, `advanceInvoice` |  |
| `advancePercentage` | `decimal` | Avanzamento (%) | [ ] | filtri sulla piattaforma, modificabili, `advancePercentage` | La percentuale di acconto, espressa su una scala da 0 a 100. |
| `archivedAt` | `datetime` | Archiviato in | [ ] | filtri sulla piattaforma, modificabili, `archivedAt` |  |
| `assignedUserId` | `varchar2` | ID utente assegnato | [ ] | filtri sulla piattaforma, modificabili, `assignedUserId` |  |
| `booked` | `char` | Booked | [ ] | filtri sulla piattaforma, modificabili, `booked` |  |
| `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` |  |
| `contactPersonId` | `varchar2` | ID persona di contatto | [ ] | filtri sulla piattaforma, modificabili, `contactPersonId` |  |
| `createdAt` | `datetime` | Creato il | [ ] | filtri sulla piattaforma, modificabili, `createdAt` |  |
| `creditedInvoiceId` | `varchar2` | ID della fattura accreditata | [ ] | filtri sulla piattaforma, modificabili, `creditedInvoiceId` | Presente solo per le fatture di tipo CREDIT_NOTE.È l'id della fattura stornata da questa nota di credito. |
| `creditedTotal` | `decimal` | Totale accreditato | [ ] | filtri sulla piattaforma, modificabili, `creditedTotal` | Presente solo per le fatture di tipo INVOICE |
| `currency` | `varchar2` | Currency | [ ] | filtri sulla piattaforma, modificabili, `currency` |  |
| `date` | `datetime` | Date | [ ] | filtri sulla piattaforma, modificabili, `date` |  |
| `deletedAt` | `datetime` | Eliminato alle | [ ] | filtri sulla piattaforma, modificabili, `deletedAt` |  |
| `deliveryClientId` | `varchar2` | Client ID per la consegna | [ ] | filtri sulla piattaforma, modificabili, `deliveryClientId` |  |
| `deliveryNoteId` | `varchar2` | ID della bolla di consegna | [ ] | filtri sulla piattaforma, modificabili, `deliveryNoteId` |  |
| `documentId` | `varchar2` | ID del documento | [ ] | filtri sulla piattaforma, modificabili, `documentId` |  |
| `exchangeRate` | `decimal` | Tasso di cambio | [ ] | filtri sulla piattaforma, modificabili, `exchangeRate` |  |
| `expireDate` | `datetime` | Data di scadenza | [ ] | filtri sulla piattaforma, modificabili, `expireDate` |  |
| `extraFields` | `varchar2` | Campi aggiuntivi | [ ] | writable | Il testo JSON dell'oggetto annidato. |
| `finalInvoice` | `char` | Fattura finale | [ ] | filtri sulla piattaforma, modificabili, `finalInvoice` |  |
| `holdbackItem_calculatedAmount` | `decimal` | Voce di trattenuta – Importo calcolato | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.calculatedAmount` |  |
| `holdbackItem_deadline` | `datetime` | Scadenza per la voce soggetta a trattenuta | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.deadline` |  |
| `holdbackItem_fixedAmount` | `decimal` | Voce di trattenuta – Importo fisso | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.fixedAmount` |  |
| `holdbackItem_numberOfDays` | `int32` | Ritenuta - Numero di giorni | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.numberOfDays` |  |
| `holdbackItem_percentage` | `decimal` | Percentuale di trattenuta per voce | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.percentage` |  |
| `holdbackItem_type` | `varchar2` | Tipo di voce di trattenuta | [ ] | filtri sulla piattaforma, modificabili, `holdbackItem.type` |  |
| `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. |
| `invoicePeriod_end` | `datetime` | Fine del periodo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoicePeriod.end` |  |
| `invoicePeriod_start` | `datetime` | Inizio del periodo di fatturazione | [ ] | filtri sulla piattaforma, modificabili, `invoicePeriod.start` |  |
| `journalId` | `varchar2` | ID articolo | [ ] | filtri sulla piattaforma, modificabili, `journalId` |  |
| `journalName` | `varchar2` | Nome della rivista | [ ] | filtri sulla piattaforma, modificabili, `journalName` | Obsoleto.Per creare le fatture usare invece companyId e journalId. |
| `lockedAt` | `datetime` | Bloccato su | [ ] | filtri sulla piattaforma, modificabili, `lockedAt` |  |
| `logicId` | `varchar2` | ID logico | [ ] | filtri sulla piattaforma, modificabili, `logicId` |  |
| `openTotal` | `decimal` | Totale aperto | [ ] | filtri sulla piattaforma, modificabili, `openTotal` |  |
| `originType` | `varchar2` | Tipo di origine | [ ] | filtri sulla piattaforma, modificabili, `originType` |  |
| `paidTotal` | `decimal` | Totale pagato | [ ] | filtri sulla piattaforma, modificabili, `paidTotal` |  |
| `paymentConditionId` | `varchar2` | ID delle condizioni di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentConditionId` |  |
| `paymentInstruction` | `varchar2` | Istruzioni di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentInstruction` |  |
| `peppolResponseStatus` | `varchar2` | Stato della risposta Peppol | [ ] | filtri sulla piattaforma, modificabili, `peppolResponseStatus` |  |
| `peppolSentDate` | `datetime` | Data di invio di Peppol | [ ] | filtri sulla piattaforma, modificabili, `peppolSentDate` |  |
| `peppolStatus` | `varchar2` | Stato Peppol | [ ] | filtri sulla piattaforma, modificabili, `peppolStatus` |  |
| `poNumber` | `varchar2` | Numero d'ordine | [ ] | filtri sulla piattaforma, modificabili, `poNumber` |  |
| `rechnungType` | `varchar2` | Tipo di fattura tedesca | [ ] | filtri sulla piattaforma, modificabili, `rechnungType` |  |
| `remark` | `varchar2` | Remark | [ ] | filtri sulla piattaforma, modificabili, `remark` |  |
| `rentalInvoicingPeriodId` | `varchar2` | ID del periodo di fatturazione del noleggio | [ ] | filtri sulla piattaforma, modificabili, `rentalInvoicingPeriodId` |  |
| `selfBilling` | `char` | Autofatturazione | [ ] | filtri sulla piattaforma, modificabili, `selfBilling` |  |
| `selfBillingNumber` | `varchar2` | Numero di autofatturazione | [ ] | filtri sulla piattaforma, modificabili, `selfBillingNumber` |  |
| `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` |  |
| `subscriptionId` | `varchar2` | ID dell'abbonamento | [ ] | filtri sulla piattaforma, modificabili, `subscriptionId` |  |
| `totalExclVat` | `decimal` | Totale IVA esclusa | [ ] | filtri sulla piattaforma, modificabili, `totalExclVat` | Totale delle righe al netto dell'IVA, nella valuta del documento (attributes.currency); il tasso di cambio non viene applicato.In /aggregate, SUM, AVG, MIN e MAX considerano negativa una nota di credito; /query restituisce il valore così come memorizzato. |
| `totalInclVat` | `decimal` | Totale IVA inclusa | [ ] | filtri sulla piattaforma, modificabili, `totalInclVat` | Totale IVA inclusa, nella valuta del documento (attributes.currency); il tasso di cambio non viene applicato.In /aggregate, SUM, AVG, MIN e MAX considerano negativa una nota di credito; /query restituisce il valore così come memorizzato. |
| `type` | `varchar2` | Type | [ ] | filtri sulla piattaforma, modificabili, `type` |  |
| `updatedAt` | `datetime` | Aggiornato il | [ ] | filtri sulla piattaforma, modificabili, `updatedAt` |  |
| `withRespectTo` | `varchar2` | In merito a | [ ] | filtri sulla piattaforma, modificabili, `withRespectTo` |  |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `SalesInvoices_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. |
| `SalesInvoices_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. |
| `SalesInvoices_companyId_fk` | `companyId` | [Companies](Robaws.Companies.Companies)`.id` | Key |  |
| `SalesInvoices_creditedInvoiceId_txt` | `creditedInvoiceId` | [SalesInvoices](Robaws.SalesInvoices.SalesInvoices)`.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. |
| `SalesInvoices_deliveryNoteId_fk` | `deliveryNoteId` | [DeliveryNotes](Robaws.DeliveryNotes.DeliveryNotes)`.id` | Key |  |
| `SalesInvoices_subscriptionId_fk` | `subscriptionId` | [Subscriptions](Robaws.Subscriptions.Subscriptions)`.id` | Key |  |

## Riferito da

- [SalesInvoices](Robaws.SalesInvoices.SalesInvoices) `creditedInvoiceId` (Testuale)

## Esempi di Query

```sql
select inv.logicId
,      inv.date
,      inv.expireDate
,      inv.openTotal
,      cnt.name client_name
from   Robaws.SalesInvoices.SalesInvoices inv
join   Robaws.Clients.Clients cnt
on     cnt.id = inv.clientId
where  inv.openTotal > 0
```


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