---
title: "CustomerPaymentsByNumber (Visma.net Financials)"
description: "Customer Payments by Number"
language: it
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/it/datamodels/vismanet/VismaNet.CustomerPayment.CustomerPaymentsByNumber
original: https://documentation.invantive.eu/en/datamodels/vismanet/VismaNet.CustomerPayment.CustomerPaymentsByNumber
updated: 2026-11-19T00:27:39Z
license: https://documentation.invantive.eu/it/
---

# CustomerPaymentsByNumber: Visma.net Financials Pagamenti clienti per numero

`read only` `REST`

- Catalogo: `VismaNet`
- Schema: `CustomerPayment`
- Etichetta: Pagamenti clienti per numero

Ottieni dati specifici di un pagamento Le intestazioni della risposta includono un ETag dopo un'operazione GET riuscita.

È possibile solo recuperare i dati.

## Riepilogo

Dati per il pagamento <br></br> Le intestazioni della risposta includono un ETag dopo un'operazione GET riuscita.

## Codice sorgente dell'API

- Punto finale: `/v1/customerPayment/{paymentNumber}`
- Operazione: `get /v1/customerPayment/{paymentNumber}`

## 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 |
|---|---|:---:|---|---|
| `paymentNumber` | `` | [x] |  | Identifica il pagamento |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `CustomerPaymentsByNumber`. 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. |
| `applicationDate` | `datetime` | Data di applicazione della domanda | [ ] | filtri sulla piattaforma, modificabili, `applicationDate` | Campo obbligatorio: nella parte superiore &gt; Data* &gt; La data in cui un pagamento viene applicato a un documento (fattura o nota).Il campo visualizza la data commerciale corrente per i pagamenti non applicati o parzialmente applicati e la data dell'ultima applicazione per il pagamento chiuso |
| `applicationPeriod` | `varchar2` | Periodo di applicazione delle domande | [ ] | filtri sulla piattaforma, modificabili, `applicationPeriod` | Campo obbligatorio: nella parte superiore &gt; Periodo finanziario* &gt; Il periodo a cui deve essere applicato il pagamento, che il sistema compila in base alla data. |
| `appliedToDocuments` | `double` | itgen_vnet_appliedtodocuments | [ ] | filtri sulla piattaforma, modificabili, `appliedToDocuments` | Nella parte superiore &gt; Applicato ai documenti &gt; Il totale dei documenti a cui deve essere applicato il pagamento. |
| `appliedToOrders` | `double` | itgen_vnet_appliedtoorders | [ ] | filtri sulla piattaforma, modificabili, `appliedToOrders` | Nella parte superiore &gt; Applicato agli ordini &gt; Il totale degli ordini per i quali il pagamento è riservato, meno l'importo trasferito in fattura. |
| `availableBalance` | `double` | Saldo disponibile | [ ] | filtri sulla piattaforma, modificabili, `availableBalance` | Nella parte superiore &gt; Saldo disponibile &gt; L'importo non ancora applicato. |
| `availableBalanceInCurrency` | `double` | itgen_vnet_availablebalanceincurrency | [ ] | filtri sulla piattaforma, modificabili, `availableBalanceInCurrency` | Saldo disponibile calcolato nella valuta predefinita (base).Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |
| `branch` | `varchar2` | Branch | [ ] | filtri sulla piattaforma, modificabili, `branch` |  |
| `cashAccount` | `varchar2` | Conto di cassa | [ ] | filtri sulla piattaforma, modificabili, `cashAccount` | Campo obbligatorio: nella parte superiore &gt; Conto di cassa* &gt; Il conto di cassa predefinito associato al metodo di pagamento; questo campo non è disponibile per le note di credito. |
| `currency` | `varchar2` | Currency | [ ] | filtri sulla piattaforma, modificabili, `currency` | Nella parte superiore &gt; Valuta &gt; La valuta del documento di pagamento. |
| `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` |  |
| `deductedCharges` | `double` | Oneri dedotti | [ ] | filtri sulla piattaforma, modificabili, `deductedCharges` | Nella parte superiore &gt; Spese detratte &gt; Il totale delle spese bancarie detratte dalla banca dall'importo del pagamento sul conto di cassa (conto bancario). |
| `errorInfo` | `varchar2` | Messaggio di errore | [ ] | filtri sulla piattaforma, modificabili, `errorInfo` |  |
| `financeCharges` | `double` | Oneri finanziari | [ ] | filtri sulla piattaforma, modificabili, `financeCharges` | Nella parte superiore &gt; Interessi di mora &gt; Il totale di tutti gli interessi di mora applicati a questo documento. |
| `financialDetails_paymentDate` | `datetime` | itgen_vnet_financialdetails_paymentdate | [ ] | filtri sulla piattaforma, modificabili, `financialDetails.paymentDate` | Scheda Dettagli finanziari &gt; Data pagamento |
| `hold` | `char` | Hold | [ ] | filtri sulla piattaforma, modificabili, `hold` | Nella parte superiore &gt; Sospeso &gt; Casella di controllo che indica (se selezionata) che il documento è una bozza con stato Sospeso.Questa casella di controllo non è disponibile per le rettifiche di addebito. |
| `invoiceText` | `varchar2` | Testo della fattura | [ ] | filtri sulla piattaforma, modificabili, `invoiceText` | Nella parte superiore &gt; Testo fattura &gt; Una descrizione del pagamento definita dall'utente.50 caratteri alfanumerici. |
| `lastModifiedDateTime` | `datetime` | Ultima modifica | [ ] | filtri sulla piattaforma, modificabili, `lastModifiedDateTime` | Informazioni generate dal sistema. |
| `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` |  |
| `paymentAmount` | `double` | Importo del pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentAmount` | Nella parte superiore &gt; Importo pagamento &gt; Il totale del pagamento inserito manualmente. |
| `paymentAmountInCurrency` | `double` | itgen_vnet_paymentamountincurrency | [ ] | filtri sulla piattaforma, modificabili, `paymentAmountInCurrency` | Importo del pagamento calcolato nella valuta predefinita (base).Questo campo è applicabile se l'importo è indicato in una valuta diversa da quella predefinita. |
| `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. |
| `paymentRef` | `varchar2` | Riferimento di pagamento | [ ] | filtri sulla piattaforma, modificabili, `paymentRef` | Campo obbligatorio: nella parte superiore &gt; Rif. pagamento* &gt; Un identificativo secondario del riferimento di pagamento, che può essere un numero generato dal sistema o un numero di riferimento esterno inserito manualmente. |
| `refNbr` | `varchar2` | Numero di riferimento | [ ] | filtri sulla piattaforma, modificabili, `refNbr` | Nella parte superiore &gt; N. rif. &gt; L'identificativo univoco del pagamento.Questo numero è generato automaticamente dal sistema per un nuovo documento di pagamento, in base alla serie numerica	nella finestra AR101000. |
| `status` | `varchar2` | Status | [ ] | filtri sulla piattaforma, modificabili, `status` | Nella parte superiore &gt; Stato &gt; Lo stato del pagamento cliente, che per un nuovo documento è Bilanciato o Sospeso.[Sospeso, Bilanciato, Annullato, Pianificato, Aperto, Chiuso, In attesa di stampa, In attesa di email, Blocco credito, CcHold, Riservato] |
| `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) |
| `type` | `varchar2` | Type | [ ] | filtri sulla piattaforma, modificabili, `type` | Nella parte superiore &gt; Tipo &gt; Il tipo di documento.Sono disponibili i seguenti tipi: Pagamento, CreditNote, Anticipo, Rimborso cliente, Pagamento annullato, Storno saldo |
| `writeOffAmount` | `double` | Importo della svalutazione | [ ] | filtri sulla piattaforma, modificabili, `writeOffAmount` | Nella parte superiore &gt; Importo stornato &gt; L'importo che è stato stornato. |


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