WC1: secondary field matching
When searching (call to /cases/{caseSystemId}/results) a Vessel by name and IMO (secondary field):
- does the "matchingStrength" field only apply to the name search? It seems to me that when searching with a wrong IMO, the strength may still be "EXACT"
- is there a way to search by IMO only?
- is there a way to return the IMO when not present in the search fields? (currently I use a placeholder IMO - 0000.. - to force the API to return the IMO value)
Thank you!
Best Answer
-
Please find the answer to your questions below:
1. Yes, the matchingStrength applies only to the entity name being sent to the WC1 API. IMO number is a secondary field identifier and is only used to auto resolve the matches of the screened entities.
2. No, passing the name of the entity(vessel) is a must for the screening request to be successful. Otherwise you will get a 404 bad request.
3. Even if you do not send the IMO # in your screening request, the WC result and WC profile will still display the IMO number in it, if we have that information in our DB. As said before, the IMO number being send over is a secondary identifier which helps the system auto resolve the matches automatically.
For example: Let say: You screened the vessel name "Squamish" with the IMO # 45678 (secondary identifier)- there will be 1 match. The match will be auto resolved as there is a IMO # mismatch with the IMO # number in the DB and the matchingStrength will be "EXACT".
If you screen just "Sqamish" with out the IMO number, you will see the match is unresolved and the IMO number will still be in the JSON response of sync screening/WC profile for your reference and investigation.
0
Answers
-
@Irfan.Khan, thank you for your reply.
However, for the third point, I am not able to obtain the described result when searching. I do obtain the IMO when I get the profile from "/reference/profile/{referenceId}", but not when I get the search results. Is there something missing from my steps?
1. Post to "/cases" using the body:
{
"entityType": "VESSEL",
"groupId":"{{group-id}}",
"providerTypes": [
"WATCHLIST"
],
"name": "Squamish",
"customFields":[],
"secondaryFields":[]
}results in a CaseData with an empty "secondaryFields" value (this is true even if I don't include "secondaryFields" in the input body).
2. Post to "/cases/{caseSystemId}/screeningRequest"
3. Cycle until Post to "/cases/{caseSystemId}/auditEvents" indicates "COMPLETED"
4. Get to "/cases/{caseSystemId}/results" to get results, which produces an empty "secondaryFields" list:
[
{
"resultId": "0a3687cf-69ca-1d06-9a77-5d35005f1156","referenceId": "e_tr_wcv_1328634","matchStrength": "EXACT","matchedTerm": "SQUAMISH","submittedTerm": "Squamish","matchedNameType": "PRIMARY","secondaryFieldResults": [],"sources": [
"b_trwc_62"],"categories": [
"Other Bodies"],"creationDate": "2019-04-02T09:50:15.273Z","modificationDate": "2019-04-02T09:50:15.273Z","resolution": null,"resultReview": {
"reviewRequired": false,"reviewRequiredDate": "2019-03-19T00:00:00.000Z","reviewRemark": null,"reviewDate": null}
}
]0 -
Apologies for mentioning that you can get the IMO number in the screening result endpoint. Currently we do not provide the IMO number in the screening result endpoint.
The only way would be, as you suggested, to send a random IMO number as secondary identifier.
If you do not want to send an IMO number in the secondary identifier, you can dig in further using the WC profile API or just use the sync screening endpoint.
The IMO number is only available in the sync screening request JSON and WC profile API JSON.
Please find the sync screening request JSON below. It is inside the
"identityDocuments" array.
"identityDocuments": [
{
"entity": null,
"number": "9413078",
"issueDate": null,
"expiryDate": null,
"issuer": null,
"type": null,
"locationType": {
"type": "INT-IMO",
"country": {
"code": "QQQ",
"name": "INTERNATIONAL"
},
"name": "IMO REGISTRATION NUMBER"
}
}1
Categories
- All Categories
- 6 AHS
- 37 Alpha
- 161 App Studio
- 4 Block Chain
- 4 Bot Platform
- 16 Connected Risk APIs
- 47 Data Fusion
- 30 Data Model Discovery
- 608 Datastream
- 1.3K DSS
- 577 Eikon COM
- 4.9K Eikon Data APIs
- 7 Electronic Trading
- Generic FIX
- 7 Local Bank Node API
- Trading API
- 2.7K Elektron
- 1.3K EMA
- 236 ETA
- 519 WebSocket API
- 33 FX Venues
- 10 FX Market Data
- 1 FX Post Trade
- 1 FX Trading - Matching
- 12 FX Trading – RFQ Maker
- 5 Intelligent Tagging
- 2 Legal One
- 20 Messenger Bot
- 2 Messenger Side by Side
- 9 ONESOURCE
- 7 Indirect Tax
- 59 Open Calais
- 264 Open PermID
- 39 Entity Search
- 2 Org ID
- PAM
- PAM - Logging
- 8.4K Private Comments
- 6 Product Insight
- Project Tracking
- ProView
- ProView Internal
- 20 RDMS
- 1.4K Refinitiv Data Platform
- 367 Refinitiv Data Platform Libraries
- 3 Refinitiv Due Diligence
- LSEG Due Diligence Portal API
- 3 Refinitiv Due Dilligence Centre
- Rose's Space
- 1.1K Screening
- 18 Qual-ID API
- 13 Screening Deployed
- 23 Screening Online
- 10 World-Check Customer Risk Screener
- 990 World-Check One
- 44 World-Check One Zero Footprint
- 45 Side by Side Integration API
- Test Space
- 3 Thomson One Smart
- 1.2K TR Internal
- Global Hackathon 2015
- 2 Specialists Who Code
- 10 TR Knowledge Graph
- 150 Transactions
- 142 REDI API
- 1.7K TREP APIs
- 4 CAT
- 21 DACS Station
- 117 Open DACS
- 1.1K RFA
- 103 UPA
- 172 TREP Infrastructure
- 224 TRKD
- 886 TRTH
- 5 Velocity Analytics
- 5 Wealth Management Web Services
- 59 Workspace SDK
- 9 Element Framework
- 5 Grid
- 13 World-Check Data File
- Yield Book Analytics
- 46 中文论坛