---
title: Fatture e registro
description: Dove viene registrato il denaro in NexCMP: mastro del wallet, fatture, ricariche, rimborsi, liquidazioni, voucher e report sui ricavi.
url: https://nexcmp.com/it/docs/billing/invoices-and-ledger/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Fatture e registro {#invoices-and-ledger}

> **Dove trovarlo nell'admin:** Finance › Billing (`/billing`) con le schede Overview, Transactions (`/billing/ledger`), Invoices (`/billing/invoices`), Top-ups (`/billing/deposits`), Payouts (`/billing/payouts`), Vouchers (`/billing/vouchers`) e Reports (`/billing/reports`). **Dove trovarlo nel portale:** Billing (`/billing`).

## Descrizione {#what-it-does}

Ogni importo in NexCMP è memorizzato in centesimi di USD e registrato una sola volta. L'idea chiave: il **registro del portafoglio** è la fonte di verità per i saldi; fatture, pagamenti di ricarica e report sono viste create a partire da esso. Il registro è di **sola aggiunta** (append-only): un errore viene corretto aggiungendo una voce di storno, mai modificando la cronologia.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Ruolo | Un amministratore. |
| Dettagli del venditore | Imposta ragione sociale, partita IVA, indirizzo, e-mail di contatto e prefisso del numero di fattura in **System › Settings › General**, scheda **Seller & invoicing** (`/settings?tab=seller`), scheda **Seller details (printed on invoices)**. |
| Dipendenze | [Payment channels](https://nexcmp.com/it/docs/billing/payment-channels/) per i fondi in entrata. |

## I componenti {#the-pieces}

| Scheda admin | Cosa elenca | Uso tipico |
|---|---|---|
| **Overview** | Ricavi di oggi e del mese, totali del registro per tipo (deposit, charge, refund, adjustment, voucher), fatture per stato, rimborsi in sospeso, collegamenti rapidi, spesa per servizio negli ultimi 30 giorni | Controllo giornaliero |
| **Transactions** | Il registro del portafoglio, una riga per movimento | Spiegare il saldo di un cliente |
| **Invoices** | Fatture e una seconda vista **Orders** con ogni acquisto di ciascun servizio | Trovare un documento, reinviare, contrassegnare come pagato |
| **Top-ups** | Pagamenti ricevuti tramite i gateway | Controllare un pagamento, rimborsarlo |
| **Payouts** | Rimborsi su carta, pagamenti di affiliazione, prelievi dei rivenditori | Approvare il denaro in uscita |
| **Vouchers** | Codici di ricarica | Vedi [Promotions](https://nexcmp.com/it/docs/billing/promotions/) |
| **Reports** | Ricavi, per servizio, per rivenditore | Contabilità |

### Transactions (registro) {#transactions-ledger}

Colonne: ora, cliente, **kind**, servizio, importo (con segno), VM, riferimento, attore, nota. Filtri: kind, servizio, ID cliente, sito (quando si dispone di rivenditori), intervallo di date e un collegamento alla VM.

| Tipo | Significato |
|---|---|
| `deposit` | Ricarica da un gateway |
| `charge` | Denaro prelevato per un servizio (ordine, rinnovo, utilizzo orario ...) |
| `refund` | Denaro restituito al portafoglio |
| `adjust` | Credito o debito amministratore, e anche codici di ricarica (riferimento che inizia con `vch:`) — la panoramica mostra i voucher come una riga propria |

Ogni riga ha un riferimento come `dep:stripe:<payment-id>`; lo stesso riferimento non può mai essere scritto due volte, motivo per cui un webhook ripetuto non può accreditare due volte. Usa **Customers › List › customer › Credit / debit** per aggiungere una correzione manuale: un motivo è obbligatorio, un importo positivo tenta anche di sbloccare le VM bloccate per mancanza di fondi e l'azione viene confermata in due passaggi.

![Transactions tab che mostra le righe del registro del portafoglio con tipo, servizio, importo e riferimento](https://nexcmp.com/it/docs/images/billing/invoices-and-ledger-01-ledger.webp)

### Invoices {#invoices}

Viene creata automaticamente una fattura quando un cliente acquista o rinnova qualcosa pagato dal portafoglio, oppure per una ricarica. I numeri appaiono come `<prefix><YYYYMM>-<000001>` (ad esempio `NX202610-000042`); i siti dei rivenditori utilizzano un proprio prefisso e sequenza. I numeri esistenti non cambiano mai quando modifichi il prefisso.

| Campo | Valori |
|---|---|
| Tipo | Receipt, Renewal, Top-up, Manual, Refund |
| Stato | Unpaid, Paid, Overdue, Cancelled, Refunded |

Azioni su una riga:

| Action | Effetto |
|---|---|
| **View** / **Print** | Apre la fattura; il portale può anche stamparla o salvarla in PDF. |
| **Mark paid** (solo per non pagate o scadute) | La contrassegna come pagata **senza movimentare il denaro del portafoglio** — usala quando il cliente ti ha pagato al di fuori di NexCMP. È richiesto un motivo. Per una fattura di rinnovo estende e sblocca anche la VM bloccata. |
| **Cancel** (solo per non pagate o scadute) | Annulla la fattura. È richiesto un motivo. |
| **Resend** | Invia nuovamente la fattura via e-mail. |

**Create manual invoice** (pulsante in cima alla scheda): ID cliente, da 1 a 50 righe (descrizione, quantità, prezzo unitario), ID VM opzionale, giorni di scadenza opzionali (da 0 a 365, predefinito 7), nota opzionale. Viene creata come non pagata; il cliente la visualizza in **Billing › Invoice History**.

Le fatture dei servizi non pagate vengono **regolarizzate automaticamente dal credito** non appena sono disponibili fondi, per cui l'azione del cliente consiste semplicemente nell'effettuare una ricarica.


### Ricariche (pagamenti) {#top-ups-payments}

Una riga per tentativo: ora, cliente, **gateway e metodo**, tipo (ricarica o ricarica automatica), stato (in attesa, completato, fallito, rimborsato, contestato, annullato), importo pagato dal cliente, commissione, importo accreditato sul credito, riferimento del gateway e ora di completamento. I pagamenti completati con Stripe e PayPal dispongono di un'azione di **Refund**. Utilizza le pagine degli eventi del gateway per visualizzare i webhook ([Payment channels](https://nexcmp.com/it/docs/billing/payment-channels/)).

### Pagamenti {#payouts}

Tre sottoschede: **Card refunds** (approva o rifiuta le richieste di rimborso; la richiesta viene generata da un pagamento completato), **Affiliate payouts** (prelievi di commissioni) e **Reseller withdrawals**. Ogni decisione è registrata nei log di controllo.

### Report {#reports}

**Fatturato** (andamento a 30 giorni, mese per mese, clienti principali), **Per servizio** e **Per rivenditore**.

![Scheda dei report che mostra i KPI di fatturato e l'andamento a trenta giorni](https://nexcmp.com/it/docs/images/billing/invoices-and-ledger-03-reports.webp)

## Cosa vede il cliente {#what-the-customer-sees}

In **Billing** il cliente dispone di **Balance**, **Deposit**, **Redeem code**, **Settings** (ricarica automatica) e di una cronologia con le schede **Invoice History**, **Payment Order**, **Ledger** e **Orders** (ciascun servizio in un unico elenco con filtri per servizio e tipo). Ciascuna fattura offre le opzioni **View**, **Print** e **Save as PDF**; gli importi sono in USD e opzionalmente visualizzati nella valuta di visualizzazione.

## Verifica {#verify}

1. Effettua una piccola ricarica come cliente di prova.
2. **Transactions** mostra una riga `deposit`, **Top-ups** mostra il pagamento come *Completed* e il fatturato nella schermata **Overview** aumenta.
3. Effettua un acquisto: viene visualizzata una riga `charge` e **Invoices** mostra una fattura di tipo *Receipt* o *Renewal* con i dettagli del venditore configurati.

## Limiti e note {#limits-notes}

- **Sola aggiunta.** Non è possibile modificare o eliminare una riga del registro; è necessario aggiungere un rettificativo con una motivazione.
- **Valuta.** Gli importi sono in USD; la valuta di visualizzazione è puramente estetica (vedi [Currency and exchange rates](https://nexcmp.com/it/docs/catalog/currency-and-exchange-rates/)).
- **Refund to card** si articola in due passaggi (richiesta, quindi approvazione in Payouts); USDT e bonifici bancari non vengono rimborsati alla fonte.
- **Tutto viene registrato nei log** in System › Logs › Admin actions con la motivazione inserita.
- **Ordini rispetto alle fatture.** L'utilizzo orario non viene fatturato ora per ora; la visualizzazione Orders lo raggruppa per giorno per consentirne comunque la consultazione.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| Il saldo del cliente non sembra corretto | Un addebito, una rettifica o un voucher imprevisti | Filtra **Transactions** per ID cliente e leggi i riferimenti e le note. |
| "La fattura è già pagata" (409) | Impostazione dello stato di pagamento su una fattura già pagata | Nessuna azione necessaria. |
| Impossibile annullare una fattura | È possibile annullare solo le fatture non pagate o scadute | Per quelle pagate, utilizza un rimborso o una rettifica. |
| Dettagli del venditore mancanti sulle fatture | Non compilati | Completa la sezione **Seller details** in System › Settings › General › Seller & invoicing. |
| Carta di credito / debito rifiutata | L'importo è pari a zero o superiore a $100,000 | Usa un importo compreso tra 1 centesimo e $100,000. |
| Un pagamento rimane nello stato *Pending* a lungo | Webhook mancante | Consulta **Gateway events** ed effettua il replay. |