This version introduces a new AML data model and an AML Matter Banner for at‑a‑glance status and actions. It also adds a validation to bank reconciliation finalisation to prevent transactions reappearing when earlier draft reconciliations exist.
- New matters opened after the commencement date will need to comply with AML requirements.
- Existing matters that are still active may also require AML checks if the designated service hasnot yet been completed and the work continues after the commencement date.
- Closed or completed matters before the commencement date would generally not require retrospective AML checks.
NEW FEATURES
AML Data Model
Matters now have fields to support anti-money laundering tracking: whether AML is required, overall status
and risk, the compliance decision (including approval with conditions), and who recorded the decision. The
matter stays AML locked until the matter AML status is Cleared. Each party also has an AML check status
so you can record verification progress per party involved in the matter.
New Account fields
These fields are intended to be populated by AML integration packages or custom automation; they are
included on the Nebulaw permission set for read/edit access.
New Matter and org settings fields
Validation rule — AMLNotRequiredReason
When AML Checks Enforced is enabled in General Settings and a Matter has AML Required unchecked,
a reason must be provided in AML Not Required Reason. Error message: "A reason needs to be provided
if AML is not required for this Matter".
Field history tracking
The following fields now track field history (previously untracked):
- Matter__c.AMLStatus__c
- Matter__c.IsAMLRequired__c
|
AML Checks Enforced Custom Settings There is a new option under NebuLAW General Settings to determine whether AML checks are enforced in the organisation. This is turned off by default and will need to be enabled in organisations that need to adopt the AML functions. For detailed setup instructions, please refer to Unity Search AML Integration User Guide and Legl AML Integration User Guide. |
AML Banner Display
Matters now have fields to support anti-money laundering tracking: whether AML is required, overall status
and risk, the compliance decision (including approval with conditions), and who recorded the decision. The
matter stays AML locked until the matter AML status is Cleared. Each party also has an AML check status
so you can record verification progress per party involved in the matter.
A new lightning component called AML Matter Banner is now available to be included in Matter Lightning
Record Pages which provides a high-level, heads up view of the Matterʼs AML status and any actionable
items for the Fee Earner.
Placement
- Exposed for Matter__c record pages via Lightning App Builder.
- Not pre-placed on a packaged flexipage — add the Matter AML Banner component to your Matter
Lightning record page(s) after upgrade.
Banner display
- AML Status — interactive status button with colour-coded styling (warning, neutral, success).
- Risk — displays the Matter risk rating, with a warning icon when risk is High.
Status popover
Hovering, clicking, or focusing the AML Status button opens a contextual popover (via the new
nebulawPopover component) with scenario-specific messaging:
| Scenario | Trigger | Popover tone | Key message |
| Review required | Matter AML Status is Review required | Warning | Shows count of Parties requiring AML review; matter cannot proceed to settlement until review is complete |
| Not started | Matter AML Status is Not started | Neutral | AML requirements have not been started |
| In progress | Matter AML Status is In progress | Neutral | AML requirements have not been met |
| Approved | Status Cleared + Decision Approved with conditions | Success | Matter can proceed to settlement; shows decision notes, date, and decision maker |
| Approved with conditions | Status Cleared + Decision Approved with conditions | Success | Matter can proceed if conditions are met; shows decision details |
Popover actions
-
Edit Details — opens a modal to update AML Status, Risk, and (when status is Cleared) Decision,
Decision By, Decision Date, and Decision Notes. - Review Parties / View Parties — navigates to the Matter's related Parties list.
- Decision Details — read-only modal for cleared Matters showing full decision information.
Party awareness
The banner queries related Parties (up to 1,999) and counts those whose AML Check Status contains
Review required, feeding the review-required scenario summary.
Technical notes
- API version 65.0.
- Uses lightning/uiRecordApi , lightning/uiRelatedListApi , and existing nebulawModal
for edit/view dialogs. - nebulawModal enhanced with contentOverflowVisible so picklist dropdowns are not clipped in
the edit modal.
BUG FIXES
Adding a validation to Bank Reconciliation process
Added validation to Bank Reconciliation finalisation to prevent transactions from reappearing in future
reconciliations when linked to unresolved draft reconciliations for the same bank account. The system now
checks the transactionʼs “First Seen” reconciliation and, if the related reconciliation is still in Draft status,
prevents finalisation and prompts the user to either finalise or remove the earlier draft before proceeding.
Implement string truncation for Conflict Check Technical Details
Implemented truncation for Conflict Check Technical Details and Party Results to prevent the “String too
long” error during conflict checks. The complete conflict check information is still stored in the Conflict
Check Details object, allowing users to view the full details if the Technical Details or Party Results are
truncated due to character limits.
Time Item Rates Not Applied to Time Entries Created via Tardis
Implemented a fix to ensure that Time Entries created via Tardis correctly apply the configured Time Item
rate, enabling accurate billing and consistent behavior across all Time Entry creation methods in Unity
PMS.
PERMISSIONS
The Nebulaw permission set (Nebulaw) grants read/edit access to new and updated AML fields:
Account
- AMLProviderReference__c
- IDVerificationStatus__c
- IDVerificationTimestamp__c
- LastScreenedDate__c
- PEPSanctionsScreeningStatus__c
- RiskRating__c
Matter
- AMLNotRequiredReason__c
- (Existing AML fields — AMLStatus__c , AMLDecision__c , AMLRisk__c , IsAMLRequired__c ,
IsAMLLocked__c — remain included)
Party
- AMLCheckStatus__c
Assign the Nebulaw permission set for users who manage AML on Matters, Parties, or Accounts.
| Note: GeneralSettings_ _c.AMLChecksEnforced_ _c is a hierarchy custom setting field. Ensure administrators who configure AML enforcement have access to General Settings (typically via existing admin profiles or custom setting visibility). |
CONFIGURATION CHECKLIST
-
Matter record page — in Lightning App Builder, add the Matter AML Banner component to Matter
record page(s). Place it prominently (e.g. above detail tabs or in the highlights panel region). -
General Settings — review AML Checks Enforced:
- Leave off (default) to allow Matters to be marked as not requiring AML without a documented reason.
- Enable when your firm requires a written exemption reason whenever AML Required is unchecked.
- Permissions — refresh the Nebulaw permission set assignment for AML-related users.
-
Layouts — verify the updated Matter and Party layouts are assigned to the appropriate record
types/profiles, or merge the new AML sections into custom layouts. -
AML provider integration — if using an AML extension package, map provider responses to the new
Account screening fields ( IDVerificationStatus_ _c , PEPSanctionsScreeningStatus_ _c ,
etc.). -
Bank reconciliation — if users encounter the pending-draft error when finalising, finalise or delete the
earlier draft reconciliation referenced by affected cashbook entries before retrying.
UPGRADE/COMPATIBILITY NOTES
| Item | Detail |
| Ancestor version | 6.2.0 (per sfdx-project.json) |
| Default behaviour | AMLChecksEnforced__c defaults to off — existing Matters are unaffected until enforcement is enabled |
| Bank rec finalisation | Stricter validation may surface previously hidden data issues where cashbook entries reference unfinalised draft reconciliations |
| Manual page setup | The AML Banner component is packaged but not auto-placed — a post-upgrade Lightning App Builder step is required |
FULL DATA MODEL CHANGES
This section lists all NebuLAW Core (nebulaw) schema changes since 6.0.0 (git tag Nebulaw-6.0.0-2). Subscribers upgrading directly to 6.3.0 receive these changes in a single install. Extension packages are out of scope. For AML field semantics, relationships, and rollup behaviour, see the AML data model technical reference.
New custom objects
Credit Notes (6.1)
| API name | Label |
| CreditNote_ _c | Credit Note |
| CreditNoteLineItem_ _c | Credit Note Line Item |
| CreditNoteApplication_ _c | Credit Note Application |
Multi-Client Wizard (6.1)
| API name | Label |
| AccountGroupMembership_ _c | Account Group Membership |
AML compliance platform (6.1 foundation + 6.3)
| API name | Label |
| AMLCheck_ _c | AML Check |
| BeneficialOwner_ _c | Beneficial Owner |
| RiskAssessment_ _c | Risk Assessment |
| AmlAuditEvent_ _c | AML Audit Event |
| SourceOfFunds_ _c | Source of Funds |
These objects store CDD check detail, beneficial owner registers, risk assessments, audit events, and source-of-funds evidence. Field-level definitions are documented in the AML data model.
New fields on existing objects
Account
- RiskRating__c — Risk Rating
- AMLProviderReference__c — AML Provider Reference
- IDVerificationStatus__c — ID Verification Status
- IDVerificationTimestamp__c — ID Verification Timestamp
- PEPSanctionsScreeningStatus__c — PEP/Sanctions Screening Status
- LastScreenedDate__c — Last Screened Date
- New record type: Multi-Party Client ( MultiPartyClient )
Matter
- IsAMLRequired__c — AML Required
- AMLNotRequiredReason__c — AML Not Required Reason
- AMLStatus__c — AML Status
- AMLRisk__c — AML Risk
- AMLDecision__c — AML Decision
- DecisionById__c — Decision By
- DecisionDate__c — Decision Date
- DecisionNotes__c — Decision Notes
- IsAMLLocked__c — AML Locked
- AutoCreateParties__c — Auto Create Parties
Party
- AMLCheckStatus__c — AML Check Status
- AccountRisk__c — Account Risk
- FromMatterWizard__c — From Matter Wizard
General Settings
- AMLProvider__c — AML Provider
- AMLCheckValidityMonths__c — AML Check Validity Months
- AMLChecksEnforced__c — AML Checks Enforced
- AMLReviewEnforced__c — AML Review Enforced
- AmlAllowSelfReview__c — Allow AML Self-Review
Automation Bypass
- AMLCheckTrigger__c — AML Check Trigger
- RiskAssessmentTrigger__c — Risk Assessment Trigger
Release Note Entry (custom metadata type)
- DisplayOrder__c — Display Order
- EntryType__c — Entry Type
Added to the pre-existing ReleaseNoteEntry_ _mdt type to support grouped release note cards in the hub.
Custom metadata types
Four new AML configuration types ship with seeded records that should be reviewed after install (see AML compliance rollout):
- AmlApplicabilityRule__mdt — AML Applicability Rule (matter-type AML applicability)
- AmlCddRoleRule__mdt — AML CDD Role Rule (party role to CDD requirement mapping)
- AmlEnhancedCddItem__mdt — AML Enhanced CDD Item (enhanced CDD checklist items)
-
RiskAssessmentRequirement__mdt — Risk Assessment Requirement (matter-type risk
assessment gates)
Global value sets
Eight new global value sets support AML picklists and can be extended in future package upgrades:
- AMLProvider — AML integration provider (Legl, easyAML, realAML, Manual)
- AMLCheckType — CDD check types (Identity, PEP/Sanctions, SOF, UBO, and others)
- AMLCheckStatus — Check lifecycle status values
- AMLResultSummary — Provider result summary vocabulary
- AmlAuditEventType — AML audit event categories
- AmlCddRequirement — CDD requirement levels for role rules
- RiskAssessmentScope — Client or Matter assessment scope
- RiskAssessmentStatus — Risk assessment lifecycle status values
Modified fields and terminology
- Party__c.Role__c — field history tracking enabled.
- Matter__c.AMLStatus__c — picklist value Cleared is deactivated; Completed is the new
terminal value. Existing matters with Cleared are not migrated automatically. Update these records to
Completed before enabling AML enforcement if your org used the legacy value.
Validation rules
Three new validation rules are included:
- AMLCheck__c.SubjectRequired — requires an Account or Contact on each AML Check
- RiskAssessment__c.SubjectRequired — requires an Account or Contact on each Risk
Assessment - Matter__c.AMLNotRequiredReason — requires a reason when AML is not required and
AMLChecksEnforced__c is enabled
PERMISSION AND FIELD-LEVEL SECURITY
New objects and fields are not visible to users until object permissions, field-level security (FLS), and (for AML) custom permissions are granted. If users rely on custom permission sets, permission set groups, or profile-based access instead, you must update those assignments manually.
Use the shipped permission sets as reference templates in Setup → Permission Sets when determining
what to grant.
| Feature area | Shipped permission set / permission set group | What must be granted |
| Credit Notes | Nebulaw | Create/read/edit on CreditNote_ _c , CreditNoteLineItem_ _c , and CreditNoteApplication_ _c , plus FLS on all credit note fields listed above |
| Multi-Client Wizard | Nebulaw | Create/read/edit/delete on AccountGroupMembership_ _c ; FLS on Matter_ _c.AutoCreateParties_ _c , Party_ _c.FromMatterWizard_ _c , andParty_ _c.AccountRisk_ _c ; Multi-Party Client record type access on Account; Apex class access to MatterCreateWizardLC |
| AML CDD and evidence | NebulawAmlCore | Object access and FLS on all AML custom objects and new Matter, Party, and Account fields listed above; read access to AmlApplicabilityRule_ _mdt , AmlCddRoleRule_ _mdt , and AmlEnhancedCddItem_ _mdt ; custom permission AmlConductCdd (required for recording CDD, beneficial owners, and manual risk assessments) |
| AML review and matter clearance | NebulawAmlComplianceOfficer (includes Core) | Everything in NebulawAmlCore, plus edit FLS on AML Check and Risk Assessment review fields, Matter AML decision fields ( AMLDecision_ _c , DecisionById_ _c , DecisionDate_ _c , DecisionNotes_ _c ), and custom permissions AmlReviewChecks and AmlClearMatter |
| AML MLRO escalations | NebulawAmlMlro (add to Compliance Officer group) | Addiitonal edit FLS on check and risk assessment supersession and manual override fields; custom permission AmlMlroEscalation |
| Release notes hub (optional) | HubTasksViewer, HubTasksOperations | Read access to hub task status objects; HubTasksOperations also grants ManageHubTasks for checklist task completion |
Notes for custom access models:
- Nebulaw alone does not grant AML object or Matter/Party AML field access. Firms adopting AML
must grant NebulawAmlCore (directly or by replicating its object, field, and custom permission
entries). -
AML UI actions are gated by custom permissions, not FLS alone. Users without AmlConductCdd
cannot initiate manual CDD; users without AmlReviewChecks or AmlClearMatter cannot complete
reviews or clear matters via the AML Banner. -
Segregation of duties: In NebulawAmlCore , Matter AMLDecision_ _c and decision metadata fields
are read-only; NebulawAmlComplianceOfficer grants edit access. Replicate this split if compliance
staff must clear matters but fee earners must not. -
General Settings AML fields ( AMLProvider_ _c , AMLChecksEnforced_ _c , and others) are orgwide hierarchy custom settings — configure via admin profiles or your existing General Settings access
model, not via the AML permission sets. - AutomationBypass_ _c AML trigger bypass fields are intended for migration administrators only.