# Console BO-Billing-Subscriptions

associare e gestire in modo completo un Accounting Model Template ad una o più Subscription

**Subscription-Add Subscription** testo slide 4??

nuovo menu
Sotto il menù "Billing Engine" del BO, si prevede la creazione di una nuovo left menù "Billing Subscription".
Le principali funzionalità previste per questa gestione saranno:

. Visualizzazione di accounting model template ad una subscription

. Associazione/Configurazione di accounting model a una o a più subscription (il bottone "Configure" sarà abilitato solo dopo averne selezionata almeno una)

Casi d'uso

- associazione regole di accounting a subscriptions

- visualizzazione e gestione regole di accounting di una subscription

## Associazione regole di accounting a subscriptions

### Billing Engine– Subscriptions

#### slide 7 Configure Billing-Subscription – Ricerca Subscription e avvio configurazione

Al percorso Subscription – Billing Subscription è possibile **ricercare le sottoscrizioni** che devono essere associate a regole per la fatturazione.

**ricerca delle condition active per subscription**: esporre pubblicamente l'api */condition-active/search*

***TODO inserire qui request e response del servizio***

Individuate le sottoscrizioni, l’utente può procedere con la selezione singola o multipla per avviare la procedura di configurazione attraverso il bottone "Configure"

#### slide 9 Configure Billing-Subscription – Sezione 2 - Accounting Model Template
Successivamente alla sezione "Billing Subscription", il sistema mostra la sezione "Accounting Model Template" (all’apertura della pagina la sezione sarà minimizzata). Tale gestione permette la visualizzazione di **tutti gli accounting model template associati alla subscription presente e selezionata nella sezione "Billing Supscription"** (di default verranno visualizzati i template della prima sottoscrizione presente in tabella). Le date visualizzate di start e di end sono il range di date di tutte le regole presenti all’interno di quel template. All’interno della sezione "Accounting model template" è possibile effettuare l’operazione di **disassociazione di un template**. Tale operazione è possibile eseguirla tramite il bottone presente per ogni template già associato. Tale operazione andrà a disassociare le regole relative a quella sottoscrizione per quePrima di procedere all’operazione, l’utente dovrà confermare l’operazione tramite un messaggio di warning.llo specifico template

Azioni:
- modello dell'accounting model template
- ricerca degli accounting model template associati alla subscription `POST accounting-templates/association/search` (TODO), in alternativa si puo' usare {{serviceHost}}/condition-active/search (esistente)
- disassociazione (chiamata all'api per terminare la regola) `PUT condition-active/{conditionActiveId}`

- filtri percorso (??) gestiti da FE dai dati presenti in memoria, che esistono gia' dalle pagine precendenti

(Cristiano)

- Creare un oggetto "template istanziato" che contiene il riferimento al template originante, il range di date di accounting passato inizialmente, ed è associato a gruppi e condition active (al posto del template)

- Nella lista si mostrano (e si terminano) tutti i template istanziati. Se si terminano bisogna indicare la data di termine e tutte le regole contenute vengono terminate a quella data.

- Non è possibile creare un nuovo template istanziato o aggiungere una regola ad uno esistente se esiste già un altro template istanziato contenente una regola associata ad una delle sottoscrizioni selezionate e le cui date si sovrappongono a quelle inserite o alle date del template instanziato che si sta cercando di espandere.

#### slide 10 Configure Billing-Subscription – Sezione 3 - Accounting Model Configuration ####

Successivamente alla sezione "Accounting Model Template", il sistema mostra la sezione "Accounting Model Configuration". Tale gestione permette l’**associazione di un template già associato al Fabrick user presente nella subscription** selezionata precedentemente oppure permette l’**associazione di un nuovo template da configurare**. Le due liste relative alla scelta di un accounting model template sono coerenti e quindi pre-filtrate per prodotto/i all’interno delle sottoscrizioni selezionate.

Azioni
- API (esistente) per estrazione elenco **Volume Item** `POST volume-items/search`
- API (TODO) per l'estrazione di valori validi per
- **Frequenza** `GET rule-templates/available-frequencies`,
- **CAP Type** `GET rule-templates/available-cap-types`,
- **FloorType** `GET rule-templates/available-floor-types`
- **Cost Type** `GET rule-templates/available-cost-types`.
Proporre unica chiamata che produce tutte le liste
- ricerca degli accounting tempate associabili ` POST accountin-templates/associable/search` a cui aggiungere filtri per i template gia' utilizzati dall'utente; (fatto)
- salvataggio dell'accounting-template-instance: esposizione di un servizio a `POST invoice-references` (esistente )che al suo interno inserisce l'invoice reference e maschera l'inserimento dei condition group associati `POST condition-group` (esistente);(fatto)
- associazione di un nuovo template (implicita nel salvataggio del condition group) -> creazione di un invoice reference e di tutte le regole sottostanti. (fatto)

**DOMANDA** capire, ai fini della ricerca, le implicazioni di "un template già associato al Fabrick user presente nella subscription"
IN caso di nuova asssociazione cosa comporta la seguente frase (da slide 21): *Si ricorda che non è possibile associare più accounting model template nello stesso periodo temporale*.

#### slide 11 Configure Billing-Subscription – Sezione 4 «Accounting Model Detail» ####

Dopo aver selezionato il template da utilizzare, viene aperta una sezione in cui è possibile **visualizzare le regole di accounting**. Sarà possibile modificare solo gli importi, gli scaglioni e le date di «End Accounting Date» delle varie condition actives.
Le condizioni di accounting sono dinamiche in base al template utilizzato e per ogni condizione vengono visualizzate le sottoscrizioni che la utilizzano di quello specifico Fabrick User.

Azioni:
- ricerca regole per ???
- modifica regole (solo importi, scaglioni e data di termine) (FE)
- ricerca sottoscrizioni per regola e utente (operazione di competenza di un altro gruppo)

DOMANDE RIcordare a Roberta che non c'e' la ricerca per le Macro Aree

#### slide 12 Configure Billing-Subscription – Sezione 4 «Accounting Model Detail» ####

Per le condition group, il sistema mostrerà i campi relativi a:
- Product Macro Area
- Minimum Guaranteed Aggregate (€)
- Minimum Guaranteed Aggregate Type
- CAP Aggegate (€)
- CAP Aggregate Type

Questi campi potranno essere visualizzati nel dettaglio e modificati attraverso i pulsanti «View» e «Edit» .

Successivamente, verranno mostrate in una tabella le condiction active **presenti nel template** scelto, visualizzando i dati relativi a:
- tipo,
- volume item,
- prodotto,
- import,
- multiplier,
- minimo garantito specifico
- Cap.

Per ogni condition active è possibile visualizzare/modificare i dettagli attraverso i bottoni «View» e «Edit»
Successivamente **verranno mostrate in una tabella le sottoscrizioni che gestiscono le condition actives** visualizzando i dati relativi a:
- ID della sottoscrizione,
- ID del fabrick user,
- Fabrick User,
- ID del prodotto della sottoscrizione
- prodotto della sottoscrizione
- producer.

AZIONI
le condiction active presenti nel template

recuperare le sottoscrizioni che gestiscono le condiction active presenti nel template

*per gli scaglioni deve esistere almeno uno scaglione con valore minimo 1 e deve esistere uno scaglione privo di limite superiore e gli scaglioni devono essere contigui*

### Configure Billing-Subscription – Sezione 5 «Billing Configuration» - slide 17

La sezione successiva è quella relativa alle billing configuration.
Vengono presentate le righe fattura che verranno create, per le quali è possibile inserire una **descrizione personalizzata** (la descrizione verrà presuggerita dal sistema visualizzando :
Descrizione condition group – Prodotto o macro area – VI.
È possibile inserire il destinatario della fattura (di default il FabrickUser selezionato) e il template fattura relativo. Il campo «Invoice template» verrà prefiltrato per i template specifici del destinatario precedentemente scelto.

AZIONI
Ricerca invoice template `POST invoice-references/search`, gia' esistente ma occorre modificarla per includere billingSubject nelle condizioni di ricerca

**DOMANDA**:
il campo invoice row description contiene la descrizione estesa?
E' necessario mostrare una spiegazione a FE dei token per le descrizioni

## Visualizzazione e gestione regole di accounting di una subscription
### View Billing-Subscription – Ricerca Subscription e visualizzazione - slide 19
Al percorso Subscription – Billing Subscription è possibile **ricercare le sottoscrizioni associate o meno template** e procedere con la visualizzazione dei dettagli attraverso il bottone «View»
Il bottone sarà attivo solo per le sottoscrizioni che hanno almento un **accounting model template** associato.

#### Sezione 1 - «Billing Subscription» - slide 20

Successivamente al click su «View», il sistema mostrerà, in una nuova pagina, la sezione «Billing Subscription» che ha lo scopo di informare l’utente su quale sottoscrizione sta lavorando. All’interno della tabella informativa verranno visualizzate le colonne relative a:
* ID della sottoscrizione,
* Fabrick user ID,
* fabrick User,
* prodotto,
* producer ,
* stato della sottoscrizione
* se la sottoscrizione ha un accounting model template associato o meno.

#### Sezione 2 - «Billing Subscription» - slide 21
Successivamente alla sezione «Billing Subscription» viene visualizzata la sezione relativa agli **account model template associati per periodo temporale**.
Si ricorda che *non è possibile associare più accounting model template nello stesso periodo temporale*.

**DOMANDA**:
Perche' e' possibile disassociare da questa pagina? (vedi slide 9)
### Billing-Subscription – Visualizzazione Associazione - slide 22
Una volta selezionato uno specifico account model template tramite il tasto «View», **viene visualizzata una sezione dedicata al suo accounting model detail**. Entrando nel dettaglio verranno visualizzati i dettagli visti prima con la possibilità di modifica dei solo campi specificati nelle slide precedenti.

Azioni:
ricerca dell'accounting model detail

Campi modificabili sono
* importi,
* scaglioni
* date di «End Accounting Date»
* delle varie condition actives.

**DOMANDA**
la modifica di una data puo' essere un update, ~~la modifica di un importo comporta la chiusura della regola e la creazione di una nuova~~
Se siamo in visualizzazione e' corretto poter inserire un nuovo invoice template?

### Billing-Subscription – Visualizzazione Associazione - slide 23
La sezione successiva è quella relativa alle **billing configuration** con la possibiltà di **modificare** i campi relativi a:
* Invoice Row Description
* Frequency
* Invoice recipient
* Invoice template
### Considerazioni e punti aperti slide 24
#### CONSIDERAZIONI
* VANNO CREATI DEI TEMPLATE DI ACCOUNTING CHE COMPRENDONO PIU’ ACCOUNTING MODEL, QUESTI TEMPLATE DEVONO ESSERE TIPIZZATI PER PRODOTTO, CI VA UNA FUNZIONE DI RICERCA PER PRODOTTI
* A UNA SUBSCRIPTION può essere associato a un solo TEMPLATE DI ACCOUNTING (per periodo temporale)
* TUTTE LE SOTTOSCRIZIONI APPARTENENTI A UN TEMPLATE DI ACCOUNTING DEVONO AVERE LA STESSA FATTURA

#### PUNTI APERTI
* LO STORICO. IL BILLING ENGINE LO PREVEDE? E SE SI DOVE LO METTIAMO?
* ~~POSSIBILITA’ DI MODIFICA DATI FATTURAZIONE IN VISUALIZZAZIONE => CHIEDERE A BARBARA~~
* ~~COME VIENE GESTITA LA FREQUENZA DI BILLING e DATE di inizio billing? (anche caso di associazione a regola già esistente)~~
* ~~VI SONO CASI IN CUI IL CAP è UTILIZZATO? Si, cap annuali~~
* DISASSOCIARE/DISATTIVARE REGOLA IN AUTOMATICO SE SI DISATTIVA LA FABRICKUSER/ SOTTOSCRIZIONE?
* CASISTICA affiliazione F24