In order to conduct AML and CMI through a third-party tool from ShareDo, you will first need to configure a provider. Below are the instructions for configuring Legl as a provider for KYC and KYB Checks.
| Acronym | Full Wording |
|---|---|
| AML | Anti-Money Laundering |
| CMI | Client Matter Inception |
| KYC | Know Your Customer |
| KYB | Know Your Business |
To install Legl in your ShareDo environment, contact your CSM, and we will handle the installation.
Legl API Specification
For more information on Legl's API's and API Authentication, please check out their API Specification documentation.
Before beginning this integration, we would recommend that you do the following:
- Confirm that you have access to the Legl Dashboard on both your sandbox and your production accounts, ideally with administrative access so that you can create other users.
- Configure a couple of Legl KYC workflows, including the type of checks you might wish to run. Give them sensible names and ensure they are consistent across your sandbox and production accounts.
- Reach out to Legl support and ask them to provide you with the URLs of these Legl workflows for each of your sandbox and production accounts.
- Confirm that you have an API Key for each of your sandbox and production accounts.
Configuring the Legl Global Feature
Within Modeller > Global Features, look for the following feature:
First, ensure that Enabled is checked for the feature.
Fill in the fields using this guidance:
| Field | Value |
|---|---|
| Linked service system name: | legl |
| URL for Legl workflow to be used creating a KYC: |
This is the fallback workflow URL to use if a specific workflow hasn't been provided. See more details below. |
| Send reminder email in X days if not completed: | The default number of days after which to send a reminder if a KYC hasn't been completed. |
You can ask Legl for the URL of a specific workflow, and they will be able to provide it to you. Alternatively, if you are comfortable using an API Tool, such as Postman or Insomnia, you can get the list of URLs yourself.
To do this, send a GET request to https://api.sandbox.legl.com/v1/workflows/
As shown in this screenshot from a Postman call to the API above, a number of workflows have been returned from our Postman account. The ‘name’ field should provide enough information to help you identify what you need, but if not, you can also see the ‘steps’ included in each Legl workflow.
Then, the URL field is the one you want to copy and paste.
Warning
Please note that when you export your configuration to use in a different environment, these URLs will change if you are switching between your Legl sandbox account and your Legl production account. You will need to update them.
Configuring the Legl Linked Service
Navigate to Admin > Integrations > Manage Linked Services.
If one doesn't already exist, you will need to create a new Linked Service. Click the Add New button at the top right.
Next, you will need to choose Shared Secret as the integration type.
Then populate the fields as follows:
| Field | Value |
|---|---|
| System Name | legl - this should match the ‘Linked Service System Name’ field from the Global Feature. |
| Name | Legl - CMI and AML Provider. |
| Icon | Your choice - we would recommend - 'fa-address-book' |
| Description | Your choice - Enter something to describe the service. |
| Secret | This is the API Key provided to you by Legl. |
| Allow fallback to system secret? | On |
| API base URL | https://api.sandbox.legl.com/v1 |
| HTTP Header to send token in | Authorization |
| HTTP Header prefix | Token |
After completing the above, Save and Close the Edit Service blade, and then force reload the ShareDo configuration. 
Providing Legl with Webhook URLs
The last step you need to take to complete installation and authentication is to provide Legl with the webhooks to callback to ShareDo when there is an update on a given engagement.
NOTE: You will need to do this for EACH environment you want to configure Legl with. It is recommended that you link a single Legl instance with a single ShareDo instance.
Although theoretically, a single Legl environment can link to multiple environments, this can cause noise and make it difficult to troubleshoot any issues that arise.
The Webhook URLs you will need to provide to Legl are the following:
KYC Endpoints
| ShareDo Endpoint | Associated Legl Event |
|---|---|
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyc/submitted/dataloading/startimport | engage_request_submitted |
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyc/ready/dataloading/startimport | engage_request_ready_for_review |
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyc/reviewed/dataloading/startimport | engage_request_reviewed |
KYB Endpoints
| ShareDo Endpoint | Associated Legl Event |
|---|---|
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyb/companyreport/dataloading/startimport | company_report_created |
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyb/sanctionsreportready/dataloading/startimport | business_sanctions_ready_for_review |
| https://some_shardeo_site/api/sharedo/FinanceLegl/kyb/sanctionsreportreviewed/dataloading/startimport | business_sanctions_reviewed |
For all of the above endpoints, replace some_sharedo_site with the domain for your ShareDo environment, for example, if your ShareDo URL was https://acme-law.sharedo.co.uk, then the engage_request_submitted URL would become:
https://acme-law.sharedo.co.uk/api/sharedo/FinanceLegl/kyc/submitted/dataloading/startimportReach out to Legl support and ask them to apply the ShareDo Webhook Event URLs for your account.
Congratulations Legl is now Installed and configured on your ShareDo environment.
What you get
As part of this installation, you will now have the following:
13 Legl Workflow Blocks
These can perform actions against the Legl platform; they are straightforward and do exactly what they say in the description (the Italic line underneath).
6 Legl Events / Webhooks
These listen for updates from Legl being posted back to ShareDo.
Build vs Off the Shelf
A simple example of how a KYC check progresses from creation, through the Legl system, out to the customer, back to Legl for processing, and then to a Fee Earner for review.
A simple example of a KYB check progresses from creation, through the Legl system, creates reports, requests review, and returns files to ShareDo.
ShareDo has put together an out-of-the-box config pack which you can install in your environment. This pack conducts a basic KYC/KYB, and returns the results/documents.
Checking Reports
It is possible to mark any KYC report as reviewed from within the ShareDo system using the Mark as Reviewed workflow block. However any KYC that doesn't return a ‘clear’ result should be examined in Legl.
Regarding KYB reports, due to the complex nature of the data reported back in sanctions checks, a user is required to check KYB sanctions reports directly in Legl.
In any case, the KYC/KYB report output PDFs can be downloaded to your DMS.
If you wish to build your own Legl configuration in ShareDo, please be aware that you will need to replicate, at minimum:
- Form Builder Definitions
- Notifications Types
- Option Sets
- Teams
- Work Type Definitions
- Workflows
ShareDo's Accelerator for Legl also includes some permissions, business rules, allocation rules, and a few other tweaks.