Ogni abbonamento ricorrente in Zenamu conserva un record interno completo di ogni evento importante: dal momento in cui viene creato, attraverso ogni rinnovo, pausa e annullamento, fino a eventuali rimborsi. Questo record è il Suo storico completo e la Sua rete di sicurezza per risolvere le controversie e gestire la contabilità. Questo articolo spiega dove trovare l'attività di un abbonamento e come leggere ogni tipo di evento.
Dove trovare l'attività di un abbonamento
Apra il dettaglio dell'abbonamento di un cliente nell'area admin e vedrà:
Lo stato attuale dell'abbonamento (attivo, in pausa, in attesa di pagamento, annullato e così via), la data del prossimo rinnovo e — se qualcosa è fallito — i dettagli sul periodo di grazia e sul pagamento fallito.
La sezione Ordini: un elenco dei documenti emessi per questo abbonamento (data di creazione, data di pagamento, stato del pagamento, importo, descrizione e un link al dettaglio del documento). È la Sua fonte principale di informazioni sui singoli pagamenti andati a buon fine, e funge anche da base per la Sua contabilità.
Nel proprio profilo (sotto I miei abbonamenti → dettaglio), il cliente vede lo stesso stato e lo stesso elenco dei propri ordini.
Importante: Zenamu non ha ancora una schermata dedicata "Storico rinnovi" che dettagli i singoli eventi come pause, cambi di variante o correzioni. Quegli eventi sono memorizzati in un record interno nel database e rispecchiati nel Suo Stripe Dashboard (sotto Subscriptions, Invoices ed Events). Nell'app ha tre punti con cui lavorare direttamente: lo stato attuale dell'abbonamento, l'elenco dei documenti (Ordini) e l'attività del cliente, dove i principali eventi sono descritti in linguaggio semplice (rinnovato, pagamento fallito, messo in pausa o messo in pausa automaticamente, ripreso, annullato dal cliente, annullato dal lato di Stripe o alla fine del periodo). Per la sequenza dettagliata di ogni singolo evento, guardi in Stripe. Più sotto descriviamo i tipi di eventi che il sistema registra, così avranno senso quando andrà a cercarli.
I tipi di eventi che il sistema registra
Ogni evento interno ha un tipo, una data e spesso alcuni dettagli aggiuntivi (un importo, un motivo, l'ID del record correlato in Stripe).
Abbonamento creato (primo acquisto)
Il primo acquisto andato a buon fine di un abbonamento compare come la creazione dell'abbonamento (stato attivo, o brevemente in attesa di pagamento) e come il primo documento nella sezione Ordini. Da esso può vedere la data, la variante scelta dal cliente e il primo importo addebitato.
Rinnovo riuscito
Il sistema registra ogni addebito ricorrente andato a buon fine. Un rinnovo include:
La data e l'ora del rinnovo.
L'importo addebitato.
Il periodo di fatturazione coperto dal pagamento (può rintracciarlo sulla fattura in Stripe).
Il documento emesso (una ricevuta o una fattura), che trova nella sezione Ordini.
Se il cliente usa un credito (che può provenire, per esempio, da un precedente rimborso emesso come credito anziché sulla carta) e questo copre l'intero pagamento del periodo, il rinnovo avviene comunque — Zenamu lo registra internamente e l'abbonamento prosegue — ma non viene creato alcun documento contabile. Nulla è stato addebitato sulla carta, quindi non c'è nulla da documentare. Non troverà un documento per quel periodo nella sezione Ordini né nell'export per il Suo commercialista. Il credito del cliente si riduce del prezzo del periodo.
Rinnovo fallito
Il sistema registra ogni tentativo di Stripe di prelevare un pagamento che non è andato a buon fine (i nuovi tentativi automatici di Stripe, un tentativo manuale e così via).
La data e l'ora del tentativo.
Il motivo del fallimento (il codice della banca — fondi insufficienti, rifiutata, carta scaduta, verifica richiesta e così via).
Un singolo rinnovo fallito può generare più record (Stripe effettua diversi tentativi durante il periodo di grazia). Il posto migliore per rintracciare questi tentativi e i loro codici è sulla fattura nel Suo Stripe Dashboard.
L'inizio del periodo di grazia è un evento interno separato; inoltre, la data di fine del periodo di grazia (di solito 7 giorni dopo il fallimento) compare direttamente nell'area admin, come parte dell'avviso di pagamento fallito sull'abbonamento.
Abbonamento messo in pausa
Viene registrato ogni volta che un abbonamento viene messo in pausa. Può vedere che un abbonamento è in pausa direttamente dal suo stato nell'area admin. Ci sono due casi:
Pausa automatica (perché il piano dello studio è passato a uno inferiore). Una nota esplicativa che descrive questo motivo viene salvata con il record.
Pausa manuale (dall'area admin). Viene salvata senza una nota — non viene indicato alcun motivo.
Anche l'attività del cliente distingue se l'abbonamento è stato messo in pausa (manualmente) oppure è stato messo in pausa automaticamente. Questa differenza è importante, perché determina se l'abbonamento si rinnova automaticamente quando più tardi torna al piano Ultimate (solo gli abbonamenti messi in pausa automaticamente lo fanno).
Abbonamento ripreso
Viene registrato quando un abbonamento in pausa viene riavviato. Il motivo distingue se è stato:
"Ripreso automaticamente: lo studio è tornato su Ultimate" — automaticamente, dopo che lo studio è tornato al piano Ultimate.
Una ripresa manuale dall'area admin o dal profilo del cliente.
Cambio di variante
Creato quando un cliente viene passato da una variante a un'altra. Nell'attività del cliente, l'app etichetta questo evento come Variante cambiata.
La data.
Variante vecchia → variante nuova.
Il tipo di cambio — un aumento di prezzo, una riduzione di prezzo programmata, un cambio di intervallo di fatturazione, oppure lo stesso prezzo (la variante è stata rinominata e così via).
A seconda dello scenario: per un aumento di prezzo, compare una fattura immediata per la differenza proporzionale per i giorni rimanenti (la data del prossimo rinnovo resta la stessa); per una riduzione di prezzo programmata, non viene creato alcun documento il giorno del cambio — l'area admin mostra un banner "Cambio programmato dal {{data}}" sull'abbonamento, e il cambio si applica solo al prossimo rinnovo; per un cambio di intervallo di fatturazione, il ciclo riparte e viene creata un'unica fattura netta (il nuovo prezzo meno un credito proporzionale per la parte non utilizzata del periodo precedente).
Può vedere chi ha effettuato il cambio dall'attività del cliente nell'area admin. Distingue se il cliente ha cambiato la variante dal proprio profilo o se lo ha fatto lo studio dall'area admin (per le azioni dello studio, viene salvato anche il nome del membro del personale).
Cambio di variante programmato annullato
Quando un cliente (o lo studio per suo conto) annulla un cambio di variante programmato in precedenza (sempre Scenario B — una riduzione di prezzo), il banner del cambio programmato scompare dall'area admin e il sistema fa una nota interna dell'annullamento. Non ci sono conseguenze finanziarie; l'abbonamento torna semplicemente alla variante originale senza lasciare traccia.
Situazioni rare attorno a un cambio di variante programmato
Occasionalmente un cliente programma una riduzione di prezzo, ma tra il momento in cui la programma e il giorno del rinnovo succede qualcosa di insolito — per esempio, nel frattempo lo studio archivia la variante di destinazione, oppure elimina il gruppo. Zenamu gestisce queste situazioni automaticamente e ne fa una nota interna.
Cosa può succedere e cosa fa Zenamu:
Cosa è successo | Cosa fa Zenamu |
Lo studio ha archiviato la variante di destinazione prima del rinnovo | Il cambio non viene applicato. Il prezzo torna alla variante originale e il cliente prosegue come se non avesse mai programmato la riduzione. |
Lo studio ha eliminato del tutto la variante di destinazione | Stesso comportamento dell'archiviazione. |
Lo studio ha archiviato o eliminato l'intero gruppo | Stesso comportamento; il cliente resta sulla variante originale. |
Il ripristino del prezzo non riesce tecnicamente (ad es. un breve disservizio di Stripe) | Zenamu fa una nota della situazione. Vedrà uno stato di avviso sull'abbonamento nell'area admin. In questo raro caso, può controllare il prezzo attuale dell'abbonamento del cliente nel Suo Stripe Dashboard e regolarlo manualmente se necessario. |
Queste situazioni sono molto rare (di solito meno dell'1% dei cambi programmati). Nella stragrande maggioranza dei casi, il cambio avviene esattamente come il cliente aveva inteso il giorno in cui l'ha programmato.
Prezzo aggiornato
Il sistema registra quando lo studio ha applicato una modifica di prezzo in blocco a questo cliente. Il record riporta:
La data.
Il vecchio e il nuovo prezzo.
Una nota che il nuovo prezzo si applica solo al prossimo rinnovo regolare.
Abbonamento annullato
Viene registrato a ogni annullamento — manuale (il cliente dal proprio profilo, lo studio dall'area admin, o tramite il portale clienti di Stripe) e automatico (da Zenamu dopo la scadenza del periodo di grazia di 7 giorni). Può vedere che un abbonamento è annullato direttamente dal suo stato nell'area admin (oppure da un banner "Annullamento alla fine del periodo" con una data). Inoltre, il record interno riporta:
La data dell'annullamento.
Il metodo di annullamento: alla fine del periodo corrente, oppure immediatamente.
Il motivo dell'annullamento (per esempio, un annullamento manuale alla fine del periodo, un annullamento immediato, o un annullamento automatico dopo la scadenza del periodo di grazia). Questa descrizione è solo indicativa: è memorizzata internamente in inglese e non è il testo esatto che vedrebbe nell'app.
Può vedere chi ha effettuato l'annullamento. Sia dal record interno sia dall'attività del cliente nell'area admin, può capire se a annullare l'abbonamento è stato il cliente, lo studio, o il sistema dopo la scadenza del periodo di grazia. Per le azioni effettuate dallo studio, viene salvato anche il nome del membro del personale. Ciò che il record non include è un link a eventuali rimborsi. Lo troverà nel Suo Stripe Dashboard sotto Refunds.
Conferma di pagamento richiesta e rimborsi — questi compaiono in modo diverso
La conferma di pagamento richiesta (3D Secure) su un rinnovo viene registrata come evento interno, ma lo stato dell'abbonamento resta attivo. Quando serve una verifica aggiuntiva su un rinnovo, Zenamu non lo passa a in attesa di pagamento (quello stato è riservato a un primo acquisto non completato; veda l'articolo "Gli stati dell'abbonamento"). L'esito compare poi o come rinnovo fallito (se il cliente non completa la verifica e Stripe smette di provare) o come rinnovo riuscito (se la completa in tempo).
I rimborsi non vengono registrati come attività dell'abbonamento a sé. Un rimborso totale porta all'annullamento automatico dell'abbonamento; un rimborso parziale non cambia lo stato dell'abbonamento. Troverà lo stato del rimborso stesso sul documento (la sezione Ordini) o nel Suo Stripe Dashboard.
Correzione da un controllo interno (eventi rari)
Questo tipo di record registra una situazione in cui un controllo interno in Zenamu ha rilevato una discrepanza tra il proprio stato e lo stato in Stripe e l'ha corretta oppure ne ha fatto una nota da gestire in seguito. I tipi specifici sono:
Ordine di acquisto in sospeso — il cliente ha acquistato, Stripe l'ha confermato, ma Zenamu non è riuscito a creare l'ordine interno. Il sistema contrassegna il record per recuperarlo più tardi.
Ordine di rinnovo in sospeso — lo stesso, per un rinnovo.
Rimborso in sospeso dopo una sovrapposizione — Zenamu ha annullato un abbonamento proprio nel momento in cui Stripe prelevava un pagamento in parallelo. Il rimborso automatico non è avvenuto subito, ma è annotato per essere gestito in seguito.
Cambio di variante in sospeso — un cambio di variante non si è concluso in modo pulito a un certo punto.
Messaggio per un abbonamento che non esiste più — Stripe ha inviato un messaggio relativo a un abbonamento che non esiste più in Zenamu (il cliente è stato eliminato).
Questi sono all'incirca i cinque più comuni; Zenamu usa diversi altri marcatori specifici per sovrapposizioni rare (quando due cose accadono nello stesso momento). Queste correzioni vengono eseguite in background; una singola correzione di solito non è un problema di per sé — il problema è lo stesso marcatore che si ripete sullo stesso abbonamento. Se sta affrontando una situazione del genere, contatti l'assistenza.
Queste correzioni sono informative e si manifestano nel senso che lo stato dell'abbonamento in Zenamu finisce per corrispondere a Stripe:
Una correzione isolata va bene. Piccole discrepanze tra Stripe e Zenamu capitano di tanto in tanto.
Una discrepanza ripetuta per lo stesso cliente o studio può indicare un problema più profondo. Nel Suo Stripe Dashboard, controlli se il Suo account è limitato (sotto Account requirements) e se tutti gli abbonamenti recenti di questo cliente corrispondono a ciò che vede in Zenamu. Se la discrepanza persiste, può risincronizzare manualmente in Stripe (annullare e creare un nuovo abbonamento).
Aggiornamenti di stato in tempo reale
Nell'area admin, lo stato dell'abbonamento e l'elenco degli ordini si aggiornano automaticamente, in tempo reale. Questo significa che:
Quando Stripe invia un messaggio a Zenamu (un pagamento riuscito, un fallimento, un annullamento), Zenamu cambia lo stato dell'abbonamento entro pochi secondi e aggiunge eventuali nuovi documenti.
Lo studio vede la modifica senza dover aggiornare la pagina.
Un cliente, nel proprio profilo, vede lo stato attuale solo dopo aver aggiornato la pagina. L'interfaccia del cliente in genere non usa gli aggiornamenti in tempo reale. Se un cliente contatta lo studio chiedendo perché non vede un nuovo pagamento, gli suggerisca di aggiornare la pagina. In alcune situazioni (subito dopo un pagamento), il browser del cliente controlla brevemente lo stato in background, ma come regola generale: aggiorni la pagina = stato attuale.
Nella maggior parte dei casi, entrambe le parti vedranno le modifiche entro pochi secondi o un minuto dall'evento effettivo dal lato di Stripe.
Come usare l'attività di un abbonamento nella pratica
La combinazione dello stato dell'abbonamento + l'elenco degli ordini in Zenamu e il Suo Stripe Dashboard è utile in diverse situazioni:
Spiegare un pagamento specifico a un cliente
Quando un cliente scrive "Perché mi sono stati addebitati 60 € il 14 aprile?", apra la sezione Ordini nel suo abbonamento e vedrà:
La data e lo stato del pagamento.
L'importo.
Un link al dettaglio del documento (la ricevuta). Può rintracciare il periodo di fatturazione coperto dal pagamento sulla fattura in Stripe.
Può poi rispondere al cliente con i dettagli esatti.
Capire perché un abbonamento è stato annullato
Può capire che un abbonamento è terminato automaticamente dopo pagamenti falliti dal suo stato attuale (annullato / non pagato) e dal pagamento andato a buon fine mancante negli Ordini. Per la cronologia dei singoli tentativi e la data di fine del periodo di grazia (di solito 7 giorni), guardi l'abbonamento e le fatture corrispondenti nel Suo Stripe Dashboard. Il cliente sa così di aver avuto un periodo di grazia di 7 giorni che non ha utilizzato.
Rimborsare un cliente per un periodo non utilizzato
Nell'elenco degli ordini può vedere la data dell'ultimo pagamento andato a buon fine; può vedere per quanto è valido l'abbonamento dallo stato dell'abbonamento (la data del prossimo rinnovo). Calcoli l'importo proporzionale per i giorni non utilizzati ed emetta il rimborso nel Suo Stripe Dashboard.
Rintracciare addebiti duplicati
Se un cliente sostiene che Stripe lo ha addebitato due volte, apra la sezione Ordini (e, per sicurezza, anche le fatture in Stripe). Vedrà o un solo pagamento (e il cliente si sbaglia) o due, nel qual caso può rimborsarne uno.
Documentazione per la contabilità
L'elenco degli ordini corrisponde uno a uno al Suo Stripe Dashboard. Se il Suo commercialista ha bisogno della prova di un pagamento specifico, apra il dettaglio del documento (e in Stripe troverà la fatturazione completa, la data di scadenza e i dettagli fiscali).
Domande frequenti
Un cliente mi dice di non vedere il proprio ultimo pagamento nel proprio profilo. Alcune possibilità:
Un credito ha coperto l'intero pagamento (nessun movimento di denaro = nessun documento, veda sopra).
Il profilo del cliente non si aggiorna in tempo reale — gli chieda di provare ad aggiornare la pagina.
Il messaggio da Stripe è stato ritardato; attenda un minuto e aggiorni la pagina.
Posso esportare l'attività di un abbonamento? Per la contabilità, usi l'export dei documenti standard nell'area admin (ISDOC o Pohoda XML). Contiene tutte le fatture e gli annullamenti di cui il Suo commercialista ha bisogno. Non troverà una sequenza dettagliata dei singoli eventi (rinnovi riusciti e falliti, pause, cambi di variante) come report a sé nell'app; quei dati risiedono nel database e nel Suo Stripe Dashboard. Nella maggior parte dei casi il Suo commercialista non ne ha bisogno — lavora con i documenti.
Posso eliminare un record di evento? No. I record contabili e storici non vengono eliminati né riscritti a posteriori; se ne aggiungono solo di nuovi accanto a essi. Il motivo: lo storico deve restare completo, sia ai fini contabili sia per la risoluzione delle controversie.
Cosa succede se vedo qualcosa che non mi aspetto in Stripe o nello stato dell'abbonamento (per esempio, il risultato di una correzione da un controllo interno)? Può essere una situazione in cui un controllo interno in Zenamu ha rilevato una discrepanza tra il proprio stato e lo stato in Stripe e l'ha corretta. Se è isolata, va bene (ogni tanto un messaggio da Stripe si perde, e la rete di sicurezza interna lo sistema). Se la discrepanza persiste per lo stesso cliente, controlli lo stato del suo abbonamento nel Suo Stripe Dashboard e lo confronti con ciò che vede in Zenamu. Se davvero non corrisponde, contatti l'assistenza, oppure risincronizzi manualmente in Stripe (annulli e crei un nuovo abbonamento).
Articoli correlati
Gestire gli abbonati esistenti — tutte le azioni che generano eventi interni e cambiano lo stato di un abbonamento
Quando un pagamento fallisce — i dettagli di cosa succede quando un pagamento fallisce e gli eventi correlati
Problemi comuni e come risolverli — come gestire le situazioni specifiche che questi dettagli aiutano a capire
