Investment Obligation

Business Requirements Document (BRD)

🧩 Investment Obligation

🔖 1.0

📅 Monday, 1 December 2025

👤 Martijn Bruitsman, Peter Disselkoen

⚙️ Jasper van Noordenburg

This Epic automates the management of Investment Obligations, including the detection and handling of Collection Failures. Introducing Configurable Intervals, Retries, and Thresholds, allowing to tailor automation behavior to operational requirements. Combining automation with Full Insights for Users, the system ensures efficiency without compromising control. Users can define Failure Handling Logic, monitor Automated Actions, and intervene when necessary, achieving a balance between reliability, flexibility, and governance.

1️⃣ PURPOSE

The purpose of this Epic is to ensure accurate and efficient handling of Investment Obligations:

• Configurable Investment Obligation.
• Automatic Collection of Obligated Investment Amount.
• Collection Failure Handling.
• Manage Investment- and Payment Arrears.
• Investment- and Payment Arrear Overviews.

It provides Users full visibility of Investment- and Payment Balances and functionality to process them, while minimizing manual effort through automation. By enabling Configurable Parameters, this Epic supports different Business Rules per Label and/or Product, ensuring compliance, transparency, and operational efficiency.

2️⃣ SCOPE

Key functionalities and objectives included in the delivery of Investment Obligation.

• Create and manage Investment Obligations.
• Full insights and functionality to manage Payment- and Investment Arrears.
• Automated handling of Default Scenarios.
• Configurable Parameters for non-standard Scenarios.
• Investment Obligation cannot be combined with Periodical Buy within same Product.

3️⃣ GLOSSARY

Term	Definition
Investment Obligation	Legal or contractual duty to Invest into the Investor Account, with pre-defined conditions.
Obligated Investment Amount	Amount that is Obligated to Invest by the Investment Obligation.
User	Label Employee authorized to manage the process.
Investor	Holder of the Investor Account; cannot create or modify Investment Obligations.
Investment	Transferring Cash into the Investor Account, for Investment purposes.
Investment Arrear	Missed Investments due to Failed Collection.
Investment Arrear (Ledger)	Investor Account TO-INVEST-LEDGER holding total missed Investments.
Payment Arrear	Cash withdrawn from the Investor Account after it was invested into Assets.
Payment Arrear (Balance)	Total negative Cash balance of the Investor Account Cash Ledgers.
Reimbursement	Retry of Failed Collection.
Maximum Collection Amount	Maximum amount, including Reimbursement, collected in one Collection run.

4️⃣ BUSINESS REQUIREMENTS

GiroPro will track and manage both Investment Arrears (before processing Orders) and Payment Arrears (after processing Orders).

4️⃣1️⃣ FUNCTIONAL REQUIREMENTS

• Reversal (🇳🇱 stornering)
  • Collection is Reversed after Collection is processed.
  • Create Pro Rata Sell Order to return Cash Balance to 0. Unless overridden by Investment Obligation parameters.
  • Possibly creates Payment Arrear.
• Refusal (insufficient funds)
  • Collection could not be processed.
  • Creates Investment Arrear, and possibly Payment Arrear.
  • Buy Order is Cancelled (if not Processed yet).
• Inactive Status
  • Will Suspend Collections and creates Investment Arrear.
  • Missed Collections are not Reimbursed.
  • Maximum Collection Amount is set to 0.
• Collections only according configured Interval
  • No extra automated or manual Retries of Collections.

Within the User Interface the Users can:

• View Arrears in the applicable Ledgers.
• Allocate Manual Deposits.
• Reduce Payment Arrears.
  • Investor Account Main Cash Ledger is the Payment Arrear.
  • Manual Deposit Allocation reduces negative balance of Investor Account Main Cash Ledger.
• Create Buy Orders from Manual Deposits linked to Investment Arrear.
  • Reduces Investment Arrear.
• View all Collections, including the Status.
  • Per Label and per Investor Account.
  • Export Collections, which include Reimbursements, as SEPA Transactions.
  • Individually or in Groups.
  • SEPA Transaction Descriptions can be Manually Updated.
  • SEPA Transactions can be Cancelled and Arrears are updated through journal entries.

All Intervals, Retries, and Thresholds will be configurable by Parameters, examples include:

• RFC 5545 (RRULE) Collection Interval (e.g. weekly, monthly).
• Obligated Investment Amount (Amount that is Obligated to Invest).
• Maximum Collection Amount (Obligated Investment Amount + Reimbursement Amount).
  • Reimbursement Amount is optional.
  • Per Product and per Investor Account.
  • The Investor Account’s Value must be within the defined Product Value Range.
  • Can be less than Obligated Investment Amount, to serve custom Payment Arrangements.
  • Can be set to 0 to suspend Collections.
  • Actual Collection Amount is (TO-INVEST-LEDGER - MAIN-CASH-LEDGER) or Maximum Collection Amount.
    • the lowest of the two amounts is collected
• Thresholds (Max Failed Collections, min/max Obligated Investment Amount).
• Collection Description (e.g. text that is visible on Banking Statement).
  • Optional Variables: Investor Acccount Number, Month, Year.
• Reimbursement Description (e.g. text that is visible on Banking Statement)
  • Optional Variables: Investor Acccount Number, Month, Year, Reimbursement Amount.

4️⃣2️⃣ PERIODICITY

• Collections for Investment Obligations occur on a Configurable Interval.
  • RFC 5545 (RRULE) Collection Interval (e.g. weekly, monthly).
• Reimbursements are executed together with Regular Collections.
  • Configurable via Investor Account’s Maximum Collection Amount.
  • First Payment Arrear Ledger and then Investment Arrear Ledger is Reduced.

4️⃣3️⃣ DATA REQUIREMENTS

• Label- and Product Configuration with Investment Obligation.
• Investor Account with Investment Obligation Contraction.
• Current Investment- and Payment Arrears.
  ⚠️ Must be available through Transaction History and balances ⚠️

4️⃣4️⃣ DATA MIGRATION

• Migrate all required Label-* and *Product Configuration.
  • Data that is required for GiroPro.
• Migrate all Existing Investment Obligations per Investor Account.
• Migrate Historical- and Current Investment- and Payment Arrears.
  ⚠️ Must be available through Transaction History ⚠️

Data needs to be available in Source System and supplied with a Data Dump.

5️⃣ BUSINESS RULES

Conditions and/or logic that govern Investment Obligations.

• Reimbursements are combined with Regualar Collections.
  • The two Amounts together are one Collection.
  • Investor Account Maximum Collection Amount determines how much will be Collected.
  • This ensures full flexibility and handling of all Scenarios.
• Each Collection must use the Collection- and Reimbursements Description.
  • e.g. Mortgage Investment 11-2025.
  • e.g. Mortgage Investment 11-2025 and Reimbursment € 250.
• After Maximum Collection Retry the Investment Obligation becomes Inactive.
  • Every failed Collection increases the Retry Count of the Investor Account by 1.
  • Every successful Collection resets the Retry Count of the Investor Account to 0.
  • Every successful Collection sets the Investment Obligation to Active.
  • Maximum Collection Amount can be changed to any Amount.
  • Incoming Collections will Reduce possible Payment Arrear.
  • Automatic Buy Order Creation stops.
  • No more Creation of Payment Arrear.
  • Reimbursement first Reduce Payment Arrear and then Investment Arrear.
  • Buy Order Creation will Reduce Investment Arrear.
• Manual Deposits will Reduce Payment Arrear first and then Investment Arrear.
  • Manual Deposits are not Automatically Allocated.
  • After Manual Allocation no Automatic Order Creation.
  • Any Amount can be Manually Invested or Refunded.