Identità, capitale e calendario#
Questi campi definiscono l’identità economica primaria dello strumento: nome, valuta, ammontare, taglio, prezzo contrattuale e date. Sono alla base di unità, cashflow, collocamento e registro.
Codice breve — short_code#
| Proprietà | Valore |
|---|---|
| Codice tecnico | short_code |
| Nome HTML/API | short_code / short_code |
| Tipo | text |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Codice breve, leggibile e stabile usato nelle interfacce e nei riferimenti operativi.
Dipendenze ed effetti. Non sostituisce ISIN o instrument ID. Entra in schede, file e ricerche; deve evitare collisioni e caratteri ambigui.
Esempio. ALFA-2031-FIX.
Errore frequente. Cambiarlo a ogni revisione o usarlo come titolo legale completo.
Denominazione dello strumento — instrument_name#
| Proprietà | Valore |
|---|---|
| Codice tecnico | instrument_name |
| Nome HTML/API | instrument_name / instrument_name |
| Tipo | text |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Denominazione estesa dello strumento.
Dipendenze ed effetti. Compare nel dossier, Master Record ed Exchange. Deve distinguere chiaramente emittente, remunerazione e scadenza quando utile.
Esempio. Industria Alfa 4,20% 2031.
Errore frequente. Usare un nome promozionale che non consente di riconoscere lo strumento.
Valuta — currency#
| Proprietà | Valore |
|---|---|
| Codice tecnico | currency |
| Nome HTML/API | currency / currency |
| Tipo | select |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Valuta del nominale e, salvo regole specifiche, dei flussi contrattuali.
Dipendenze ed effetti. Condiziona importi, conti, cash settlement, pricing e servicing. La baseline usa tipicamente codici ISO come EUR.
Esempio. EUR.
Errore frequente. Confondere valuta del titolo con valuta del conto dell’investitore o usare simboli come €.
Nominale totale — total_nominal#
| Proprietà | Valore |
|---|---|
| Codice tecnico | total_nominal |
| Nome HTML/API | total_nominal / total_nominal |
| Tipo | number |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Ammontare nominale massimo/emesso previsto della definizione.
Dipendenze ed effetti. Deve essere positivo e multiplo di denomination. Alimenta unità, collocamento, posizioni e cashflow.
Esempio. 5000000 per EUR 5 milioni.
Errore frequente. Inserire il controvalore cash o un importo con separatori non compatibili.
Taglio minimo — denomination#
| Proprietà | Valore |
|---|---|
| Codice tecnico | denomination |
| Nome HTML/API | denomination / denomination |
| Tipo | number |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Taglio unitario/minimo di nominale con cui lo strumento è rappresentato.
Dipendenze ed effetti. Il totale deve esserne multiplo. Influenza unità di registro, sottoscrizioni, trasferimenti e mirror esterni.
Esempio. 1000.
Errore frequente. Confonderlo con la sottoscrizione minima, che può essere più alta.
Prezzo contrattuale di emissione per 100 — issue_price#
| Proprietà | Valore |
|---|---|
| Codice tecnico | issue_price |
| Nome HTML/API | issue_price / issue_price |
| Tipo | number |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Prezzo contrattuale di emissione espresso per 100 di nominale.
Dipendenze ed effetti. È distinto dal prezzo di collocamento initial_price e dal rimborso redemption_price. Una differenza genera warning e deve essere intenzionale.
Esempio. 100.00 oppure 92.40 per uno zero coupon.
Errore frequente. Inserire 1.00 pensando a un fattore decimale anziché un prezzo per 100.
Data di emissione prevista — issue_date#
| Proprietà | Valore |
|---|---|
| Codice tecnico | issue_date |
| Nome HTML/API | issue_date / issue_date |
| Tipo | date |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Data prevista/contrattuale di emissione.
Dipendenze ed effetti. Deve precedere maturity_date; guida calendario, cashflow e settlement iniziale. Se cambia materialmente occorre una nuova versione.
Esempio. 2027-03-15.
Errore frequente. Usare la data di apertura del collocamento o una data passata incoerente.
Scadenza — maturity_date#
| Proprietà | Valore |
|---|---|
| Codice tecnico | maturity_date |
| Nome HTML/API | maturity_date / maturity_date |
| Tipo | date |
| Obbligatorio nel catalogo | Sì |
| Categoria | identity |
Significato. Data di scadenza legale dello strumento.
Dipendenze ed effetti. Deve essere successiva all’emissione. Determina l’ultimo periodo, il rimborso e gli eventi finali.
Esempio. 2031-03-15.
Errore frequente. Usare l’expected maturity al posto della legal final maturity senza distinguerle.
