[Deprecated] Offboarding
Process Overview
The offboarding process is asynchronous and involves validation of entity and the reason.
Upon successful completion of the process, a notification is sent to the partner via a webhook call:
The offboarding process supports following types of entities:
Legal entity customers
Natural person customers
Joint persons customers
proxies
beneficial owners
Regardless of the type, the sequence of actions for offboarding is similar. Partners are required to give the reason of the offboarding and then initiate the offboarding process.
Prerequisites
The partner is responsible for closing all customer products before starting the offboarding.
Statuses
The offboarding process has the following statuses:
INVALID: Process not started due to invalid data during offboarding initiation.
CREATED: Offboarding created but not yet started.
PENDING: Process started. For
Immediate
, this means offboarding execution is in progress. ForOrdinary
, the process waits for the scheduler to trigger execution two months after offboarding initiation.REJECTED: Offboarding rejected after process initiation.
CANCELED: Offboarding canceled; cancellation is only possible for
Ordinary
offboarding.APPROVED: Offboarding completed successfully.
Closure Types
There are two closure types for Offboarding: Ordinary and Immediate. The closure type is derived from thereason
field:
Ordinary:
CANCELLATION_BY_PARTNER_ORDINARY
Immediate:
CUSTOMER_REQUEST_IMMEDIATE
CANCELLATION_BY_PARTNER_IMMEDIATE
DEATH_IMMEDIATE
DISSOLUTION_IMMEDIATE
INSOLVENCY_IMMEDIATE
COMPANY_STRUCTURE_CHANGES_IMMEDIATE
Changes for Customer during process
During the offboarding process, the customer undergoes the following changes:
Temporary Status: OFFBOARDING
While the offboarding process is in progress, the customer is assigned a temporary status:
OFFBOARDING
.This status prevents any new products from being added to the customer during the offboarding process.
Cancellation Date
The cancellation date is set for the customer in the following way:
For Immediate Offboarding:
The
cancellation date
is set to the date when the offboarding process begins.
For Ordinary Offboarding:
The
cancellation date
is set to two months after the offboarding initiation date, when the process is scheduled for execution.
Process flow
Immediate:
All validations are performed immediately, and the offboarding is executed right away.
The customer's
cancellation date
is set to the date the offboarding execution begins.
Ordinary:
Initial data correctness validations are performed, excluding checks for whether all customer products are closed.
The customer's
cancellation date
is set to two months after the offboarding initiation date.The process waits for a scheduler to trigger the remaining validations and offboarding execution.
At the scheduler-triggered execution, all validations are rechecked, including verifying whether all customer products are closed.
If products aren't closed, the process remains in the
PENDING
status. Currently, process resumption isn't possible.
Validations
The offboarding process involves the following validations:
Entity Status Validation
Before proceeding with the offboarding process, the system must validate whether the entity to be offboarded has an eligible status.
The following statuses are allowed for customer offboarding:
ACTIVE
ESTATE
SUSPENDED
SUSPENDED_COMPLIANCE
The following statuses are allowed for proxy offboarding:
ACTIVE
SUSPENDED
SUSPENDED_COMPLIANCE
The following statuses are allowed for beneficial owner offboarding:
ACTIVE
SUSPENDED_COMPLIANCE
Entity Existence Validation
The system must verify whether the entity that is being offboarded exists in the database.
Offboarding Reason Validation
A valid offboarding reason must be provided for the entity being offboarded. The valid reasons are documented in the table below:
Offboarding Reason
Natural Person Customer
Joint Person Customer
Legal Entity Customer
Proxy
Beneficial Owner
CUSTOMER_REQUEST_IMMEDIATE
valid
valid
valid
valid
invalid
CANCELLATION_BY_PARTNER_IMMEDIATE
valid
valid
valid
valid
invalid
CANCELLATION_BY_PARTNER_ORDINARY
valid
valid
valid
invalid
invalid
DEATH_IMMEDIATE
valid
invalid
invalid
valid
invalid
DISSOLUTION_IMMEDIATE
invalid
invalid
valid
invalid
invalid
INSOLVENCY_IMMEDIATE
invalid
invalid
valid
invalid
invalid
COMPANY_STRUCTURE_CHANGES_IMMEDIATE
invalid
invalid
valid
valid (signatory)
valid
Custody type for left guardians related to customer of offboarded guardian
The system must verify whether the custody type for left guardians related to the customer of the offboarded guardian is set to
SINGLE_CUSTODY
.Proxy type validation
The system must verify whether the proxy type is other than
LIQUIDATOR
.Customer Products Status Validation
The system must verify whether all customer products are in status:
CANCELLED
.
If any data is invalid during the validation stage, the offboarding process will set the status:
INVALID if the process has not started.
REJECTED if the process has already started.
Last updated