Remunerazione#
La remunerazione è la parte più sensibile ai rapporti fra campi. Prima si sceglie il modello; poi si compilano soltanto i parametri coerenti e si verifica il cashflow prodotto.
Modello di remunerazione — interest_model#
| Proprietà | Valore |
|---|---|
| Codice tecnico | interest_model |
| Nome HTML/API | interest_model / interest_model |
| Tipo | select |
| Obbligatorio nel catalogo | Sì |
| Categoria | remuneration |
Significato. Famiglia di remunerazione: fixed, zero_coupon, floating, inflation o step.
Dipendenze ed effetti. Governa quali campi diventano rilevanti e il calcolo dei cashflow. Il cambio di modello impatta documenti, pricing e servicing.
Esempio. floating per indice più spread.
Errore frequente. Compilare contemporaneamente campi di più modelli senza chiarire quale prevale.
Frequenza — frequency#
| Proprietà | Valore |
|---|---|
| Codice tecnico | frequency |
| Nome HTML/API | frequency / frequency |
| Tipo | select |
| Obbligatorio nel catalogo | Sì |
| Categoria | remuneration |
Significato. Frequenza delle cedole: annual, semiannual, quarterly, monthly o none.
Dipendenze ed effetti. Determina la periodicità dei cashflow. none è normalmente coerente con zero coupon.
Esempio. semiannual per due cedole annue.
Errore frequente. Usare none per un titolo a tasso fisso con cedole dovute.
Tasso fisso % — fixed_rate#
| Proprietà | Valore |
|---|---|
| Codice tecnico | fixed_rate |
| Nome HTML/API | fixed_rate / fixed_rate |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Tasso cedolare fisso inserito in percentuale nella WebUI.
Dipendenze ed effetti. È richiesto e deve essere positivo per interest_model=fixed. Nel payload viene normalizzato in forma decimale.
Esempio. Digitare 4.2 per 4,20%, non 0.042.
Errore frequente. Confondere percentuale UI e valore decimale del payload.
Indice di riferimento — reference_index#
| Proprietà | Valore |
|---|---|
| Codice tecnico | reference_index |
| Nome HTML/API | reference_index / reference_index |
| Tipo | text |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Codice dell’indice per tasso variabile o inflazione.
Dipendenze ed effetti. È obbligatorio per floating e inflation; deve avere fonte, fixing, fallback e calendario coerenti.
Esempio. EURIBOR_3M o HICP_EX_TOBACCO.
Errore frequente. Usare un’etichetta libera non riconosciuta dal provider dati.
Spread % — spread#
| Proprietà | Valore |
|---|---|
| Codice tecnico | spread |
| Nome HTML/API | spread / spread |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Margine aggiunto all’indice, inserito in percentuale.
Dipendenze ed effetti. Rilevante per il tasso variabile. Entra nel calcolo cedola dopo l’acquisizione del fixing.
Esempio. 1.50 per 150 basis point.
Errore frequente. Inserire 150 pensando ai basis point senza conversione.
Tasso fallback % — fallback_rate#
| Proprietà | Valore |
|---|---|
| Codice tecnico | fallback_rate |
| Nome HTML/API | fallback_rate / fallback_rate |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Tasso utilizzabile secondo la clausola di fallback quando l’indice non è disponibile.
Dipendenze ed effetti. Deve essere coerente con la documentazione e non viene applicato arbitrariamente dall’operatore. Influenza continuità del calcolo e servicing.
Esempio. 2.00 se il contratto prevede 2%.
Errore frequente. Usarlo come stima ordinaria dell’indice anziché come fallback contrattuale.
Indice base — base_index_value#
| Proprietà | Valore |
|---|---|
| Codice tecnico | base_index_value |
| Nome HTML/API | base_index_value / base_index_value |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Valore base dell’indice di inflazione usato per calcolare il rapporto di indicizzazione.
Dipendenze ed effetti. Per inflation deve essere positivo e riferito alla data/lag definita. Incide su cedola e/o capitale.
Esempio. 100.0000.
Errore frequente. Inserire un tasso percentuale invece del livello dell’indice.
Tasso reale % — real_rate#
| Proprietà | Valore |
|---|---|
| Codice tecnico | real_rate |
| Nome HTML/API | real_rate / real_rate |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Tasso reale di uno strumento indicizzato all’inflazione, inserito in percentuale.
Dipendenze ed effetti. Si combina con il rapporto indice secondo il modello. Deve essere distinto dall’inflazione stimata usata solo per proiezioni.
Esempio. 1.00 per 1% reale.
Errore frequente. Sommare manualmente inflazione attesa e tasso reale nel campo.
Inflazione stimata % — assumed_inflation#
| Proprietà | Valore |
|---|---|
| Codice tecnico | assumed_inflation |
| Nome HTML/API | assumed_inflation / assumed_inflation |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Ipotesi di inflazione usata per anteprime o scenari quando i fixing futuri non esistono.
Dipendenze ed effetti. Non è un termine pagabile se il contratto usa fixing reali. Deve essere chiaramente qualificata come assunzione.
Esempio. 2.00 per una proiezione al 2%.
Errore frequente. Presentare il cashflow proiettato come importo certo.
Floor rapporto indice — index_floor#
| Proprietà | Valore |
|---|---|
| Codice tecnico | index_floor |
| Nome HTML/API | index_floor / index_floor |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Floor applicato al rapporto di indicizzazione.
Dipendenze ed effetti. Tipicamente 1.0 impedisce che l’indicizzazione riduca sotto il valore base, se previsto dal contratto. Incide su capitale/cedola secondo i flag.
Esempio. 1.0.
Errore frequente. Inserire 100 pensando a una percentuale.
Day count — day_count#
| Proprietà | Valore |
|---|---|
| Codice tecnico | day_count |
| Nome HTML/API | day_count / day_count |
| Tipo | select |
| Obbligatorio nel catalogo | Sì |
| Categoria | remuneration |
Significato. Convenzione di conteggio giorni: ACT/360, ACT/365 o 30E/360.
Dipendenze ed effetti. Influenza la frazione di periodo e l’importo cedolare. Deve coincidere con i documenti.
Esempio. ACT/365.
Errore frequente. Scegliere la convenzione predefinita senza confrontarla con il term sheet.
Business day convention — business_day_convention#
| Proprietà | Valore |
|---|---|
| Codice tecnico | business_day_convention |
| Nome HTML/API | business_day_convention / business_day_convention |
| Tipo | select |
| Obbligatorio nel catalogo | Sì |
| Categoria | remuneration |
Significato. Regola di aggiustamento delle date non lavorative: following, modified_following o preceding.
Dipendenze ed effetti. Modifica le payment date operative. Il calendario applicabile deve essere definito nella documentazione anche se non è un campo separato nella baseline.
Esempio. modified_following.
Errore frequente. Confondere aggiustamento della data con modifica del periodo di accrual.
Indicizza cedola — index_coupon#
| Proprietà | Valore |
|---|---|
| Codice tecnico | index_coupon |
| Nome HTML/API | index_coupon / index_coupon |
| Tipo | checkbox |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Indica che il rapporto indice influenza la cedola.
Dipendenze ed effetti. Rilevante per inflation. Può essere attivo insieme o separatamente da index_principal secondo il contratto.
Esempio. Attivo quando la cedola reale è rivalutata.
Errore frequente. Attivarlo su un tasso variabile ordinario, dove l’indice è già gestito da reference_index.
Indicizza capitale — index_principal#
| Proprietà | Valore |
|---|---|
| Codice tecnico | index_principal |
| Nome HTML/API | index_principal / index_principal |
| Tipo | checkbox |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Indica che il rapporto indice influenza il capitale rimborsato.
Dipendenze ed effetti. Rilevante per strumenti inflation-linked. Incide sul rimborso e sulle obbligazioni di servicing.
Esempio. Attivo per capitale rivalutato con floor.
Errore frequente. Dimenticare l’impatto sul nominale/rimborso finale e sul pricing.
Step 1 data — step1_date#
| Proprietà | Valore |
|---|---|
| Codice tecnico | step1_date |
| Nome HTML/API | step1_date / step1_date |
| Tipo | date |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Data dalla quale entra in vigore il primo nuovo tasso di una struttura step.
Dipendenze ed effetti. Deve essere nel periodo di vita, ordinata rispetto agli altri step e accompagnata da step1_rate.
Esempio. 2029-03-15.
Errore frequente. Inserire una data precedente all’emissione o successiva alla scadenza.
Step 1 tasso % — step1_rate#
| Proprietà | Valore |
|---|---|
| Codice tecnico | step1_rate |
| Nome HTML/API | step1_rate / step1_rate |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Tasso applicabile dal primo step, in percentuale nella WebUI.
Dipendenze ed effetti. È utilizzato soltanto se step1_date è valorizzata e interest_model=step.
Esempio. 4.50.
Errore frequente. Compilare il tasso senza la data o viceversa.
Step 2 data — step2_date#
| Proprietà | Valore |
|---|---|
| Codice tecnico | step2_date |
| Nome HTML/API | step2_date / step2_date |
| Tipo | date |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Data del secondo step di remunerazione.
Dipendenze ed effetti. Deve essere successiva a step1_date, entro la scadenza e accompagnata da step2_rate.
Esempio. 2030-03-15.
Errore frequente. Invertire la sequenza degli step.
Step 2 tasso % — step2_rate#
| Proprietà | Valore |
|---|---|
| Codice tecnico | step2_rate |
| Nome HTML/API | step2_rate / step2_rate |
| Tipo | number |
| Obbligatorio nel catalogo | No / condizionale |
| Categoria | remuneration |
Significato. Tasso applicabile dal secondo step, in percentuale.
Dipendenze ed effetti. Completa il secondo elemento della struttura step. Il modello corrente supporta due step UI, mentre strutture più ricche richiedono estensione.
Esempio. 5.00.
Errore frequente. Usarlo per una penalità condizionata senza modellare la condizione/covenant che la attiva.
