When uploading instruments in bulk, the system can automatically group multiple uploaded rows into a single aggregated instrument.
This allows you to review, approve, and fund far fewer instruments, while the platform retains a complete, immutable, and auditable record of every original uploaded row.
This feature is designed for high-volume uploads where thousands of rows often represent economically similar instruments.
Product Configuration
Instrument grouping is controlled by a Product Structure setting:
“Group instruments on upload by payer, seller, currency, and original maturity date”
Disabled (default):
The system behaves exactly as today. Each valid upload row creates its own instrument.Enabled:
Valid upload rows are grouped into aggregated instruments based on defined criteria.
This setting applies per deal via its product structure.
Grouping Criteria (Exact Match)
Rows are grouped only if all of the following fields match exactly:
Payer
Seller
Currency
Original Maturity Date
If any of these fields differ, the rows are placed into separate grouped instruments.
Instrument Upload
Grouping of instruments is available upon File base upload in the system.
What Stays the Same
Upload of instruments in any template - the system will read the data as before
Column mapping
File validation
Row-level validation
For example, if you upload a file containing Instruments, like the one shown in the example, the system will behave as usual during this process. Please, note payer, seller, currency, and original maturity date are the same.
Grouped Instrument References
Instruments from the uploaded file with the same payer, seller, currency, and original maturity date will be grouped in one reference number.
Each grouped instrument receives a system-generated reference, for example:
Grouped-000001Grouped-000002
The system guarantees that:
References are globally unique
They never collide with any existing instrument reference
You will be able to review all grouped Instruments under that reference number in the Instrument Card (second image)
Workflow
Grouped Instruments will then appear under the generated single reference number within the workflow, across all approval layers enabled on the platform.
It is still possible to search using the original single-instrument reference number via the search button (see photos 2 and 3).