# Contabilità DPass — prima versione, 1 novembre 2026

## Ambito
Registro gestionale dei movimenti già disponibili nel riepilogo DPass, ricerca ed esportazione CSV; criteri alla ricarica o al consumo; richieste di fattura e generazione interna di documenti numerati XML/PDF con partita IVA del gestore; copia di cortesia nell’area personale del cliente.

Il riepilogo preesistente resta disponibile. Nessun cambiamento a gateway, accrediti, consumi, rimborsi, importazione utenti o saldi finanziari. Le scritture del nuovo modulo riguardano esclusivamente le cinque tabelle dpass_accounting_rules, dpass_invoice_requests, dpass_accounting_audits, dpass_invoice_sequences e dpass_invoice_documents.

## Configurazione e classificazione
- Un emittente per Comune, dichiarato dall’amministratore. Non attivare una regola unica se più gestori fatturano operazioni diverse nel medesimo Comune.
- Nessun criterio predefinito. Gli eventi precedenti alla prima decorrenza sono da verificare.
- Una regola iniziale può decorrere da oggi; regole successive solo da una data futura, successiva a quelle esistenti. Nessuna cancellazione o modifica delle versioni precedenti.
- Borsellino e SostaPay devono adottare lo stesso criterio, perché il credito è trasferibile. Il cambio di metodo o di partita IVA richiede una migrazione contabile dei crediti, fuori da questa prima versione.
- I consumi sono classificati automaticamente solo dopo la conferma amministrativa del trattamento dei crediti iniziali. Nessuna deduzione automatica dello stato fiscale dall’importazione del vecchio database.
- Le ricariche online devono essere state effettivamente accreditate: un checkout pagato con accredito fallito rimane da verificare.
- Incasso diretto e servizio correlato non sono sommati. I movimenti con origine non sufficientemente documentata restano da verificare.
- I movimenti confermati del borsellino sono disponibili anche come dettaglio di registro, inclusi aggiustamenti e bonus. Sono chiaramente separati e non si sommano agli incassi o ai servizi.
- Trasferimenti borsellino-SostaPay e saldi iniziali importati sono visibili separatamente, senza nuovi incassi o corrispettivi.
- I rimborsi richiedono il collegamento al documento originario e non producono automaticamente una rettifica fiscale.
- I bonus non diventano nuovi incassi; consumi misti denaro/bonus nel criterio al consumo richiedono verifica.
- Le soste SostaPay eseguite fuori dall’app non sono acquisite da questo intervento. Il prospetto non sostituisce un rendiconto completo del sistema carte.
- La pagina Saldi mostra il saldo attuale locale del borsellino e l’ultima lettura disponibile delle carte, senza chiamare il fornitore. Non ricostruisce automaticamente il saldo storico al 31 dicembre e non produce storni annuali.

## Fatture: documenti generati da DPass
L’emittente fiscale è il gestore, non il fornitore della piattaforma DPass. Il cliente seleziona un evento ammesso dal criterio, conferma i dati di fatturazione e invia una richiesta; la possibilità e i termini di fatturazione sono verificati dall’amministratore.

Stati attivi: richiesta ricevuta → in lavorazione → documento generato / da inviare a SdI; richiesta ricevuta o in lavorazione → respinta. Le richieste concluse non sono modificabili da questo modulo. Non si assegna manualmente uno stato di emissione fiscale riuscita.

L’amministratore verifica aliquota e dati, indica il sezionale esclusivo DPass e genera il documento. La numerazione è progressiva per tenant, partita IVA del gestore, sezionale e anno, condivisa fra i Comuni dello stesso tenant con lo stesso emittente. Il sezionale deve essere nuovo e riservato a questa installazione: non riutilizzare una sequenza già usata in altri software o installazioni.

Richieste e documenti sono protetti contro la generazione duplicata. Contatore, documento e storico sono aggiornati nella stessa transazione; un errore non consuma il numero. Le operazioni vengono ricontrollate prima della generazione. Dati del cliente e del gestore sono acquisiti nel documento, conservati cifrati e non riscritti dalle modifiche successive all’anagrafica. XML cifrato e checksum immutabile.

Prima versione del generatore: TD01 ordinaria italiana, regime RF01, un solo emittente, una sola aliquota positiva scelta e confermata dall’operatore tra 4%, 5%, 10%, 22%, IVA immediata, importo già pagato. Il lordo deriva dall’operazione; imponibile e IVA vengono scorporati in centesimi senza modificare il totale. Non impostare un’aliquota predefinita per servizi fiscalmente diversi.

Non sono gestiti dal generatore: fatture PA, esenzioni/non imponibilità, split payment, ritenute, clienti esteri, note di credito, fatture cumulative o con più aliquote. Non adattare artificialmente tali operazioni al formato disponibile.

XML validato offline contro lo schema ufficiale VFPR12 1.2.3; questo controllo non sostituisce i controlli di merito SdI. PDF di cortesia disponibile all’amministratore e al solo cliente proprietario nell’area Fatture. È chiaramente indicato lo stato ancora da inviare. Nessun invio email automatico.

## Passaggi successivi
Invio e gestione degli esiti SdI, conservazione elettronica e trasferimento al gestionale del cliente richiedono un’integrazione dedicata. Non considerare fiscalmente emessa una fattura per il solo fatto che DPass ha generato PDF e XML. I prospetti correnti sono gestionali e non effettuano trasmissioni fiscali o chiusure annuali.

## Verifica
Test isolati in SQLite in memoria: policy, scope, ricerca, trasferimenti, importazioni, duplicati, contatore e rollback, cifratura, controllo XML, compilazione e rendering Blade, PDF reale e protezione del download utente. Il generatore del riepilogo esistente è sostituito nel test da un adattatore che fornisce eventi sintetici; componenti DB e servizi nuovi sono quelli reali.

Non è un collaudo completo HTTP/MySQL/Laravel 13 in PHP 8.3. Il runtime disponibile per le verifiche locali è PHP 8.2; l’applicazione richiede PHP 8.3 e il test carica direttamente i componenti compatibili, senza bootstrap, .env o database applicativo. Nessun invio SdI o documento reale è stato prodotto.
