Fatture e registro
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
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
| 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 per i fondi in entrata. |
I componenti
| 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 |
| Reports | Ricavi, per servizio, per rivenditore | Contabilità |
Transactions (registro)
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.
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)
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).
Pagamenti
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
Fatturato (andamento a 30 giorni, mese per mese, clienti principali), Per servizio e Per rivenditore.
Cosa vede il cliente
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
- Effettua una piccola ricarica come cliente di prova.
- Transactions mostra una riga
deposit, Top-ups mostra il pagamento come Completed e il fatturato nella schermata Overview aumenta. - Effettua un acquisto: viene visualizzata una riga
chargee Invoices mostra una fattura di tipo Receipt o Renewal con i dettagli del venditore configurati.
Limiti e note
- 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).
- 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
| 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. |