---
title: "CustomerContracts (Visma.net Financials)"
description: "Customer Contracts"
language: it
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/it/datamodels/vismanet/VismaNet.CustomerContract.CustomerContracts
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.CustomerContract.CustomerContracts
updated: 2026-11-19T00:26:59Z
license: https://documentation.invantive.eu/it/
---

# CustomerContracts: Visma.net Financials Contratti cliente

`insert` `update` `REST`

- Catalogo: `VismaNet`
- Schema: `CustomerContract`
- Chiavi primarie: `contractId`
- Etichetta: Contratti cliente

Ottieni un intervallo di contratti cliente, è necessario specificare un filtro - ScreenId=CT301000

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

## Codice sorgente dell'API

- Punto finale: `/v1/customerContract`
- Operazione: `get /v1/customerContract`

## Caratteristiche prestazionali

| Characteristic | Value |
|---|---:|
| Latenza media di accesso (ms) | 155 |
| Righe di scansione completa al minuto | 29,100 |
| Numero di righe di Query al minuto | 387 |

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

## Parametri

| Name | Tipo di dati | Required | Default | Documentation |
|---|---|:---:|---|---|
| `attributes` | `` | [ ] |  | Attributi (informazioni aggiuntive) collegati all'entità.Esempi: {{base}}/customerContract?attributes={"AttributeID":"ValueID","AttributeID":"ValueID"} {{base}}/customerContract?attributes={"AttributeID":"ValueID1,ValueID2"} |
| `contractTemplate` | `` | [ ] |  |  |
| `customer` | `` | [ ] |  |  |
| `expandAttributes` | `` | [ ] |  |  |
| `expandDetails` | `` | [ ] |  |  |
| `expandSummary` | `` | [ ] |  |  |
| `greaterThanValue` | `` | [ ] |  |  |
| `lastModifiedDateTime` | `` | [ ] |  |  |
| `lastModifiedDateTimeCondition` | `` | [ ] |  |  |
| `status` | `` | [ ] |  | Valori: Bozza, InApproval, Attivo, Scaduto, Annullato, Completato, InUpgrade, PendingActivation. |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `CustomerContracts`. 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 |
|---|---|---|:---:|---|---|
| `COMPANY_CODE` | `varchar2(30)` | Codice aziendale | [x] | writable | Codice di partizione, che segmenta i dati. |
| `COMPANY_NAME` | `varchar2(240)` | Nome dell'impresa | [x] | writable | Nome della partizione. |
| `balance` | `double` | Balance | [ ] | filtri sulla piattaforma, modificabili, `balance` | La parte superiore &gt; Saldo &gt; Campo di sola lettura che visualizza la somma dei saldi delle fatture aperte associate al contratto. |
| `contractId` | `varchar2` | ID del contratto | [ ] | filtri sulla piattaforma, modificabili, `contractId` | Campo obbligatorio: La parte superiore &gt; ID contratto* &gt; L'identificatore univoco di un contratto. |
| `contractTemplate_description` | `varchar2` | Descrizione del modello di contratto | [ ] | filtri sulla piattaforma, modificabili, `contractTemplate.description` | Fare clic sulla lente. &gt; La descrizione. |
| `contractTemplate_id` | `varchar2` | ID modello di contratto | [ ] | filtri sulla piattaforma, modificabili, `contractTemplate.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `customer_name` | `varchar2` | Nome del cliente | [ ] | filtri sulla piattaforma, modificabili, `customer.name` | Fare clic sulla lente. &gt; Il nome. |
| `customer_number` | `varchar2` | Numero del cliente | [ ] | filtri sulla piattaforma, modificabili, `customer.number` |  |
| `description` | `varchar2` | Description | [ ] | filtri sulla piattaforma, modificabili, `description` | Campo obbligatorio: La parte superiore &gt; Descrizione* &gt; La descrizione del contratto, che include eventuali commenti correlati. |
| `details_currentRecurring` | `double` | itgen_vnet_details_currentrecurring | [ ] | filtri sulla piattaforma, modificabili, `details.currentRecurring` |  |
| `details_currentRenewal` | `double` | itgen_vnet_details_currentrenewal | [ ] | filtri sulla piattaforma, modificabili, `details.currentRenewal` |  |
| `details_currentSetup` | `double` | itgen_vnet_details_currentsetup | [ ] | filtri sulla piattaforma, modificabili, `details.currentSetup` |  |
| `details_effectiveFrom` | `datetime` | itgen_vnet_details_effectivefrom | [ ] | filtri sulla piattaforma, modificabili, `details.effectiveFrom` |  |
| `details_pendingRecurring` | `double` | itgen_vnet_details_pendingrecurring | [ ] | filtri sulla piattaforma, modificabili, `details.pendingRecurring` |  |
| `details_pendingRenewal` | `double` | itgen_vnet_details_pendingrenewal | [ ] | filtri sulla piattaforma, modificabili, `details.pendingRenewal` |  |
| `details_pendingSetup` | `double` | itgen_vnet_details_pendingsetup | [ ] | filtri sulla piattaforma, modificabili, `details.pendingSetup` |  |
| `details_promoCode_description` | `varchar2` | itgen_vnet_details_promocode_description | [ ] | filtri sulla piattaforma, modificabili, `details.promoCode.description` | Fare clic sulla lente. &gt; La descrizione. |
| `details_promoCode_id` | `varchar2` | itgen_vnet_details_promocode_id | [ ] | filtri sulla piattaforma, modificabili, `details.promoCode.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `details_totalPending` | `double` | Totale in sospeso | [ ] | filtri sulla piattaforma, modificabili, `details.totalPending` |  |
| `lastModifiedDateTime` | `datetime` | Ultima modifica | [ ] | filtri sulla piattaforma, modificabili, `lastModifiedDateTime` | Informazioni generate dal sistema |
| `location_description` | `varchar2` | Descrizione della posizione | [ ] | filtri sulla piattaforma, modificabili, `location.description` | Fare clic sulla lente. &gt; La descrizione. |
| `location_id` | `varchar2` | ID della posizione | [ ] | filtri sulla piattaforma, modificabili, `location.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `status` | `varchar2` | Status | [ ] | filtri sulla piattaforma, modificabili, `status` | La parte superiore &gt; Stato &gt; Lo stato del contratto, che è uno dei seguenti: Bozza, In attesa di attivazione, Attivo, Scaduto, Annullato, In attesa di aggiornamento. |
| `summary_activationDate` | `datetime` | Data di attivazione | [ ] | filtri sulla piattaforma, modificabili, `summary.activationDate` | Sezione Impostazioni contratto &gt; Data di attivazione &gt; La data di avvio dell'erogazione dei servizi del contratto. |
| `summary_caseCountItem_description` | `varchar2` | itgen_vnet_summary_casecountitem_description | [ ] | filtri sulla piattaforma, modificabili, `summary.caseCountItem.description` | Nome articolo/descrizione |
| `summary_caseCountItem_number` | `varchar2` | itgen_vnet_summary_casecountitem_number | [ ] | filtri sulla piattaforma, modificabili, `summary.caseCountItem.number` | Numero articolo |
| `summary_currency` | `varchar2` | Currency | [ ] | filtri sulla piattaforma, modificabili, `summary.currency` | Campo obbligatorio: sezione Impostazioni contratto &gt; Valuta* &gt; La valuta utilizzata nel contratto. |
| `summary_expirationDate` | `datetime` | Data di scadenza | [ ] | filtri sulla piattaforma, modificabili, `summary.expirationDate` | Sezione Impostazioni contratto &gt; Data di scadenza &gt; La data in cui il contratto scade. |
| `summary_gracePeriod` | `int32` | Periodo di grazia | [ ] | filtri sulla piattaforma, modificabili, `summary.gracePeriod` | Sezione Impostazioni contratto &gt; Periodo di tolleranza &gt; Il numero di giorni dopo la data di scadenza entro cui il contratto può ancora essere rinnovato. |
| `summary_invoiceAccount_name` | `varchar2` | itgen_vnet_summary_invoiceaccount_name | [ ] | filtri sulla piattaforma, modificabili, `summary.invoiceAccount.name` | Fare clic sulla lente. &gt; Il nome. |
| `summary_invoiceAccount_number` | `varchar2` | itgen_vnet_summary_invoiceaccount_number | [ ] | filtri sulla piattaforma, modificabili, `summary.invoiceAccount.number` |  |
| `summary_invoiceLocation_description` | `varchar2` | itgen_vnet_summary_invoicelocation_description | [ ] | filtri sulla piattaforma, modificabili, `summary.invoiceLocation.description` | Fare clic sulla lente. &gt; La descrizione. |
| `summary_invoiceLocation_id` | `varchar2` | itgen_vnet_summary_invoicelocation_id | [ ] | filtri sulla piattaforma, modificabili, `summary.invoiceLocation.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `summary_invoiceTo` | `varchar2` | itgen_vnet_summary_invoiceto | [ ] | filtri sulla piattaforma, modificabili, `summary.invoiceTo` | Sezione Informazioni fattura &gt; Fattura a &gt; L'impostazione che definisce il conto cliente da fatturare per un contratto.Sono disponibili le seguenti opzioni: Conto padre, Conto cliente, Conto specifico. |
| `summary_invoicingPeriod` | `varchar2` | itgen_vnet_summary_invoicingperiod | [ ] | filtri sulla piattaforma, modificabili, `summary.invoicingPeriod` | Campo obbligatorio: sezione Pianificazione fatturazione &gt; Periodo di fatturazione* &gt; Il tipo di pianificazione di fatturazione, che può essere una delle seguenti opzioni: Settimanale, Mensile; Trimestrale, Semestrale, Annuale, Su richiesta, Basata su estratto conto. |
| `summary_invoicingScheduleStartsOn` | `datetime` | itgen_vnet_summary_invoicingschedulestartson | [ ] | filtri sulla piattaforma, modificabili, `summary.invoicingScheduleStartsOn` | Sezione Pianificazione fatturazione &gt; La pianificazione inizia il &gt; Campo di sola lettura che visualizza la data di inizio del primo periodo di fatturazione. |
| `summary_lastInvoicingDate` | `datetime` | itgen_vnet_summary_lastinvoicingdate | [ ] | filtri sulla piattaforma, modificabili, `summary.lastInvoicingDate` | Sezione Pianificazione fatturazione &gt; Ultima data di fatturazione &gt; Campo di sola lettura che mostra la data in cui è stata eseguita la fatturazione più recente. |
| `summary_massRenewal` | `char` | itgen_vnet_summary_massrenewal | [ ] | filtri sulla piattaforma, modificabili, `summary.massRenewal` | Sezione Impostazioni contratto &gt; Rinnovo di massa &gt; Una casella di controllo che indica il rinnovo di tutti i contratti alla data di scadenza. |
| `summary_nextInvoicingDate` | `datetime` | itgen_vnet_summary_nextinvoicingdate | [ ] | filtri sulla piattaforma, modificabili, `summary.nextInvoicingDate` | Sezione Pianificazione fatturazione &gt; Prossima data di fatturazione &gt; La data della prossima fattura, secondo la pianificazione di fatturazione. |
| `summary_owner_internalId` | `varchar2` | itgen_vnet_summary_owner_internalid | [ ] | filtri sulla piattaforma, modificabili, `summary.owner.internalId` |  |
| `summary_owner_name` | `varchar2` | itgen_vnet_summary_owner_name | [ ] | filtri sulla piattaforma, modificabili, `summary.owner.name` | Il nome della specifica destinazione del tipo selezionato. |
| `summary_owner_number` | `varchar2` | itgen_vnet_summary_owner_number | [ ] | filtri sulla piattaforma, modificabili, `summary.owner.number` | L'identificativo della specifica destinazione del tipo selezionato. |
| `summary_renewalPoint` | `int32` | itgen_vnet_summary_renewalpoint | [ ] | filtri sulla piattaforma, modificabili, `summary.renewalPoint` | Sezione Impostazioni contratto &gt; Punto di rinnovo &gt; Il numero di giorni prima della scadenza in cui devono iniziare le procedure di rinnovo. |
| `summary_salesPerson_description` | `varchar2` | itgen_vnet_summary_salesperson_description | [ ] | filtri sulla piattaforma, modificabili, `summary.salesPerson.description` | Fare clic sulla lente. &gt; La descrizione. |
| `summary_salesPerson_id` | `varchar2` | itgen_vnet_summary_salesperson_id | [ ] | filtri sulla piattaforma, modificabili, `summary.salesPerson.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `summary_setupDate` | `datetime` | itgen_vnet_summary_setupdate | [ ] | filtri sulla piattaforma, modificabili, `summary.setupDate` | Campo obbligatorio: sezione Impostazioni contratto &gt; Data di configurazione* &gt; La data di configurazione del contratto. |
| `summary_terminationDate` | `datetime` | itgen_vnet_summary_terminationdate | [ ] | filtri sulla piattaforma, modificabili, `summary.terminationDate` | Sezione Impostazioni contratto &gt; Data di risoluzione &gt; La data in cui il contratto sarà annullato; non verranno forniti servizi. |
| `timeStamp` | `blob` | Timestamp | [ ] | filtri sulla piattaforma, modificabili, `timeStamp` | Identificatore che rappresenta una versione specifica della risorsa.Aiuta a evitare che aggiornamenti simultanei della risorsa si sovrascrivano a vicenda (utilizzando ETag e intestazioni If-Match) |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `CustomerContracts_customer_number_fk` | `customer_number` | [Customers](VismaNet.Customer.Customers)`.number` | Key |  |


## Note di rilascio

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

- [Visma.net Financials](/it/release-notes/drivers?driver=visma-net-financials)
