====== Financial Instruments — Securities & Subscriptions ======
**Section:** Financial Instruments\\
**Updated:** 2026-05-05

----

===== 1) Overview =====

The **Financial Instruments** module manages the securities (bonds, notes, structured products) issued or administered by NVG, and the corresponding investor subscriptions.

  * **Securities** — the financial instruments themselves (e.g. a bond with ISIN, interest rate, term)
  * **Subscriptions** — individual investor commitments to a specific security (who bought how many units)

> **[[ SCREENSHOT: Financial Instruments section of the sidebar — "Securities" and "Subscriptions" links ]]**

----

===== 2) Securities =====

Navigate to **Financial Instruments → Securities**.

A **Security** represents one financial product — typically a bond or note with a defined set of terms: ISIN, currency, denomination, interest rate, term, and volume.

> **[[ SCREENSHOT: Securities list page — table with columns: Name, Short Name, Type, ISIN, Interest p.a., Denom., Term, Status badge ]]**

==== Securities List ====

The list shows all securities in the system. You can:

  * **Search** by name, ISIN, or Swiss Security Number using the search box
  * **Filter** by status (Active, Closed, Cancelled, etc.)
  * **Sort** by clicking any column header (Name, Type, ISIN, Interest, Denomination, Term, Status)
  * **Open** a security by clicking its row, or click the detail icon on the right

> **[[ SCREENSHOT: Securities list — sorted by Interest p.a. descending, sort arrow visible on that column, a few rows of bond data ]]**

==== Security Detail Page ====

The security detail page is organised in three tabs:

=== Overview Tab ===

Shows all fields for the security. Click **"Modify"** (pencil icon) to enter edit mode.

| **Field** | **Description** |
| Name | Full name of the security |
| Name Short | Abbreviated name used in lists |
| Type | Product type (e.g. Bond, Note, Structured Product) |
| Status | Current lifecycle status (Active, Closed, Cancelled, etc.) |
| Active | Whether the security is currently accepting subscriptions |
| ISIN | International Securities Identification Number |
| Swiss Security Number | Swiss exchange identifier (Valor) |
| Currency | Trading currency (CHF, EUR, USD, etc.) |
| Denomination | Minimum unit size (e.g. CHF 1,000) |
| Emission Date | Date the security was first issued |
| Term | Duration of the security |
| Term Unit | Unit for the term (Years, Months) |
| Volume | Total issuance volume |
| Interest | Annual interest rate (p.a.) |
| Interest Type | Fixed or floating |
| Interest Payment Freq. | How often interest is paid (Annual, Semi-Annual, Quarterly) |
| Withholding Tax | Whether Swiss withholding tax applies |
| Description | Free-text description or notes |

> **[[ SCREENSHOT: Security detail — Overview tab showing all field values in read-only mode, "Modify" button top-right ]]**

> **[[ SCREENSHOT: Security detail in edit mode — input fields visible, Save and Cancel buttons ]]**

=== Subscriptions Tab ===

Lists all investor subscriptions for this security, showing:

  * Subscriber (partner name)
  * Subscription number
  * Date
  * Units
  * Gross amount
  * Fees
  * Net amount
  * Status badge

> **[[ SCREENSHOT: Security detail — Subscriptions tab listing investor rows with amounts and status badges ]]**

=== Files Tab ===

Links to associated document filesets for this security (online, offline, public documents, and communication sets). Clicking a fileset link opens the document management view for that fileset.

> **[[ SCREENSHOT: Security detail — Files tab showing fileset ID links ]]**

==== Creating a Security ====

  - On the Securities list, click **"New Security"**.
  - Fill in the required fields (Name, Type, Currency, ISIN, Denomination, Emission Date).
  - Set the interest terms (rate, type, frequency, withholding tax).
  - Enter the total volume.
  - Click **Save**.

> **[[ SCREENSHOT: New Security form — all fields visible, required fields marked ]]**

==== Editing a Security ====

  - Open the security detail page.
  - Click **"Modify"** (pencil/edit icon).
  - All fields become editable inline.
  - Click **"Save"** to confirm changes, or **"Cancel"** to discard.

Changes are saved immediately. The display values update in place without a page reload.

> **[[ SCREENSHOT: Security Overview tab — mid-edit, showing Save (checkmark) and Cancel (X) buttons next to the Modify button ]]**

----

===== 3) Subscriptions =====

Navigate to **Financial Instruments → Subscriptions**.

A **Subscription** records one investor's commitment to a specific security — how many units they purchased, on what date, and for what amount.

> **[[ SCREENSHOT: Subscriptions list page — table with columns: Date, Partner (investor), Security, Sub. No., Units, Gross Amount, Fees, Net Amount, Status badge ]]**

==== Subscriptions List ====

  * **Search** by partner name, subscription number, or security name
  * **Filter** by status (Pending, Active, Completed, Cancelled)
  * **Sort** by any column (Date, Partner, Security, Units, Amount, Status)

> **[[ SCREENSHOT: Subscriptions list — sorted by Date descending, filter bar visible, a few investor rows ]]**

==== Subscription Detail Page ====

Opening a subscription shows:

  * **Partner** — the investing entity (linked to Master Data)
  * **Security** — the instrument subscribed to (linked to Security detail)
  * **Subscription Number** — unique reference
  * **Subscription Date** — date the subscription was submitted
  * **Units** — number of units purchased
  * **Denomination** — unit value
  * **Gross Amount** — total before fees
  * **Fees Amount** — advisory or placement fees
  * **Net Amount** — amount received after fees
  * **Status** — current status of the subscription
  * **Notes** — any remarks

> **[[ SCREENSHOT: Subscription detail page — all fields listed, links to Partner and Security visible ]]**

==== Creating a Subscription ====

  - On the Subscriptions list, click **"New Subscription"**.
  - Select the **Partner** (investor) and the **Security**.
  - Enter the **Subscription Date**, **Units**, and **Gross Amount**.
  - Add any **Fees** if applicable.
  - Set the initial **Status**.
  - Click **Save**.

> **[[ SCREENSHOT: New Subscription form — partner selector, security selector, date, units, amount fields ]]**

==== Subscription Statuses ====

| **Status** | **Meaning** |
| Pending | Subscription received, awaiting confirmation |
| Active | Subscription is confirmed and active |
| Completed | Subscription term has ended |
| Cancelled | Subscription was cancelled |

----

===== 4) Common Tasks — Quick Reference =====

| **Task** | **Steps** |
| Find a security by ISIN | Securities list → type ISIN in search box |
| See all investors for a bond | Securities list → click security → Subscriptions tab |
| Edit a security's interest rate | Security detail → Modify → update Interest field → Save |
| Record a new investor subscription | Subscriptions list → New Subscription → fill form → Save |
| Filter subscriptions by status | Subscriptions list → Status filter dropdown → select status |
| Check total volume subscribed | Security detail → Subscriptions tab → sum of Net Amount column |