---
title: "CustomerCreditWriteOffs (Visma.net Financials)"
description: "Customer Credit Write-offs"
language: it
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/it/datamodels/vismanet/VismaNet.CustomerCreditWriteOff.CustomerCreditWriteOffs
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.CustomerCreditWriteOff.CustomerCreditWriteOffs
updated: 2026-11-19T00:27:10Z
license: https://documentation.invantive.eu/it/
---

# CustomerCreditWriteOffs: Visma.net Financials Storni nota di credito cliente

`popular` `read only` `REST`

- Catalogo: `VismaNet`
- Schema: `CustomerCreditWriteOff`
- Etichetta: Storni nota di credito cliente

Recupera un intervallo di WriteOffs nota di credito cliente - ScreenId=AR301000 La dimensione di pagina richiesta deve essere minore o uguale alla dimensione massima di pagina consentita, restituita come parte delle informazioni sui metadati. Se la dimensione di pagina richiesta è maggiore della dimensione massima consentita, la richiesta sarà limitata alla dimensione massima di pagina. Dati per WriteOff nota di credito cliente

È possibile solo recuperare i dati.

## Riepilogo

Dati per WriteOff nota di credito cliente

## Codice sorgente dell'API

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

## 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 |
|---|---|:---:|---|---|
| `branch` | `` | [ ] |  | Filtra per filiale |
| `closedFinancialPeriod` | `` | [ ] |  | La data di chiusura del periodo contabile. |
| `createdDateTime` | `` | [ ] |  | Questo valore, generato dal sistema, indica la data e l'ora di creazione.Usarlo per recuperare tutti i record creati da quel momento fino ad oggi.Formato accettato: * ```yyyy-MM-dd```` * ````yyyy-MM-dd HH:mm:ss```` * ````yyyy-MM-dd HH:mm:ss.FFF```` * ````yyyy-MM-ddTHH:mm:ss```` * ````yyyy-MM-ddTHH:mm:ss.FFF``` _Nota:_ __CreatedDateTime__ e __CreatedDateTimeCondition__ sono __mutuamente inclusivi__. |
| `createdDateTimeCondition` | `` | [ ] |  | Questo valore rappresenta la condizione da applicare durante il recupero dei record.Valori accettati (senza apici singoli): * '&gt;' per maggiore di * '&lt;' per minore di * '&gt;=' per maggiore o uguale a * '&lt;=' per minore o uguale a  _Nota:_ __CreatedDateTime__ e __CreatedDateTimeCondition__ sono __mutuamente inclusivi__. |
| `customer` | `` | [ ] |  | Filtra per cliente |
| `customerRefNumber` | `` | [ ] |  | La parte superiore &gt; Riferimento esterno &gt; Il riferimento esterno utilizzato in AutoInvoice. |
| `documentDate` | `` | [ ] |  | Questo valore indica la data del documento.Usarlo per recuperare tutti i record con data documento da quel momento in poi, fino al futuro.Formato accettato: * ```yyyy-MM-dd``` * ```yyyy-MM-dd``` * ```yyyy-MM-dd``` * ```yyyy-MM-dd``` * ```yyyy-MM-dd``` _Nota:_ __DocumentDate__ e __DocumentDateCondition__ sono __reciprocamente inclusivi__. |
| `documentDateCondition` | `` | [ ] |  | Questo valore rappresenta la condizione da applicare alla data del documento durante il recupero dei record.Valori accettati (senza apici singoli): * '&gt;' per maggiore di * '&lt;' per minore di * '&gt;=' per maggiore o uguale * '&lt;=' per minore o uguale _Nota:_ __DocumentDate__ e __DocumentDateCondition__ sono __mutuamente inclusivi__. |
| `documentDueDate` | `` | [ ] |  | La data in cui il pagamento del documento è dovuto, in base alle condizioni di credito. |
| `documentDueDateCondition` | `` | [ ] |  | Questo valore rappresenta la condizione da applicare alla data di scadenza durante il recupero dei record.Valori accettati (senza apici singoli): * '&gt;' per maggiore di * '&lt;' per minore di * '&gt;=' per maggiore o uguale * '&lt;=' per minore o uguale |
| `documentType` | `` | [ ] |  | Il campo è obsoleto per gli endpoint specifici dei documenti cliente.Sarà utilizzabile solo dall'endpoint dei documenti cliente.(Valori: Fattura, DebitNote, CreditNote, Pagamento, VoidPayment, Anticipo, Rimborso, FinCharge, SmallBalanceWo, SmallCreditWo, CashSale, CashReturn, Non definito, NoUpdate) |
| `dunningLetterDateTime` | `` | [ ] |  | Data e ora in cui il documento ha inviato per l'ultima volta una lettera di sollecito. |
| `dunningLetterDateTimeCondition` | `` | [ ] |  | Imposta data/ora come prima (&lt;), dopo (&gt;), prima e inclusa (=&lt;) OPPURE dopo e inclusa (=&gt;) per filtrare sul periodo temporale. |
| `dunningLevel` | `` | [ ] |  | Il livello di sollecito del documento. |
| `expandApplications` | `` | [ ] |  | Vero se si desidera vedere tutte le informazioni sui solleciti relative a questo documento. |
| `expandAttachments` | `` | [ ] |  | Vero se si desidera vedere tutti gli allegati relativi a questo documento. |
| `expandDunningInformation` | `` | [ ] |  |  |
| `expandInvoiceAddress` | `` | [ ] |  | Vero se si desidera vedere tutte le informazioni relative all'indirizzo di fatturazione per questo documento. |
| `expandTaxDetails` | `` | [ ] |  | Vero se si desidera visualizzare tutti i dettagli IVA relativi a questo documento. |
| `externalReference` | `` | [ ] |  | La parte superiore &gt; Riferimento esterno &gt; Il riferimento esterno utilizzato in AutoInvoice. |
| `financialPeriod` | `` | [ ] |  | Il periodo finanziario a cui vengono registrate le transazioni contenute nel documento.Formato AAAAMM. |
| `greaterThanValue` | `` | [ ] |  | Valore maggiore di.L'elemento che costituisce l'oggetto di questa operazione varia da API a API. |
| `lastModifiedDateTime` | `` | [ ] |  | Questo valore, generato dal sistema, indica l'ultima volta in cui il record è stato modificato.Usalo per recuperare tutti i record modificati da quel momento fino ad ora.Formato accettato: * ```yyyy-MM-dd``` * ```yyyy-MM-dd HH:mm:ss``` * ```yyyy-MM-dd HH:mm:ss.FFF``` * ```yyyy-MM-ddTHH:mm:ss``` * ```yyyy-MM-ddTHH:mm:ss.FFF``` _Nota:_ __LastModifiedDateTime__ e __LastModifiedDateTimeCondition__ sono __mutuamente inclusivi__. |
| `lastModifiedDateTimeCondition` | `` | [ ] |  | Questo valore rappresenta la condizione da applicare durante il recupero dei record.Valori accettati (senza apici singoli): * '&gt;' per maggiore di * '&lt;' per minore di * '&gt;=' per maggiore o uguale a * '&lt;=' per minore o uguale a _Nota:_ __LastModifiedDateTime__ e __LastModifiedDateTimeCondition__ sono __mutuamente inclusivi__. |
| `paymentReference` | `` | [ ] |  | La parte superiore &gt; Rif. pagamento &gt; Il numero di riferimento del documento, generato automaticamente dal sistema in base alla serie numerica assegnata alle vendite in contanti nella finestra Preferenze registro clienti.. |
| `project` | `` | [ ] |  | Il progetto a cui è associato il documento. |
| `released` | `` | [ ] |  | Parametro che indica se la fattura è stata rilasciata o meno. |
| `status` | `` | [ ] |  | Lo stato del documento.Usare il menu a discesa per selezionare lo stato.(Valori: Sospeso, Bilanciato, Annullato, Pianificato, Aperto, Chiuso, PendingPrint, PendingEmail, CreditHold, CcHold, Riservato) |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `CustomerCreditWriteOffs`. 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. |
| `account_active` | `char` | Account attivo | [ ] | filtri sulla piattaforma, modificabili, `account.active` |  |
| `account_description` | `varchar2` | Descrizione del conto | [ ] | filtri sulla piattaforma, modificabili, `account.description` | Nome articolo/descrizione |
| `account_externalCode1` | `varchar2` | Codice esterno del conto 1 | [ ] | filtri sulla piattaforma, modificabili, `account.externalCode1` | Classe di conto &gt; L'identificatore della classe di conto. |
| `account_externalCode2` | `varchar2` | Codice esterno del conto 2 | [ ] | filtri sulla piattaforma, modificabili, `account.externalCode2` | Classe di conto &gt; Il nome della classe di conto. |
| `account_number` | `varchar2` | Numero di conto | [ ] | filtri sulla piattaforma, modificabili, `account.number` | Numero articolo |
| `account_type` | `varchar2` | Tipo di account | [ ] | filtri sulla piattaforma, modificabili, `account.type` | Conto &gt; Il numero di conto. |
| `amount` | `double` | Amount | [ ] | filtri sulla piattaforma, modificabili, `amount` | La parte superiore &gt; Importo &gt; L'importo pagato con il documento.Il valore appare per i nuovi documenti se la casella di controllo Convalida i totali del documento all'inserimento è selezionata nella finestra AR101000.Se la casella di controllo è deselezionata, il valore appare quando lo stato del documento è Aperto. |
| `amountInCurrency` | `double` | Importo in Valuta | [ ] | filtri sulla piattaforma, modificabili, `amountInCurrency` | Calcolo in background che fornisce l'importo nella valuta predefinita.Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |
| `balance` | `double` | Balance | [ ] | filtri sulla piattaforma, modificabili, `balance` | La parte superiore &gt; Saldo &gt; Per un documento aperto del registro clienti, il saldo dopo l'eventuale sconto cassa applicato.Per un documento usato nel processo di applicazione, questo è il saldo dopo l'applicazione dei pagamenti. |
| `balanceInCurrency` | `double` | Saldo in Valuta | [ ] | filtri sulla piattaforma, modificabili, `balanceInCurrency` | Calcolo in background che fornisce il saldo nella valuta predefinita.Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |
| `branchNumber_name` | `varchar2` | Nome della filiale | [ ] | filtri sulla piattaforma, modificabili, `branchNumber.name` | Fare clic sulla lente. &gt; Il nome. |
| `branchNumber_number` | `varchar2` | Numero di filiale | [ ] | filtri sulla piattaforma, modificabili, `branchNumber.number` | Fare clic sulla lente. &gt; L'identificatore. |
| `cashAccount` | `varchar2` | Conto di cassa | [ ] | filtri sulla piattaforma, modificabili, `cashAccount` | Scheda Dati finanziari &gt; Sezione informazioni di pagamento &gt; Conto di cassa &gt; Il conto di cassa associato al metodo di pagamento. |
| `cashDiscount` | `double` | Sconto per pagamento in contanti | [ ] | filtri sulla piattaforma, modificabili, `cashDiscount` | La parte superiore &gt; Sconto cassa &gt; L'importo dello sconto cassa che è stato o sarà applicato al documento, calcolato dal sistema in base alle condizioni di credito specificate. |
| `cashDiscountInCurrency` | `double` | Sconto in contanti in Valuta | [ ] | filtri sulla piattaforma, modificabili, `cashDiscountInCurrency` | Calcolo in background che fornisce lo sconto cassa nella valuta predefinita.Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |
| `closedFinancialPeriod` | `varchar2` | Periodo contabile chiuso | [ ] | filtri sulla piattaforma, modificabili, `closedFinancialPeriod` | Formato AAAAMM. |
| `createdDateTime` | `datetime` | Created | [ ] | filtri sulla piattaforma, modificabili, `createdDateTime` | La scheda Allegati &gt; Ora di creazione &gt; La data in cui l'allegato è stato creato. |
| `currencyId` | `varchar2` | ID della valuta | [ ] | filtri sulla piattaforma, modificabili, `currencyId` | La parte superiore &gt; Valuta &gt; La valuta del documento.Per impostazione predefinita è la valuta predefinita del cliente, ma può essere modificata se la casella di controllo Consenti sovrascrittura valuta è selezionata nella finestra AR303000. |
| `customerProject` | `varchar2` | Progetto del cliente | [ ] | filtri sulla piattaforma, modificabili, `customerProject` | La parte superiore &gt; N. progetto cliente &gt; Il numero di progetto cliente utilizzato in AutoInvoice. |
| `customerRefNumber` | `varchar2` | Numero di riferimento personalizzato | [ ] | filtri sulla piattaforma, modificabili, `customerRefNumber` | La parte superiore &gt; Riferimento esterno &gt; Il riferimento esterno utilizzato in AutoInvoice. |
| `customerVatZone_description` | `varchar2` | Descrizione della zona IVA | [ ] | filtri sulla piattaforma, modificabili, `customerVatZone.description` | Fare clic sulla lente. &gt; La descrizione. |
| `customerVatZone_id` | `varchar2` | ID zona IVA | [ ] | filtri sulla piattaforma, modificabili, `customerVatZone.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` |  |
| `documentDate` | `datetime` | Data del documento | [ ] | filtri sulla piattaforma, modificabili, `documentDate` | La parte superiore &gt; Data* &gt; La data in cui è stato creato il documento del registro clienti.Per impostazione predefinita, per un nuovo documento è la data operativa corrente, ma è possibile modificarla. |
| `documentType` | `varchar2` | Tipo di documento | [ ] | filtri sulla piattaforma, modificabili, `documentType` | La parte superiore &gt; Tipo &gt; Il tipo di documento.Sono disponibili i seguenti tipi: fattura, nota di debito, nota di credito, addebito per scaduto, storno per inesigibilità |
| `errorInfo` | `varchar2` | Messaggio di errore | [ ] | filtri sulla piattaforma, modificabili, `errorInfo` |  |
| `financialPeriod` | `varchar2` | Periodo finanziario | [ ] | filtri sulla piattaforma, modificabili, `financialPeriod` | Il periodo finanziario a cui devono essere registrate le transazioni contenute nel documento.Formato AAAAMM. |
| `hold` | `char` | Hold | [ ] | filtri sulla piattaforma, modificabili, `hold` | La parte superiore &gt; Blocca &gt; Casella di controllo che indica se il documento è una bozza.Un documento con stato Sospeso può essere modificato e non può essere rilasciato. |
| `invoiceText` | `varchar2` | Testo della fattura | [ ] | filtri sulla piattaforma, modificabili, `invoiceText` | La parte superiore &gt; Testo fattura &gt; Qualsiasi descrizione fornita dall'utente del documento contabile cliente. |
| `lastModifiedDateTime` | `datetime` | Ultima modifica | [ ] | filtri sulla piattaforma, modificabili, `lastModifiedDateTime` | Campo generato dal sistema per la data/ora dell'ultima modifica del documento. |
| `location_countryId` | `varchar2` | Località - Codice paese | [ ] | filtri sulla piattaforma, modificabili, `location.countryId` | Location*. |
| `location_id` | `varchar2` | ID della posizione | [ ] | filtri sulla piattaforma, modificabili, `location.id` | Fare clic sulla lente &gt; L'identificativo |
| `location_name` | `varchar2` | Nome della località | [ ] | filtri sulla piattaforma, modificabili, `location.name` | Fare clic sulla lente &gt; Il nome visualizzato |
| `metadata_maxPageSize` | `int64` | Dimensione massima delle pagine dei metadati | [ ] | filtri sulla piattaforma, modificabili, `metadata.maxPageSize` |  |
| `metadata_totalCount` | `int64` | Conteggio totale | [ ] | filtri sulla piattaforma, modificabili, `metadata.totalCount` |  |
| `note` | `varchar2` | Note | [ ] | filtri sulla piattaforma, modificabili, `note` | Icona Note in cima alla finestra &gt; Finestra popup per inserire qualsiasi testo definito dall'utente collegato al documento. |
| `origInvoiceDate` | `datetime` | Data della fattura originale | [ ] | filtri sulla piattaforma, modificabili, `origInvoiceDate` | La parte superiore &gt; Data fattura originale &gt; La data in base alla quale viene calcolata la data di scadenza e la data dello sconto cassa.Utilizzato solo se l'impostazione "Usa data fattura originale" è attiva nelle Preferenze AR.Per impostazione predefinita, per un nuovo documento è la data operativa corrente, ma è possibile modificarla. |
| `paymentMethod_description` | `varchar2` | Descrizione del metodo di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentMethod.description` | Fare clic sulla lente. &gt; La descrizione. |
| `paymentMethod_id` | `varchar2` | ID del metodo di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentMethod.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `postPeriod` | `varchar2` | Periodo di pubblicazione | [ ] | filtri sulla piattaforma, modificabili, `postPeriod` | La parte superiore &gt; Periodo di registrazione &gt; Il periodo a cui il documento deve essere registrato.Formato AAAAMM. |
| `project_description` | `varchar2` | Descrizione del progetto | [ ] | filtri sulla piattaforma, modificabili, `project.description` | Fare clic sulla lente. &gt; La descrizione. |
| `project_id` | `varchar2` | Identificatore del progetto | [ ] | filtri sulla piattaforma, modificabili, `project.id` | Fare clic sulla lente. &gt; L'identificativo. |
| `project_internalId` | `int32` | itgen_vnet_project_internalid | [ ] | filtri sulla piattaforma, modificabili, `project.internalId` | L'identificativo interno. |
| `referenceNumber` | `varchar2` | Numero di riferimento | [ ] | filtri sulla piattaforma, modificabili, `referenceNumber` | La parte superiore &gt; N. rif. &gt; Il numero di riferimento del documento contabile cliente nel sistema. |
| `roundingDiff` | `double` | Differenza di arrotondamento | [ ] | filtri sulla piattaforma, modificabili, `roundingDiff` | La parte superiore &gt; Diff. arrotondamento &gt; La differenza tra l'importo originale e l'importo arrotondato. |
| `status` | `varchar2` | Status | [ ] | filtri sulla piattaforma, modificabili, `status` | La parte superiore &gt; Stato &gt; Lo stato del documento, che può essere uno dei seguenti: Sospeso, Bilanciato, Annullato, Pianificato, Aperto, Chiuso, In attesa di stampa, In attesa di email. |
| `subaccount_active` | `char` | Sottoconto attivo 2 | [ ] | filtri sulla piattaforma, modificabili, `subaccount.active` | Attivo &gt; Lo stato dell'identificatore. |
| `subaccount_description` | `varchar2` | Descrizione del sottoconto | [ ] | filtri sulla piattaforma, modificabili, `subaccount.description` | Descrizione &gt; La descrizione dell'identificatore. |
| `subaccount_errorInfo` | `varchar2` | Messaggio di errore relativo al conto secondario | [ ] | filtri sulla piattaforma, modificabili, `subaccount.errorInfo` |  |
| `subaccount_lastModifiedDateTime` | `datetime` | Ultima modifica del sottoconto | [ ] | filtri sulla piattaforma, modificabili, `subaccount.lastModifiedDateTime` | Informazioni generate dal sistema. |
| `subaccount_metadata_maxPageSize` | `int64` | Dimensione massima della pagina dei metadati del sottoconto | [ ] | filtri sulla piattaforma, modificabili, `subaccount.metadata.maxPageSize` |  |
| `subaccount_metadata_totalCount` | `int64` | Numero totale di metadati dei sottoconti | [ ] | filtri sulla piattaforma, modificabili, `subaccount.metadata.totalCount` |  |
| `subaccount_subaccountId` | `int32` | ID conto secondario | [ ] | filtri sulla piattaforma, modificabili, `subaccount.subaccountId` | SubID &gt; L'identificatore del sottoconto. |
| `subaccount_subaccountNumber` | `varchar2` | Numero del conto secondario | [ ] | filtri sulla piattaforma, modificabili, `subaccount.subaccountNumber` | Campo obbligatorio: Sottoconto* &gt; Il numero del sottoconto.Formato 9-XX. |
| `subaccount_timeStamp` | `blob` | itgen_vnet_subaccount_timestamp | [ ] | filtri sulla piattaforma, modificabili, `subaccount.timeStamp` | Il timestamp del subaccount, utilizzato per il controllo della concorrenza. |
| `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) |
| `vatTotal` | `double` | Totale IVA | [ ] | filtri sulla piattaforma, modificabili, `vatTotal` | La parte superiore &gt; Totale IVA &gt; L'importo IVA del documento, come definito nella scheda Dettagli IVA. |
| `vatTotalInCurrency` | `double` | Totale IVA in Valuta | [ ] | filtri sulla piattaforma, modificabili, `vatTotalInCurrency` | Calcolo in background che fornisce il totale IVA nella valuta predefinita.Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |

## Chiavi

| Key | Column | Si riferisce a | Kind | Description |
|---|---|---|---|---|
| `CustomerCreditWriteOffs_account_number_fk` | `account_number` | [Accounts](VismaNet.Account.Accounts)`.accountCD` | Key |  |
| `CustomerCreditWriteOffs_branchNumber_number_fk` | `branchNumber_number` | [Branches](VismaNet.Branch.Branches)`.number` | Key |  |
| `CustomerCreditWriteOffs_currencyId_fk` | `currencyId` | [Currencies](VismaNet.Currency.Currencies)`.id` | Key |  |
| `CustomerCreditWriteOffs_customerVatZone_id_fk` | `customerVatZone_id` | [VatZones](VismaNet.VatZone.VatZones)`.id` | Key |  |
| `CustomerCreditWriteOffs_customer_number_fk` | `customer_number` | [Customers](VismaNet.Customer.Customers)`.number` | Key |  |
| `CustomerCreditWriteOffs_location_countryId_fk` | `location_countryId` | [Countries](VismaNet.Country.Countries)`.id` | Key |  |
| `CustomerCreditWriteOffs_paymentMethod_id_fk` | `paymentMethod_id` | [PaymentMethods](VismaNet.PaymentMethod.PaymentMethods)`.paymentMethodID` | Key |  |
| `CustomerCreditWriteOffs_project_id_txt` | `project_id` | [Projects](VismaNet.Project.Projects)`.projectID` | Textual | Il progetto, oppure il codice per nessun progetto quando il documento non è associato a un progetto; tale codice non ha una riga in Progetti. |


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