Exact Legal Name and Jurisdiction Code

Field

Value

Status and Priority

See central list (Dedicated tabs for VM and USP flows)

Confidence Level

High

Match Reason

“Exact legal name and jurisdiction code - <comma-separated tiebreaker names> tiebreaker/s”.

Example: “Exact legal name and jurisdiction code - Identifiers, Addresses tiebreakers”.

 
 
 

Summary

Links supplier records to legal entities using exact legal name and jurisdiction code combinations.

This rule uses Matched Attributes (MAs). For additional information, see this article.

 

Match Logic

Valid Candidates and Selection

  • Candidates that have both the legal_name and jurisdiction_code MAs are considered as valid candidates.

  • If only one valid candidate is available then it gets selected (with no relation to its activity status or anything else). 

  • If multiple valid candidates are found, the tiebreaker logic listed below is applied.

 

Tiebreakers

Multiple valid candidates undergo a series of tiebreakers to determine the best selection for the pipeline record.

 

Tiebreaker 1 - Identifiers

In this step, we are looking for valid candidates that have one or more of the following identifier MAs:

Tax_id, tax_id_prefix_country, partial_tax_to_company_number, tax_id_to_ca_bn, tax_to_company_number

lei

Company_number, native_company_number, company_number_to_tax

Business_id, business_id_prefix_country, partial_business_id_to_company_number, business_id_to_ca_bn, business_id_to_company_number

 

  • If only one valid candidate matches this check, it is selected and the flow ends.

  • If multiple valid candidates match, the list is reduced to those candidates, and the flow proceeds to the next tiebreaker.

  • If no valid candidates match, all candidates from the previous step are kept, and the flow proceeds to the next tiebreaker.

 

Identifiers Example 1

C1 is selected because it is the only valid candidate to have an identifier match.

 
 
 

Candidate

 

Matching Identifiers

 

C1

tax_id_prefix_country

C2

None

C3

None

C4

None

 
 
 

 

Identifiers Example 2

Multiple valid candidates have identifier matches. The list is reduced to these candidates (C1, C2 and C3) and the flow proceeds to the next tiebreaker.

 
 
 

Candidate

 

Matching Identifiers

 

C1

tax_id_prefix_country

C2

lei

C3

partial_business_id_to_company_number

C4

None

 
 
 

 

 

Tiebreaker 2 - Addresses

We use combinations of address-related MAs per candidate to assess address similarity with the pipeline record.

 

Below are the prioritized address similarity groups. Each candidate is labeled with the highest group based on its available MA combinations.

 

For example, if candidate A has 2 eligible MA combinations, one related to the Similar Area group and another to the Same Address group, then it is labeled with the Same Address group, as it is prioritized higher.Each condition applies consistently with either the registered_ or the non_registered_ prefix (if the prefix is registered_ then all matched attributes in the same condition should also be registered_).

 

  1. Same address - the record and candidate have the same address.

    1. <prefix>_addressline + <prefix>_zip_postal_code + <prefix>_city + <prefix>_state + <prefix>_country.

    2. <prefix>_addressline + <prefix>_zip_postal_code + <prefix>_city + <prefix>_country.

    3. <prefix>_addressline + <prefix>_state + <prefix>_city + <prefix>_country.

    4. <prefix>_addressline + <prefix>_zip_postal_code + <prefix>_country.

    5. <prefix>_addressline + <prefix>_city + <prefix>_country.

  2. Similar area - the addresses of the record and candidate are in the same area.

    1. <prefix>_zip_postal_code + <prefix>_city + <prefix>_state + <prefix>_country.

    2. <prefix>_zip_postal_code + <prefix>_city + <prefix>_country.

    3. <prefix>_zip_postal_code + <prefix>_country.

    4. <prefix>_city + <prefix>_state + <prefix>_country.

  3. Similar address no country - the addresses of the record and candidate have substantial similarities but the country is not matching for some reason (in most cases it is related to parsing/normalization issues).

    1. <prefix>_addressline + <prefix>_zip_postal_code + <prefix>_city + <prefix>_state.

    2. <prefix>_addressline + <prefix>_zip_postal_code + <prefix>_city.

    3. <prefix>_addressline + <prefix>_state + <prefix>_city.

    4. <prefix>_addressline + <prefix>_zip_postal_code.

    5. <prefix>_addressline + <prefix>_city.

    6. <prefix>_zip_postal_code + <prefix>_city + <prefix>_state.

    7. <prefix>_zip_postal_code + <prefix>_city.

    8. <prefix>_city + <prefix>_state.

 

  • If only one valid candidate has one of the above MA combinations, it is selected and the flow ends.

  • If multiple valid candidates match, we order them by their assigned address similarity groups:

    • If the highest-ranked group has only one candidate, it gets selected and the flow ends.

    • If the highest-ranked group has multiple candidates in it, the list is reduced to these candidates, and the flow proceeds to the next tiebreaker.

  • If no candidates match to any of the above groups, the flow proceeds to the next tiebreaker with all valid candidates.

 

Address Example 1

C1 is selected because “Same address” is the highest-ranked group and only C1 is a part of it.

 
 
 

Candidate

 

Address Similarity Group

 

C1

Same address

C2

Similar area

C3

Similar address no country

C4

Similar address no country

 
 
 

 

Address Example 2

“Same address” is the highest-ranked group and multiple candidates are a part of it (C1 and C2). Therefore, the flow proceeds to the next tiebreaker with C1 and C2 only.

 
 
 

Candidate

 

Address Similarity Group

 

C1

Same address

C2

Same address

C3

Similar address no country

C4

Similar address no country

 
 
 

 

 

Tiebreaker 3 - Inactive Status

Uses the values in the inactive field for each candidate as a tiebreaker according to the following priority:

  1. Active - inactive=false

  2. Unknown - inactive=null

  3. Inactive - inactive=true

 

  • If the highest-ranked group has only one candidate, it gets selected and the flow ends.

  • Otherwise, the flow ends with no selected candidate.

 

Inactive Status Example 1

C1 is selected because “Null” is the highest-ranked group available and only one candidate has it

 
 
 

Candidate

 

Inactive Status

 

C1

Null

C2

True

C3

True

C4

True

 
 
 

 

Inactive Status Example 2

No selection made because “False” is the highest ranked group and multiple candidates have it (C1 and C2).

 
 
 

Candidate

 

Inactive Status Group

 

C1

False

C2

False

C3

Null

C4

True