BPM Billing – Fatturazione e Incasso

Estimated reading: 21 minutes 32 views

Orchestrazione della fatturazione per contratto: dal check di fatturabilità all’esito del pagamento o al sollecito

METADATOVALORE
OggettoAnalisi funzionale del processo Billing in XU360 BPM
Riunione di riferimento15 ottobre 2026 – BPM Processo Billing (1 h 30 m)
FontiTrascrizione Word, registrazione MP4 e schermate del diagramma Miro allegate
PerimetroSingolo contratto e ciclo di fatturazione; gestione batch massivi e ritorni pagamento
StatoProposta analizzata in riunione; decisioni architetturali e POC ancora aperti
Revisionev1.0 – 16 ottobre 2026

Percorso di lettura

SEZIONICONTENUTO
1–3Obiettivo, modelli architetturali e diagrammi
4–8Descrizione puntuale dei nodi delle cinque fasi
9–12Stati, batch, buffer, dati e gestione errori
13–15Requisiti, open point e riferimenti documentali

Legenda dello stato di definizione

IndicazioneInterpretazione
Emerso in riunioneIl concetto è esplicitamente descritto dai partecipanti o mostrato nel Miro.
Ipotesi tecnicaSoluzione proposta nel confronto, da disegnare o validare tecnicamente.
Da confermareRegola, nome campo, API, quantità o stato non stabiliti in modo univoco.
Elaborazione funzionaleDecisione/controllo esplicitato nel presente documento per rendere leggibile il processo; non significa componente già implementato.

1. Obiettivo, perimetro e criteri di lettura

L’obiettivo è descrivere il processo di fatturazione modellato su XU360 BPM/Orchestrator, con l’intervento di batch tecnici che identificano i contratti da fatturare, producono gli oggetti Invoice e i relativi documenti, inviano la comunicazione al cliente e si raccordano con gli eventi di pagamento e sollecito.

Il disegno discusso è riferito al singolo contratto durante l’elaborazione di fatturazione rappresentata. Un cliente con un contratto Luce e uno Gas può quindi produrre pratiche di fatturazione distinte. La gestione di contratto dual fuel unificato non è inclusa nel perimetro attuale e resta un’estensione da valutare.

Il documento NON attesta che tutto il flusso sia già sviluppato. In particolare, si sono discussi un POC di massività, l’implementazione di buffer e l’integrazione di contesto Invoice nella Process Instance. Gli elementi tecnici vengono rappresentati come proposta, non come decisione di rilascio.

2. Modelli architetturali

ALTERNATIVATRACCIAMENTOVANTAGGIORISCHIO
A · Istanze multipleUna PI per contratto coinvolto nel ciclo rappresentato; percorso fino a pagamento/sollecito.Audit dettagliato per singolo contratto e avanzamento puntuale.Moltissime PI, batch multipli, buffer e scalabilità da dimostrare.
B · Istanza unica per periodo/lottoUna PI del macro-ciclo: segue i batch aggregati; si arresta intorno all’invio del documento.Meno PI; governance del ciclo complessivo.Non traccia con BPM il pagamento del singolo cliente.
C · Procedurale senza BPMBatch schedulati/incatenati e controlli operativi esterni.Implementazione potenzialmente più semplice.Riduce audit e tracciamento end-to-end; rischio di coordinamento manuale.
La riunione NON chiude con un’approvazione definitiva della soluzione A. La soluzione con PI per contratto è quella analizzata più in dettaglio nel diagramma e nelle fasi seguenti; è subordinata alla prova tecnica di massività.

Fonte: trascrizione 13:28–18:59 e screenshot “Punti di riflessione: Istanze multiple / Procedurale”.

3. Diagrammi del flusso funzionale

3.1 Fasi 1 e 2 – contratti fatturabili, creazione PI e Invoice

Figura 1 — Ricostruzione con identificativi N01–N07. Il nodo di decisione “Dati idonei?” è un’esplicitazione funzionale del pre-check descritto in riunione.

3.2 Fasi 3, 4 e 5 – PDF, invio, pagamento

Figura 2 — Ricostruzione con identificativi N08–N14 ed E01/E02. La decisione “Pagamento effettuato?” esplicita i due esiti mostrati nel Miro.

I nodi numerati consentono di risalire alle schede funzionali nei capitoli 4–8. “New Connection …” del canvas originale è un identificativo grafico e non un ulteriore stato business.

4. FASE 1 – Start e check fatturabilità

La prima fase individua, in modalità massiva, i contratti candidati alla fatturazione nel periodo, esegue controlli prima dell’avvio dell’istanza e accoda le richieste ammissibili. I record non idonei devono essere tracciati e potenzialmente recuperati dopo bonifica. La creazione effettiva delle PI è affidata al meccanismo asincrono discusso con l’Orchestrator.

N01  |  Start e selezione contratti

FASE / TIPOFASE 1  ·  Start / batch tecnico
QUANDO SI ATTIVAScatta la schedulazione del ciclo di fatturazione.
COSA SUCCEDEIl batch interroga l’oggetto Contract e individua i contratti potenzialmente fatturabili in base al periodo e alla periodicità (mensile, bimestrale, semestrale). Il dettaglio della query sulle date deve essere verificato.
DATI / OGGETTIContract; frequenza di fatturazione; riferimento temporale; campi nominati “Invoice To Date” e “Next … To Invoice” (terminologia da confermare).
RISULTATO E PASSAGGIOLista di contratti candidati, da passare al check di fatturabilità.
ERRORI / ECCEZIONIContratti non dovuti nel periodo restano fuori selezione; query/operatore comparativo da verificare.
STATO ANALISIEmerso; nomi campo e criteri esatti da confermare.

N02  |  Check fatturabilità

FASE / TIPOFASE 1  ·  Validazione record
QUANDO SI ATTIVAPer ogni contratto candidato individuato da N01.
COSA SUCCEDEVerifica disponibilità e congruenza dei dati tecnici e di consumo. Nella riunione si citano dati Metering/Consumption mancanti, nulli, errati o fuori scala. Le regole puntuali sono ancora da ricevere/definire.
DATI / OGGETTIContract, Metering, Consumption ed eventuali dati tecnici di fornitura.
RISULTATO E PASSAGGIOEsito di ammissibilità del contratto, con motivazione per i casi esclusi.
ERRORI / ECCEZIONIDati anomali non devono proseguire senza segnalazione; le regole “regex” sono citate come esempio, non come catalogo approvato.
STATO ANALISIPre-check obbligatorio nel disegno; regole di business da dettagliare.

Evidenza: 27:59–35:22.

C01  |  Condizione: contratto fatturabile?

FASE / TIPOFASE 1  ·  Decisione funzionale esplicitata
QUANDO SI ATTIVATerminato il controllo N02.
COSA SUCCEDESe l’esito è positivo il record entra nelle richieste di creazione PI; se negativo il record viene scartato dal run corrente, con tracciatura.
DATI / OGGETTIEsito e motivazione della validazione.
RISULTATO E PASSAGGIOSÌ → N04; NO → N03.
ERRORI / ECCEZIONIDefinire la differenza tra esclusione temporanea, errore correggibile e contratto realmente non fatturabile.
STATO ANALISIElaborazione funzionale basata sul controllo descritto; il rombo non è esplicito nel Canvas originale.

N03  |  Scarti, bonifica e recupero

FASE / TIPOFASE 1  ·  Ramo KO prima della PI
QUANDO SI ATTIVAC01 negativo.
COSA SUCCEDEL’operatore deve poter consultare i record scartati, identificare il motivo, correggere il dato e riportare la posizione in un ciclo successivo, ove fatturabile.
DATI / OGGETTIIdentificativo Contract, lotto/batch, codici anomalia, dettagli controlli, data e tentativi.
RISULTATO E PASSAGGIOReport/elenco scarti da riprendere; in questo punto non viene creata alcuna Process Instance.
ERRORI / ECCEZIONIÈ aperta l’ipotesi di utilizzare le batch request esistenti per gli errori business; non confondere scarti business con fault tecnici.
STATO ANALISITo do confermato; soluzione di gestione scarti da definire.

Evidenza: 32:47–36:27 e 1:26:24–1:26:55.

N04  |  Accodamento richieste creazione PI

FASE / TIPOFASE 1  ·  Buffer tecnico asincrono
QUANDO SI ATTIVAN02 completato con esito ammissibile.
COSA SUCCEDEIl batch inserisce nel buffer richieste contenenti Contract ID e Process Definition; un componente tecnico le accoda e le suddivide in transazioni asincrone piccole per la creazione/evaluate delle PI.
DATI / OGGETTIContract ID, Process Definition ID, richiesta di creazione, identificativo lotto/batch.
RISULTATO E PASSAGGIORichieste pronte per il componente di creazione PI, senza attendere nel finish del batch tutti gli Evaluate asincroni.
ERRORI / ECCEZIONIGestione duplicazioni, lock concorrenti, fallimenti e completamento parziale del buffer da progettare.
STATO ANALISISoluzione proposta in riunione; modello tecnico del buffer da validare.

Evidenza: 49:09–58:16.

5. FASE 2 – Da fatturare e generazione Invoice

La creazione e la promozione della PI sono il raccordo tecnico fra la fase iniziale e il lavoro fatturativo. Il batch di produzione fatture prende in ingresso le Process Instance nello stato atteso, risale ai relativi contratti e applica il motore di calcolo. L’avanzamento della PI avviene tramite Orchestrator, non con un update diretto del record.

N05  |  Creazione PI ed Evaluate

FASE / TIPORACCORDO 1 → 2  ·  Orchestrator
QUANDO SI ATTIVAIl buffer di fase 1 presenta una richiesta.
COSA SUCCEDELa chiamata al metodo dedicato dell’Orchestrator crea la Process Instance associata alla Process Definition e al Contract (Record ID). L’Orchestrator gestisce creazione dello stato iniziale, step e successivo Evaluate.
DATI / OGGETTIProcess Definition, Record ID del contratto. Eventuali payload/parametri aggiuntivi da disegnare.
RISULTATO E PASSAGGIOPI inizialmente New, quindi passaggio al sotto-stato/step “Da fatturare” secondo le regole configurate.
ERRORI / ECCEZIONINon creare direttamente il record PI e non forzare dall’esterno i campi di motore; metodo non massivo e asincronia da gestire.
STATO ANALISIPrincipio applicativo discusso; API e configurazione da confermare.

Evidenza: 35:22–41:04 e 49:09–58:16.

N06  |  Da fatturare / Attesa da fatturare

FASE / TIPOFASE 2  ·  Stato BPM / nodo attesa
QUANDO SI ATTIVAPI promossa dall’Orchestrator dopo N05.
COSA SUCCEDELa PI rappresenta il contratto pronto a concorrere al batch di generazione fatture. Il successivo batch deve partire soltanto quando il gruppo previsto di PI è nello stato corretto; il criterio di gruppo e la soglia buffer sono da definire.
DATI / OGGETTIProcess Instance + Contract ID, stato/sotto-stato e identificativo lotto.
RISULTATO E PASSAGGIODisponibilità della PI come input della query del batch Invoice.
ERRORI / ECCEZIONIUna PI non pronta non deve essere prematuramente elaborata; evitare l’assunzione che “finish del batch” equivalga a completamento degli async Evaluate.
STATO ANALISINodo presente nel Miro; logica di sincronizzazione tecnica aperta.

Evidenza: 40:35–51:22 e diagramma Miro Fase 2.

N07  |  Batch creazione Invoice e Invoice Line Item

FASE / TIPOFASE 2  ·  Batch tecnico + Billing Calculation
QUANDO SI ATTIVALotto delle PI in stato “Da fatturare” pronto per essere processato.
COSA SUCCEDEPer ogni PI il batch risale al Contract e al periodo di fatturazione, recupera Metering, ottiene Consumption, valuta i Billable Concept e le Calculation Rule e applica quantità × prezzo (incluse voci fisse dove configurate). Crea un’Invoice e i relativi Invoice Line Item.
DATI / OGGETTIProcess Instance, Contract, Metering, Consumption, Billable Element/Concept, Price List, Calculation Rule, Invoice, Invoice Line Item.
RISULTATO E PASSAGGIOInvoice persistita con le righe corrispondenti alle voci da fatturare, pronta per il documento PDF.
ERRORI / ECCEZIONIGestire errore per singola Invoice, transazioni parziali e riesecuzioni senza duplicati; una Invoice per contratto/periodo è l’ipotesi attuale discussa.
STATO ANALISIComportamento illustrato; dettaglio input/prezzi e gestione errori da approfondire.

Evidenza: 58:16–1:04:39 e 1:10:06–1:11:40.

N08  |  Fattura generata e feedback al BPM

FASE / TIPOFASE 2 → 3  ·  Stato di transizione
QUANDO SI ATTIVAEsito positivo del batch di creazione Invoice.
COSA SUCCEDEIl batch comunica il completamento e chiede l’avanzamento della PI tramite buffer/metodi Orchestrator. Il riferimento Invoice deve essere ricostruibile; non è consentito assumere un update esterno diretto della lookup sulla PI.
DATI / OGGETTIPI ID, Invoice ID, esito di generazione, lotto e output.
RISULTATO E PASSAGGIOSotto-stato/step “Fattura generata”; la PI diventa selezionabile dal batch PDF.
ERRORI / ECCEZIONIAssociazione Invoice alla PI non definita: query contestuale, metodo dedicato o ulteriore modello di relazioni da progettare.
STATO ANALISIIntegrazione PI–Invoice e metodo feedback ancora aperti.

Evidenza: 1:04:41–1:13:14.

6. FASE 3 – Generazione documento PDF

N09  |  Attesa / batch generazione documento

FASE / TIPOFASE 3  ·  Batch tecnico
QUANDO SI ATTIVAPI nello stato “Fattura generata” e Invoice disponibile.
COSA SUCCEDEIl batch legge le Invoice idonee e genera il documento PDF della fattura; l’attività è distinta dalla creazione dei record Invoice/Line Item. Il PDF deve essere collegabile all’Invoice o al record documento previsto.
DATI / OGGETTIInvoice, Invoice Line Item, dati di stampa / template, documento PDF.
RISULTATO E PASSAGGIODocumento disponibile per l’invio; feedback al BPM attraverso buffer di avanzamento.
ERRORI / ECCEZIONIGestire errori di template, documento non generato, file duplicati o incompleti; specificare il sistema Document Composer effettivamente utilizzato.
STATO ANALISIBatch PDF dichiarato già eseguibile a fini demo; orchestrazione da integrare.

Evidenza: 1:13:14–1:14:07, 1:18:13–1:18:46.

N10  |  Documento generato / attesa invio

FASE / TIPOFASE 3 → 4  ·  Stato BPM / nodo attesa
QUANDO SI ATTIVAGenerazione PDF con esito positivo.
COSA SUCCEDEL’Orchestrator porta la PI al nodo di attesa del successivo invio al cliente quando i feedback del lotto risultano pronti.
DATI / OGGETTIProcess Instance, Invoice, riferimento documento, esito batch e buffer.
RISULTATO E PASSAGGIOSelezionabilità per l’operazione di invio.
ERRORI / ECCEZIONIPer i PDF con errore, definire se la PI resta in attesa, va in un ramo KO o viene riprocessata.
STATO ANALISIStato funzionale visibile; gestione KO da definire.

Evidenza: 1:13:53–1:14:07 e Miro Fase 3.

7. FASE 4 – Invio al cliente

N11  |  Invio email cliente

FASE / TIPOFASE 4  ·  Batch / integrazione invio
QUANDO SI ATTIVADocumento PDF prodotto e associato alla fattura.
COSA SUCCEDEInvio al cliente della fattura e del relativo riferimento di pagamento. La riunione prevede un batch come modello di analisi/demo, ma valuta un servizio esterno o middleware per un volume elevato di comunicazioni.
DATI / OGGETTIInvoice, PDF, recapito destinatario, riferimento contratto e link di pagamento.
RISULTATO E PASSAGGIOComunicazione partita (ove tecnicamente effettuata) e passaggio a fase di attesa dell’esito.
ERRORI / ECCEZIONICanale e contenuto email, allegato PDF, consegna effettiva, bounce, retry e limiti Salesforce non sono stabiliti nel disegno.
STATO ANALISICanale da scegliere; invio Salesforce considerato principalmente per demo.

Evidenza: 1:13:53–1:17:54 e 1:18:56–1:26:20.

N12  |  Pagamento non effettuato / attesa pagamento

FASE / TIPOFASE 4 → 5  ·  Stato di attesa evento
QUANDO SI ATTIVADocumento inviato o lavorazione di invio completata.
COSA SUCCEDELa singola PI rimane in attesa di un evento di incasso. Il disegno mostra il nodo “Pagamento non effettuato” e i rami “Pagamento effettuato” / “Invio sollecito”. La regola che determina il trascorrere del tempo non è specificata.
DATI / OGGETTIPI, Invoice aperta, identificativo pagamento, canale di incasso, scadenza fattura.
RISULTATO E PASSAGGIOEvento incasso positivo → N13; mancato incasso a scadenza → N14.
ERRORI / ECCEZIONINon interpretare “non effettuato” come già insoluto al momento dell’invio. Definire controllo scadenza, tolleranze, parziali, esiti tardivi e reminder.
STATO ANALISITransizione temporale e messaggi pagamento da definire.

8. FASE 5 – Incasso e sollecito

C02  |  Condition: pagamento ricevuto?

FASE / TIPOFASE 5  ·  Condizione ricostruita
QUANDO SI ATTIVAArrivo di evento di pagamento o scadenza della finestra di pagamento.
COSA SUCCEDEValuta un esito di pagamento ricevuto da provider esterno/Payment-Collection rispetto all’Invoice da saldare. Il Miro mostra le transizioni, non tutte le verifiche applicative.
DATI / OGGETTIInvoice, esito, importo, data, riferimenti di riconciliazione e Process Instance.
RISULTATO E PASSAGGIOSÌ → N13; NO / scadenza → N14.
ERRORI / ECCEZIONIDefinire pagamento parziale, pagamenti duplicati, pagato ma non riconciliato, webhook ritardati e scadenze.
STATO ANALISIElaborazione funzionale per esplicitare il bivio visibile nel Miro.

Evidenza: 1:14:07–1:17:54.

N13  |  Pagamento effettuato

FASE / TIPOFASE 5  ·  Evento di incasso
QUANDO SI ATTIVAEsito di pagamento positivo acquisito/riconciliato.
COSA SUCCEDEIl BPM riceve il segnale relativo alla singola Invoice/PI ed effettua l’Evaluate; il processo procede verso END OK.
DATI / OGGETTIPayment / Collection, Invoice, PI, evento e ID transazione.
RISULTATO E PASSAGGIOTransizione a E01 – END OK.
ERRORI / ECCEZIONIVerificare quando considerare l’esito definitivo: autorizzazione, contabilizzazione, incasso bancario oppure riconciliazione.
STATO ANALISIMeccanismo eventi ipotizzato, non progettato end-to-end.

Evidenza: 1:15:00–1:17:54.

N14  |  Invio sollecito

FASE / TIPOFASE 5  ·  Ramo non pagamento
QUANDO SI ATTIVALa fattura non risulta pagata secondo la regola temporale definita.
COSA SUCCEDEAttiva l’invio del sollecito o la funzione di recupero credito prevista. Il diagramma chiude questo ramo con END sollecito, non ne dettaglia gli step successivi.
DATI / OGGETTIInvoice, PI, scadenza, stato debito e recapiti.
RISULTATO E PASSAGGIOTransizione a E02 – END sollecito.
ERRORI / ECCEZIONINecessari prerequisiti normativi/contrattuali, possibili importi parziali e collegamento con BPM morosità, da analizzare a parte.
STATO ANALISITraccia macro-funzionale; procedura di morosità esclusa dal dettaglio attuale.

Evidenza: Miro Fase 5; 1:16:22–1:17:54.

E01 / E02  |  Conclusione dei due rami

FASE / TIPOFASE 5  ·  End
QUANDO SI ATTIVAE01 dopo incasso; E02 dopo sollecito.
COSA SUCCEDEChiude il ramo eseguito, conservando tracciabilità della PI. L’eventuale prosecuzione in un processo separato di morosità non è mostrata nel diagramma.
DATI / OGGETTIPI ID, evento conclusivo, timestamp, Invoice collegata.
RISULTATO E PASSAGGIOEsito registrato e processo concluso sul ramo corrispondente.
ERRORI / ECCEZIONIDa decidere se sollecito è davvero end del processo o hand-off a sottoprocesso di collection.
STATO ANALISIEnd disegnati; handoff post-sollecito da confermare.

Evidenza: Miro Fase 5.

9. Condition, Connection e transizioni di stato

Il disegno usa connection per portare l’istanza fra nodi e stati di attesa. Le etichette tecniche “New Connection …” non rappresentano stati; i nomi business sono quelli riportati accanto ai nodi: Da fatturare, Fattura generata, Documento generato, Invio email cliente, Pagamento effettuato/non effettuato, Invio sollecito.

DA → AEVENTO / REGOLANOTE
Start → Da fatturareContratto ammissibile, PI creata e Evaluate completato.Creazione PI via buffer; lo stato New iniziale non equivale a stato terminale.
Da fatturare → Fattura generataBatch Invoice + Invoice Line Item completato ed esito comunicato a Orchestrator.Gestione KO ancora non modellata nel Miro.
Fattura generata → Documento generatoBatch PDF completato, file disponibile.Attesa e ritorno buffer per avanzare PI.
Documento generato → Invio email clienteBatch/servizio invio fattura completato.Canale di delivery da progettare.
Invio email → Pagamento effettuatoEvento incasso ricevuto ed elaborato.Esempio pagoPA discusso, integrazione da progettare.
Invio email → Pagamento non effettuato → SollecitoFattura non saldata alla scadenza valida.Soglia temporale, reminder e scenari parziali TBD.
Pagamento effettuato → END OKEsito finale positivo.Definire evento finanziario conclusivo.
Invio sollecito → END sollecitoSollecito generato/inviato.Eventuale BPM morosità separato TBD.

9.1 Distinguere Status tecnico, Process Status e Substatus

CAMPOSIGNIFICATOVALORI CITATI / NOTE
Status tecnico PIStato tecnico di esecuzione della Process Instance.In Progress, completamento/errori del motore; non va confuso con la fase business.
Process StatusStato funzionale macro del processo.New e In Progress vengono citati; il naming definitivo va verificato nel modello BPM.
Substatus / StepFase operativa/attesa corrente.Da fatturare, Fattura generata, Documento generato, Invio email cliente, ecc.
Esito batchEsecuzione del job di lavorazione.Success/KO/partial/number processed (proposta: nomenclatura da definire).
I valori esatti Process Status/Substatus appaiono nelle note Miro, ma la terminologia non è totalmente coerente nella trascrizione. Prima di implementare la matrice degli stati, occorre validare nomi API, picklist e quali transizioni siano gestite dal solo Orchestrator.

10. Orchestrazione batch, buffer e asincronia

Figura 3 — Sequenza tecnica proposta: batch → buffer → lavorazione asincrona → Evaluate/avanzamento → batch successivo.

Il primo batch seleziona i contratti, li valida e alimenta una struttura di accodamento. Il componente tecnico preleva le richieste con granularità ridotta perché il metodo di creazione/evaluate delle PI non è massivo. Per i batch successivi il meccanismo si ripete come feedback di avanzamento: il batch produce oggetti business; il buffer comunica a BPM che la PI può avanzare. L’istanza è il governatore del processo e l’obiettivo di questa separazione è l’audit per record.

L’evento “fine batch” non prova da solo che tutti gli Evaluate asincroni siano terminati; è necessario tracciare il lotto o il numero di richieste effettivamente completate, incluse quelle in errore. Il buffer non risulta ancora implementato ed è oggetto di un disegno tecnico dedicato.

Fonte: 41:04–58:16 e 1:06:47–1:13:14.

10.1 Regole tecniche emerse / aspetti di progettazione

ASPETTOCOMPORTAMENTO DI ANALISIDA DECIDERE
Inserimento bufferIl batch inserisce/upserta le richieste da lavorare.Formato payload, correlazione batch/PI/Contratto, design record singolo vs multipli.
Worker OrchestratorEsegue create/evaluate una richiesta per transazione asincrona o piccoli chunk.Soglia chunk, parallelismi, retry/poison records, limiti Salesforce.
Trigger di lancioPossibile trigger al riempimento buffer o evento di completamento lotto.Soglia e condizione di drain completo, comportamento su buffer parziali.
ContemporaneitàPossibile contesa sul record buffer.Lock, query FOR UPDATE, idempotenza e possibilità di più record/figli.
Feedback fasiBatch Invoice/PDF/Invio comunica esito al buffer; l’Orchestrator avanza.Payload di risultato, propagazione identificativi Invoice/Document, gestione KO.
Contesto business PIRecord ID della PI associato al Contract per tutto il ciclo.Come raggiungere Invoice/Document senza alterare direttamente il Record ID della PI.
Pagamento individualeDopo invio è attesa una progressione per eventi con numerosità più bassa.Configurazione evento, retry, riconciliazione, scadenza e sollecito.

11. Oggetti e dati funzionali

OGGETTO / COMPONENTEFUNZIONE NEL FLUSSORELAZIONI / VERIFICHE
ContractFonte della fatturabilità e del periodo; riferimento primario della PI.Record ID PI = Contract; periodicità; date di fatturazione.
Metering / ConsumptionLetture e consumi da verificare e utilizzare per il calcolo.Validazione preventiva e utilizzo per quantità.
Billable Element / ConceptElementi e voci economiche fatturabili.Calculation Rule, Price List, eventuale Tax.
Invoice / Invoice Line ItemRisultato economico persistito e singole righe della fattura.Legame con Contract e possibile contesto/lookup PI da definire.
Documento / PDFRappresentazione documentale della fattura.Link a Invoice e meccanismo d’invio.
Process DefinitionDefinisce step, stati e connection del processo.Parametro per creazione PI da metodo dedicato.
Process InstanceOrchestrazione e auditing della singola fatturazione rappresentata.Avanzamento via Evaluate, non via update esterni.
Batch e bufferGestione massiva dei lotti e handoff asincroni.Run/Batch ID, record buffer, request e feedback.
Payment / CollectionConferma incasso, mancato pagamento, sollecito.Eventi / API e riconciliazione da integrare.

11.1 Campi temporali – esigenza, non mappatura approvata

La riunione cita “Invoice To Date” e “Next … To Invoice” come date utili a selezionare i contratti, in relazione alla periodicità (mensile/bimestrale/semestrale). Poiché il nome tecnico e l’operatore della query non vengono confermati, la specifica di implementazione deve acquisire i nomi API effettivi e distinguere data fine periodo fatturato, data prossima emissione e data di esecuzione del batch.

12. Gestione delle eccezioni, massività e audit

CASOCOMPORTAMENTO ATTESOCLASSIFICAZIONE
Contract candidato con dati mancantiEsclusione dal lotto corrente con motivazione leggibile e recupero dopo bonifica.Requisito funzionale emerso; implementazione da definire.
Invoice generata con KOFeedback negativo per la singola PI e possibilità di rielaborazione controllata.Proposta; ramo KO non disegnato.
Documento PDF assente/erroreLa PI non deve proseguire come “Documento generato”.Proposta di coerenza; branch da modellare.
Invio email fallitoEsito consegna o almeno dispatch e retry separati.Open point canale di invio.
Pagamento non riconciliatoNon chiudere automaticamente come pagato senza regola; gestione manuale/anomalie.Proposta / da dettagliare.
Batch completato ma PI ancora in EvaluateNon avviare la fase successiva prima della conferma complessiva del lotto.Vincolo architetturale discusso.
Replay di buffer o eventoPrevenire creazioni doppie della stessa Invoice/PI e doppie comunicazioni.Requisito tecnico da validare.
Concorrenza sul bufferProteggere aggiornamenti concorrenti e idempotenza; definire struttura dati.Open point tecnico.

12.1 Prova di carico / POC

La scelta “istanze multiple” è condizionata da una prova tecnica realistica. Nel confronto viene suggerito un ordine di grandezza di circa 6.000–8.000 record come target di simulazione per comprendere limiti e tempi; NON è un requisito contrattuale né una capacità già dimostrata. La prova dovrebbe misurare: tempo di creazione e Evaluate PI, tempo complessivo per fase, throughput del buffer, lock/concorrenza, limiti di transazione, errori e recupero, comportamento dei retry e numerosità record di motore generati.

Fonte: 18:54–20:27, 52:49–56:58, 1:26:55–1:28:38.

13. Requisiti funzionali e non funzionali

IDDESCRIZIONETIPOSTATO
RF-01Selezionare contratti da fatturare per periodo e periodicitàFunzionaleDa dettagliare
RF-02Eseguire check fatturabilità prima di creare PIFunzionaleAccettato come esigenza
RF-03Consultare scarti con causa, bonifica e successiva ripresaFunzionaleOpen point di soluzione
RF-04Creare PI associata a Contract tramite metodo OrchestratorFunzionalePrincipio emerso
RF-05Gestire le transizioni via Evaluate e non update direttoFunzionalePrincipio emerso
RF-06Creare Invoice e Line Item usando consumo e regole prezzoFunzionaleMacro flusso illustrato
RF-07Generare PDF riferito alla InvoiceFunzionaleDemo tecnica riportata
RF-08Inviare fattura/documento al cliente con tracciatura esitoFunzionaleCanale da decidere
RF-09Ricevere e riconciliare evento incasso per singola PIFunzionaleInterfaccia da definire
RF-10Gestire mancato pagamento e sollecitoFunzionaleTempistiche da definire
RNF-01Eseguire massivamente con buffer asincrono senza race conditionNon funzionalePOC da eseguire
RNF-02Garantire audit per contratto/fase e correlazione batchNon funzionaleDa implementare
RNF-03Rendere idempotenti create/avanzamenti/riavviiNon funzionaleDa definire

14. Open point, decisioni e attività

IDTEMAAZIONE / DECISIONECOINVOLGIMENTO INDICATO*PRIORITÀ
OP-01Scelta architetturale A/B/CConfermare il livello di granularità PI (per contratto, per periodo/lotto o non BPM).Giuseppe + team BPMAlta
OP-02MassivitàEseguire POC con diverse migliaia di contratti/PI, misurare throughput e limiti.Simone + GianfrancoAlta
OP-03Disegno bufferRecord singolo JSON vs record multipli/figli; identificazione lotto; concorrenza.Simone + Nicola + GianfrancoAlta
OP-04Creazione / Evaluate PIDefinire API, payload, chunk, trigger, retry e condizioni di completamento.SimoneAlta
OP-05Pre-check fatturabilitàDefinire regole tecniche e business ufficiali, date e parametri query.Gianfranco + referente businessAlta
OP-06ScartiReport, cause, bonifica e reinserimento nel successivo ciclo.Gianfranco + NicolaAlta
OP-07Associazione Invoice alla PIDefinire contesto record/lookup/queries senza alterare Record ID Orchestrator.Simone + GianfrancoAlta
OP-08Stati e SubstatusAllineare nomi API Process Status/Substatus, label di Miro e regole di Evaluate.Team BPMAlta
OP-09DocumentoSpecificare template, batch PDF, feedback e gestione errori.Team Billing/Doc ComposerMedia
OP-10Invio email clienteDecidere Salesforce (demo) vs middleware provider; PDF allegato e link.Architettura + integrazioniAlta
OP-11Eventi pagamentoDefinire ingressi pagoPA/SDD/altro, criterio incasso definitivo e riconciliazione.Billing/PaymentAlta
OP-12SollecitoDefinire scadenze, numero tentativi e raccordo con processo morosità.Business + BPMMedia
OP-13Dual fuelConfermare esclusione scenario contratto unico multiservizio, valutare evoluzione.Product governanceMedia
OP-14Allineamento fonti MiroRiconciliare note “vecchie” delle tabelle laterali con diagramma corrente.Alessia + team analisiMedia
OP-15OwnershipDefinire responsabilità step e regole di assegnazione, già segnalate in task.Team BPMMedia

* Coinvolgimenti ricavati da chi ha discusso i punti nella riunione o proposti come responsabilità di analisi, non assegnazioni formalmente approvate.

14.1 Elementi dichiarati come già sviluppati / non ancora pronti

ATTIVITÀSTATO RIFERITO NELLA RIUNIONE
Batch generazione Invoice / Invoice Line ItemGianfranco indica che può già essere mostrato in demo, al netto dell’uso delle Process Instance.
Batch generazione PDFGianfranco dichiara di aver sviluppato il batch che genera PDF a partire dalle Invoice.
Batch check fatturabilitàNon ancora sviluppato al momento della riunione; richiesta analisi dei controlli.
Buffer / avanzamento asincrono PIDa disegnare e validare con Simone/Nicola, non confermato come funzionalità esistente.
Invio emailValutato soprattutto come demo; produzione potenzialmente fuori Salesforce.

Fonte: 1:18:13–1:26:55.

15. Fonti e riferimenti temporali

F1 — “BPM – Processo Billing.docx”, trascrizione della riunione del 15/10/2026 (1 h 30 m 19 s). Il documento mantiene i tempi di intervento usati nelle note delle schede nodo.

F2 — “BPM – Processo Billing-20261015_153943-Registrazione della riunione.mp4”, registrazione audiovisiva della stessa riunione. Le schermate di Miro utilizzate nel video sono coerenti con i riferimenti allegati.

F3 — Immagini allegate del diagramma Miro: fasi 1–5; post-it sul buffer asincrono; confronti “istanze multiple” e “procedurale”.

Le tre figure presenti in questo documento sono ricostruzioni esplicative, non una copia del disegno tecnico. Le biforcazioni di eleggibilità e pagamento sono esplicitazioni funzionali necessarie alla lettura e richiedono la validazione della loro implementazione.

Questo documento è una base per walkthrough funzionale e revisione con BPM, Billing e Integrazioni. Non sostituisce la specifica tecnica delle API, il catalogo regole del check fatturabilità, il data model dettagliato o l’approvazione della soluzione architetturale.

Share this Doc

BPM Billing – Fatturazione e Incasso

Or copy link

CONTENTS