Unify and manage your data

Troubleshooting Guide for Reltio Enrichment with D&B

The troubleshooting guide provides solution for various issues that you may encounter while using the Reltio Enrichment with D&B.

This topic provides troubleshooting information about Reltio Enrichment with D&B and helps you to detect issues and and rectify them:

Error: Tenant is not registered tenant

Resolution:

Use the Status endpoint to make sure whether your tenant is registered in the Reltio Enrichment with D&B.

For more information, contact Reltio Support.
Note: By default, the connector refresh interval is 10 minutes.

This error explains the number of values with different crosswalks. The modification of a survivorship strategy impacts the multiple values with different crosswalks.

Error: 3 Matches Found

Resolution

In the Potential Match screen, no potential match is displayed. Also, the number of matches can be arbitrary.

  • Make sure whether the DTSS subscription exists.
  • In the Data Tenant (DT), make sure that the streaming is enabled. Enable the streaming if it is not enabled already.
    • streamingEnabled: true
    • streamingAPIEnabled: true
  • In the DTSS subscription, make sure whether the parameter hiddenDt is not set to true. When hiddenDT is set to true, it hides DT from the UI and disables sending match requests to DTSS from the user interface.

Error: REL0001: Reltio API error: 403, Access is denied

The Reltio Enrichment with D&B processes requests in Reltio with a service user account. When you encounter this error, it means that the service user account provisioned for your Reltio Enrichment with D&B doesn't have the correct roles and access. This error indicates that the service user account has no access to the Data Tenant.

Resolution:

To resolve this error, create a support ticket. See this topic Get help in Support Portal for creating the ticket.

Error: 1 Match Found

Ensure whether the match has confidence code (CC) as 9 or 10. Also, ensure if it is not automatically merged to the Customer Tenant (CT) and is still in the Potential Matches view.

Resolution:

  • Make sure whether the DTSS subscription exists.
  • In the DT, make sure whether streaming is enabled . If not, enable streaming.
    • streamingEnabled: true
    • streamingAPIEnabled: true
  • By default, the connector sets the auto-merge flag, only if the single entity in the response has CC 9 or CC 10.
  • The Connector sets the auto-merge flag, only for the entities that are displayed with the status as Active.

Buttons do not work and there is an unknown failure or you do not have permissions

Resolution:

  • Logging details in LogDNA will be available in the dnb-connector-prod project. There is a separate stackdriver for HIPAA .
  • Ensure that the user has a ROLE_DNB_CONNECTOR role.

Error: Address not found or Address is incomplete

Click Get match. The error message is displayed.

Ensure if the Address Type and primary flags are set or they have no ISO3166-2. Also, ensure if the Reltio entity does not include the appropriate address.

Resolution:

  • Ensure that an address exists for the record which you are trying to enrich.
  • Make sure whether your L3 configuration and mappings are compatible. L3 describes the address as a reference. The mappings in the Reltio Enrichment with D&B also expect addresses as reference. Also, the Reltio Enrichment with D&B expect addresses as a nested attribute.

Error: DnB API (Invalid Territory provided in the request)

On DnB Direct+ API, click Get Match.

The error is displayed. The name of the locally governed area that forms the part of a centrally governed nation to identify where the address is located.
Note: As per the guiding principle, the geographic area may exist (theoretically) as a separate nation. For the U.S. this is a state. Whereas, in the UK this is one of the Home Nations. If it is a country (US or CA), the region must be of two characters. For other countries, it can be up to 64 characters.

Example: Reltio source attribute staff:

"StateProvince": [
                        {
                            "type": "configuration/entityTypes/Location/attributes/StateProvince",
                            "ov": true,
                            "value": "California",
                            "lookupCode": "CA",
                            "lookupRawValue": "CA"
                        }
                    ]

Resolution:

  • The StateProvince attribute value must be of two characters for US/CA in your L3 configuration.
  • Update the mapping to use lookupCode instead of the value.

Error: Family tree size is too long, please contact the engineering team

The get family tree on Direct 2.0 displays this error.

Resolution:

To know more information, contact Reltio Support.

In Direct 2.0 mapping the nested level is limited and this error indicates the hierarchy of entities is too deep. You can try this request once again after you get a solution.

When you do not have auto-merge even for potential matches with confidence code (CC) as 9 or 10

Resolution:

Ensure whether your auto-merge conditions are met. Check the following conditions:

  • The potential match entity status is Active.
  • The potential match entity with confidence codes 9 and 10 is single.

DTSS service provides the Auto-merge and potential matches feature. Ensure you have correctly configured DTSS service and correct subscription (For example in app-account360 repository):

  1. Streaming enabled in the physical config for DT and for CT.
     
            "streamingConfig": {
            "streamingEnabled": true,
            "streamingAPIEnabled": true
      
  2. REALTIME subscription for DT and for CT.
     "dtSyncType": "REALTIME",
                "ctSyncType": "REALTIME",
  3. The DTSS adds a non-empty messaging destination for DT and CT, if the two previous conditions are satisfied.
    Note: You cannot add the non-empty messaging destination for DT and CT manually.
  "messaging": {
            "destinations": [
                {
                    "type": "queue|topic",
                    "provider": "default",
                    "name": "<clusterName>-_-<tenantName>-_-dtss-_-<hash>",
                    "dtssQueue": true,
                    "enabled": true,
                    "format": "JSON"
                }
            ]
        }

Error: Not a Match button is not working for DT potential matches

Resolution:

Check the security section of the DTSS subscription. Access array must have READ and UPDATE permissions as shown as below:
"security": {
      "metadataAndDataSecurity": {
        "enabled": true,
        "permissionConfig": [
          {
            "uri": "configuration/entityTypes/Organization",
            "permissions": [
              {
                "role": "ROLE_DNB_CONNECTOR",
                "filter": "equals(attributes.DtssCustomerTenantId, '<customerTenantName>')",
                "access": [
                  "READ",
                  "UPDATE"
                ]
              }
            ]
          }
        ]
      }
    }

Error: No match found for input criteria

The Direct+ batch returns this error even when the on-demand works for you. It updates the entity with a new DUNS number when your current DUNS is obsolete.

Resolution:

There is a separate match or enrichment request. There are different APIs. The second batch in D&B Direct+ API is part of the Identify API which indicates that the DnB will start matching and extracting the details when it is able to find the best candidate.

The D&B specific is matched by obsolete DUNS and is not able to find any candidates. The enrichment will return the new DUNS number with details. This is confusing when you work in (on-demand) enrichment. Also, the batch returns Nothing found error.

For example, DUNS number is 001905269:

The D&B Direct+ match creates the request without a DUNS number.

Result

{
    "transactionDetail": {
        "transactionID": "rrt-097c1ff912c8673f5-a-eu-18254-9942024-6",
        "transactionTimestamp": "2020-10-07T03:31:36.827Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "inLanguage": "auto",
        "name": "Runway Liquidation, LLC",
        "address": {
            "countryISOAlpha2Code": "US",
            "streetAddressLine": {
                "line1": "2761 Fruitland Ave Los Angeles"
            }
        },
        "candidateMaximumQuantity": 5,
        "confidenceLowerLevelThresholdValue": 7,
        "isCleanseAndStandardizeInformationRequired": true
    },
    "candidatesMatchedQuantity": 1,
    "matchDataCriteria": "Name and Address Lookup",
    "matchCandidates": [
        {
            "displaySequence": 1,
            "organization": {
                "duns": "609693874",
                "websiteAddress": [],
                "dunsControlStatus": {
                    "operatingStatus": {
                        "description": "Active",
                        "dnbCode": 9074
                    },
                    "isMailUndeliverable": false
                },
                "primaryName": "RUNWAY LIQUIDATION, LLC",
                "tradeStyleNames": [],
                "telephone": [
                    {
                        "telephoneNumber": "3235892224",
                        "isUnreachable": false
                    }
                ],
                "primaryAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US",
                        "name": "United States"
                    },
                    "addressLocality": {
                        "name": "VERNON"
                    },
                    "addressRegion": {
                        "name": null,
                        "abbreviatedName": "CA"
                    },
                    "postalCode": "90058",
                    "postalCodeExtension": "3607",
                    "streetAddress": {
                        "line1": "2761 FRUITLAND AVE",
                        "line2": null
                    }
                },
                "mailingAddress": {
                    "addressCountry": {
                        "isoAlpha2Code": "US",
                        "name": "United States"
                    },
                    "addressLocality": {
                        "name": "LOS ANGELES"
                    },
                    "addressRegion": {
                        "name": null,
                        "abbreviatedName": "CA"
                    },
                    "postalCode": "90058",
                    "postalCodeExtension": null,
                    "streetAddress": {
                        "line1": "PO BOX 58345",
                        "line2": null
                    }
                },
                "registrationNumbers": [],
                "mostSeniorPrincipals": [
                    {
                        "fullName": "MAX  AZRIA"
                    }
                ],
                "isStandalone": false,
                "corporateLinkage": {
                    "familytreeRolesPlayed": [
                        {
                            "description": "Parent/Headquarters",
                            "dnbCode": 9141
                        }
                    ]
                }
            },
            "matchQualityInformation": {
                "confidenceCode": 7,
                "matchGrade": "AAFZZZZZFZF",
                "matchGradeComponentsCount": 11,
                "matchGradeComponents": [
                    {
                        "componentType": "Name",
                        "componentRating": "A"
                    },
                    {
                        "componentType": "Street Number",
                        "componentRating": "A"
                    },
                    {
                        "componentType": "Street Name",
                        "componentRating": "F"
                    },
                    {
                        "componentType": "City",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "State",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "PO Box",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "Phone",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "Postal Code",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "Density",
                        "componentRating": "F"
                    },
                    {
                        "componentType": "Uniqueness",
                        "componentRating": "Z"
                    },
                    {
                        "componentType": "Sic",
                        "componentRating": "F"
                    }
                ],
                "matchDataProfile": "0000009999969999000000989998",
                "matchDataProfileComponentsCount": 14,
                "matchDataProfileComponents": [
                    {
                        "componentType": "Name",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "Street Number",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "Street Name",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "City",
                        "componentValue": "99"
                    },
                    {
                        "componentType": "State",
                        "componentValue": "99"
                    },
                    {
                        "componentType": "PO Box",
                        "componentValue": "96"
                    },
                    {
                        "componentType": "Phone",
                        "componentValue": "99"
                    },
                    {
                        "componentType": "Postal Code",
                        "componentValue": "99"
                    },
                    {
                        "componentType": "DUNS",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "SIC",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "Density",
                        "componentValue": "00"
                    },
                    {
                        "componentType": "Uniqueness",
                        "componentValue": "98"
                    },
                    {
                        "componentType": "National ID",
                        "componentValue": "99"
                    },
                    {
                        "componentType": "URL",
                        "componentValue": "98"
                    }
                ],
                "nameMatchScore": 100.0
            }
        }
    ],
    "cleanseAndStandardizeInformation": {
        "standardizedName": "RUNWAY LIQUIDATION, LLC",
        "standardizedAddress": {
            "addressCountry": {
                "isoAlpha2Code": "US",
                "name": "UNITED STATES"
            },
            "addressLocality": {
                "name": "@"
            },
            "addressRegion": {},
            "addressCounty": {},
            "postalCode": "00000",
            "postalCodeExtension": null,
            "streetAddress": {
                "line1": "2761 Fruitland Ave Los Angeles",
                "line2": null
            },
            "deliveryPointValidationStatus": "No DPV Address",
            "deliveryPointValidationCMRAValue": "No DPV Address",
            "isInexactAddress": false,
            "addressType": "Unknown"
        }
    }
}
The same request with DUNS number in parameters:
https://plus.dnb.com/v1/match/cleanseMatch?inLanguage=auto&name=Runway Liquidation, LLC&streetAddressLine1=2761 Fruitland Ave Los Angeles&countryISOAlpha2Code=US&candidateMaximumQuantity=5&confidenceLowerLevelThresholdValue=7&isCleanseAndStandardizeInformationRequired=true&duns=001905269

The result displays nothing found error. See the match data criteria as follows:

{
    "transactionDetail": {
        "transactionID": "rrt-097c1ff912c8673f5-a-eu-18254-9942462-30",
        "transactionTimestamp": "2020-10-07T03:34:05.293Z",
        "inLanguage": "en-US",
        "serviceVersion": "v1"
    },
    "error": {
        "errorCode": "20505",
        "errorMessage": "No Match found for the given input criteria"
    },
    "inquiryDetail": {
        "inLanguage": "auto",
        "duns": "001905269",
        "name": "Runway Liquidation, LLC",
        "address": {
            "countryISOAlpha2Code": "US",
            "streetAddressLine": {
                "line1": "2761 Fruitland Ave Los Angeles"
            }
        },
        "candidateMaximumQuantity": 5,
        "confidenceLowerLevelThresholdValue": 7,
        "isCleanseAndStandardizeInformationRequired": true
    },
    "candidatesMatchedQuantity": 0,
    "matchDataCriteria": "DUNS Number Lookup",
    "matchCandidates": [],
    "cleanseAndStandardizeInformation": {}
}
D&B enrichment request provides the result as follows:
https://plus.dnb.com/v1/data/duns/001905269?productId=cmpelf&versionId=v1

Result (with the new DUNS)

{
    "transactionDetail": {
        "transactionID": "rrt-0daa1ee1e57942d41-b-eu-17975-10249904-51_1571",
        "transactionTimestamp": "2020-10-07T03:19:28.073Z",
        "inLanguage": "en-US",
        "productID": "cmpelf",
        "productVersion": "1"
    },
    "inquiryDetail": {
        "productVersion": "v1",
        "productID": "cmpelf",
        "duns": "609693874"
    },
    "organization": {
        "duns": "609693874",
        "dunsControlStatus": {
            "operatingStatus": {
                "description": "Active",
                "dnbCode": 9074
            },
            "isMarketable": true,
            "isMailUndeliverable": false,
            "isTelephoneDisconnected": false,
            "isDelisted": false,
            "subjectHandlingDetails": [],
            "fullReportDate": "2018-11-03"
        },
        "primaryName": "Runway Liquidation, LLC",
        "summary": [
            {
                "text": "<p>\n   Its name may come from Parisian slang (\n   <em>\n    bon chic, bon genre\n   </em>\n   , meaning \"good style, good attitude\"), but fashion firm BCBG Max Azria Group is rooted in America. French designer Max Azria started BCBG in Los Angeles, making his name with the novel baby-doll dress, and now creates clothing collections and accessories for women and men under more than 20 brands, including BCBGMAXAZRIA, Max Azria, Herve Leger, and BCBGeneration. His apparel and accessories are sold in more than 570 BCBG boutiques the US and some 45 other countries worldwide. The brand is also carried by specialty stores and major department stores. The company filed for Chapter 11 bankruptcy protection in early 2017.\n  </p>\n  ",
                "textType": {
                    "description": "Short Company Profile",
                    "dnbCode": 32456
                }
            },
            {
                "text": "<p><strong>Company Background</strong></p>\n  <p>\n   In recent years BCBG Max Azria looked to extend its reach to different price points to capture a broader slice of the market. To that end, the fashion firm in 2009 teamed up with Hannah Montana star Miley Cyrus to create the Miley Cyrus &amp; Max Azria collection (aka Miley &amp; Max), which features tops, bottoms, rompers, and dresses -- all for less than $20 apiece. The line, which was sold exclusively through Wal-Mart, was a disappointment and the company discontinued it.\n  </p>\n  <p>\n   The company was founded in 1989.\n  </p>\n ",
                "textType": {
                    "description": "Company Historical Background",
                    "dnbCode": 32457
                }
            },
            {
                "text": "<p><strong>Strategy</strong></p>\n  <p>\n   In 2015 the company opened store in India. The location focuses on featuring dresses, sportswear and a lot of tops. In 2013 the fashion chain opened stores in Indonesia and Mexico.\n  </p>\n  <p>\n   Extending its reach to new apparel categories, its BCBGeneration line launched an intimates collection for fall 2013 and a swimwear collection to be sold in department stores worldwide and through BCBGeneration stores. The launches follow the signing of a new licensing agreement between the company and Trimera Group, its licensee for swimwear.\n  </p>\n  ",
                "textType": {
                    "description": "Strategy Summary",
                    "dnbCode": 32469
                }
            },
            {
                "text": "<p><strong>Sales and Marketing</strong></p>\n  <p>\n   The company sells its products via retail stores and online and ships to 100 countries through its partnership with <company id=\"163184\">BorderFree</company> (a third-party global service provider).\n  </p>\n  ",
                "textType": {
                    "description": "Sales and Marketing Summary",
                    "dnbCode": 32468
                }
            },
            {
                "text": "<p><strong>Geographic Reach</strong></p>\n  <p>\n   The California-based company sells its ready-to-wear apparel in more than 175 BCBG Max Azria boutiques across the US. It also has a retail presence in about 45 other countries, including Canada, Russia, Chile, China, Japan, Venezuela, and other countries in Europe, the Middle East, Russia, and South America. It has 570 retail boutiques worldwide.\n  </p>\n  ",
                "textType": {
                    "description": "Geographic Reach",
                    "dnbCode": 32464
                }
            },
            {
                "text": "<p><strong>Bankruptcy</strong></p>\n  <p>\n   BCBG Max Azria filed for Chapter 11 bankruptcy protection in the first quarter of 2017. The company is seeking new sources of capital and is restructuring its business, including closing some 120 locations. It will close stores in Canada and plans to consolidate locations in Japan and Europe. After completing its restructuring, expected in the third quarter of 2017, the company intends to be in a better position to invest in expanding its online retail presence to reach and attract more customers.\n  </p>\n  ",
                "textType": {
                    "description": "Bankruptcy Summary",
                    "dnbCode": 32458
                }
            },
            {
                "text": "<p><strong>Change in Company Type</strong></p>\n  <p>\n   BCBG Max Azria Group in 2013 was reported to be exploring a sale that could fetch as much as $1 billion. The company retained <company id=\"123521\">Blackstone Group</company> to advise it on its debt restructuring. (The company's rapid expansion has saddled it with some $685 million in debt, amid falling sales.) The fashion house has been under financial pressure since the 2008 financial crisis. Financial Services firm Guggenheim Partners holds about $475 million of the company's approximately $685 million in debt and in mid-2013 was seeking wrest control of the company from Azria.\n  </p>\n  ",
                "textType": {
                    "description": "Change in Company Type",
                    "dnbCode": 32459
                }
            }
        ],
        "tradeStyleNames": [],
        "formerPrimaryNames": [
            {
                "name": "BCBG Max Azria Group, LLC",
                "startDate": null,
                "endDate": null
            }
        ],
        "defaultCurrency": "USD",
        "websiteAddress": [
            {
                "url": "www.bcbg.com",
                "domainName": "bcbg.com"
            }
        ],
        "telephone": [
            {
                "telephoneNumber": "3235892224",
                "isdCode": "1",
                "isUnreachable": false
            }
        ],
        "fax": [],
        "primaryAddress": {
            "language": {},
            "addressCountry": {
                "name": "United States",
                "isoAlpha2Code": "US",
                "fipsCode": "US"
            },
            "continentalRegion": {
                "name": "North America"
            },
            "addressLocality": {
                "name": "Vernon"
            },
            "minorTownName": null,
            "addressRegion": {
                "name": "California",
                "abbreviatedName": "CA",
                "fipsCode": "06"
            },
            "addressCounty": {
                "name": "Los Angeles",
                "fipsCode": "037"
            },
            "postalCode": "90058-3607",
            "postalCodePosition": {},
            "streetNumber": null,
            "streetName": null,
            "streetAddress": {
                "line1": "2761 Fruitland Ave",
                "line2": null
            },
            "postOfficeBox": {},
            "latitude": 33.996407,
            "longitude": -118.220407,
            "geographicalPrecision": {
                "description": "Street Address Centroid",
                "dnbCode": 30257
            },
            "isRegisteredAddress": false,
            "isResidentialAddress": null,
            "statisticalArea": {
                "cbsaName": "Los Angeles-Long Beach-Anaheim CA",
                "cbsaCode": "31080",
                "economicAreaOfInfluenceCode": "097",
                "populationRank": {
                    "rankNumber": "9",
                    "rankDnBCode": 10961,
                    "rankDescription": "500,000 +"
                }
            },
            "locationOwnership": {
                "description": "Leases",
                "dnbCode": 1130
            },
            "premisesArea": {
                "measurement": 500000.0,
                "unitDescription": "Square Foot",
                "unitDnBCode": 3848,
                "reliabilityDescription": "Actual",
                "reliabilityDnBCode": 9092
            },
            "isManufacturingLocation": true,
            "congressionalDistricts": [
                {
                    "district": "40"
                }
            ]
        },
        "registeredAddress": {},
        "mailingAddress": {},
        "stockExchanges": [],
        "thirdPartyAssessment": [],
        "registrationNumbers": [
            {
                "registrationNumber": "95-4255942",
                "typeDescription": "Federal Taxpayer Identification Number (US)",
                "typeDnBCode": 6863
            }
        ],
        "industryCodes": [
            {
                "code": "448120",
                "description": "Women's Clothing Stores",
                "typeDescription": "North American Industry Classification System 2017",
                "typeDnBCode": 30832,
                "priority": 2
            },
            {
                "code": "23350000",
                "description": "Women's, junior's, and misses' dresses",
                "typeDescription": "D&B Standard Industry Code",
                "typeDnBCode": 3599,
                "priority": 3
            },
            {
                "code": "424330",
                "description": "Women's, Children's, and Infants' Clothing and Accessories Merchant Wholesalers",
                "typeDescription": "North American Industry Classification System 2017",
                "typeDnBCode": 30832,
                "priority": 1
            },
            {
                "code": "5621",
                "description": "Ret women's clothing",
                "typeDescription": "US Standard Industry Code 1987 - 4 digit",
                "typeDnBCode": 399,
                "priority": 2
            },
            {
                "code": "56210000",
                "description": "Women's clothing stores",
                "typeDescription": "D&B Standard Industry Code",
                "typeDnBCode": 3599,
                "priority": 2
            },
            {
                "code": "1800",
                "description": "Wholesale Sector",
                "typeDescription": "D&B Hoovers Industry Code",
                "typeDnBCode": 25838,
                "priority": 1
            },
            {
                "code": "5137",
                "description": "Whol women's/child's clothing",
                "typeDescription": "US Standard Industry Code 1987 - 4 digit",
                "typeDnBCode": 399,
                "priority": 1
            },
            {
                "code": "51370000",
                "description": "Women's and children's clothing",
                "typeDescription": "D&B Standard Industry Code",
                "typeDnBCode": 3599,
                "priority": 1
            },
            {
                "code": "315240",
                "description": "Women’s, Girls’, and Infants’ Cut and Sew Apparel Manufacturing",
                "typeDescription": "North American Industry Classification System 2017",
                "typeDnBCode": 30832,
                "priority": 3
            },
            {
                "code": "F",
                "description": "Wholesale Trade",
                "typeDescription": "D&B Standard Major Industry Code",
                "typeDnBCode": 24657,
                "priority": 1
            },
            {
                "code": "4642",
                "description": "Wholesale of clothing and footwear",
                "typeDescription": "NACE Revision 2",
                "typeDnBCode": 29104,
                "priority": 1
            },
            {
                "code": "2335",
                "description": "Mfg women's/misses' dresses",
                "typeDescription": "US Standard Industry Code 1987 - 4 digit",
                "typeDnBCode": 399,
                "priority": 3
            }
        ],
        "activities": [
            {
                "description": "Whol women's/child's clothing, Ret women's clothing, Mfg women's/misses' dresses",
                "language": {
                    "description": null,
                    "dnbCode": 331
                }
            }
        ],
        "startDate": "1989",
        "incorporatedDate": null,
        "businessEntityType": {
            "description": "Corporation",
            "dnbCode": 451
        },
        "legalForm": {
            "registrationLocation": {
                "addressRegion": "DE"
            }
        },
        "controlOwnershipDate": "1989",
        "controlOwnershipType": {},
        "operations": [
            {
                "description": "Wholesales women's, children's and infants' clothing or accessories.  Retails women's clothing.  Manufactures women's, misses' or juniors' dresses."
            }
        ],
        "isAgent": null,
        "isImporter": true,
        "isExporter": true,
        "numberOfEmployees": [
            {
                "value": 2706,
                "minimumValue": null,
                "maximumValue": null,
                "employeeFiguresDate": null,
                "informationScopeDescription": "Consolidated",
                "informationScopeDnBCode": 9067,
                "reliabilityDescription": "Modelled",
                "reliabilityDnBCode": 9094,
                "employeeCategories": [],
                "trend": []
            }
        ],
        "numberOfEmployeesHistory": [],
        "financials": [
            {
                "financialStatementToDate": "2018-11-03",
                "financialStatementDuration": null,
                "informationScopeDescription": null,
                "informationScopeDnBCode": null,
                "reliabilityDescription": "Modelled",
                "reliabilityDnBCode": 9094,
                "unitCode": "Single Units",
                "accountantName": null,
                "yearlyRevenue": [
                    {
                        "value": 5.03526051E8,
                        "currency": "USD",
                        "trend": []
                    }
                ],
                "netProfitLoss": [],
                "netWorth": []
            }
        ],
        "thirdPartyFinancials": {},
        "banks": [],
        "mostSeniorPrincipals": [
            {
                "givenName": "Max",
                "middleName": null,
                "familyName": "Azria",
                "fullName": "Max Azria",
                "namePrefix": null,
                "nameSuffix": null,
                "identificationNumber": null,
                "gender": {},
                "jobTitles": [
                    {
                        "title": "Member"
                    }
                ],
                "positions": [],
                "managementResponsibilities": [
                    {
                        "description": "Member",
                        "mrcCode": "XZA1"
                    }
                ]
            }
        ],
        "currentPrincipals": [
            {
                "givenName": "MARTINE",
                "middleName": null,
                "familyName": "MELLOUL",
                "fullName": "MARTINE MELLOUL",
                "namePrefix": null,
                "nameSuffix": null,
                "identificationNumber": null,
                "gender": {},
                "jobTitles": [
                    {
                        "title": "Member"
                    },
                    {
                        "title": "Executive Vice President"
                    }
                ],
                "positions": [],
                "managementResponsibilities": [
                    {
                        "description": "Member",
                        "mrcCode": "XZA1"
                    },
                    {
                        "description": "Executive Vice-President",
                        "mrcCode": "A5D4"
                    }
                ]
            },
            {
                "givenName": "BRIAN",
                "middleName": null,
                "familyName": "FLEMING",
                "fullName": "BRIAN FLEMING",
                "namePrefix": null,
                "nameSuffix": null,
                "gender": {},
                "jobTitles": [
                    {
                        "title": "Member"
                    },
                    {
                        "title": "Secretary"
                    },
                    {
                        "title": "Treasurer"
                    },
                    {
                        "title": "Chief Financial Officer"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "description": "Member",
                        "mrcCode": "XZA1"
                    },
                    {
                        "description": "Secretary",
                        "mrcCode": "A1B2"
                    },
                    {
                        "description": "Treasurer",
                        "mrcCode": "A1B0"
                    },
                    {
                        "description": "Chief Financial Officer",
                        "mrcCode": "A1A9"
                    }
                ]
            },
            {
                "givenName": "BERND",
                "middleName": null,
                "familyName": "KROEBER",
                "fullName": "BERND KROEBER",
                "namePrefix": null,
                "nameSuffix": null,
                "gender": {},
                "jobTitles": [
                    {
                        "title": "Member"
                    },
                    {
                        "title": "Executive Vice President"
                    }
                ],
                "managementResponsibilities": [
                    {
                        "description": "Member",
                        "mrcCode": "XZA1"
                    },
                    {
                        "description": "Executive Vice-President",
                        "mrcCode": "A5D4"
                    }
                ]
            }
        ],
        "socioEconomicInformation": {},
        "isStandalone": false,
        "corporateLinkage": {
            "familytreeRolesPlayed": [
                {
                    "description": "Subsidiary",
                    "dnbCode": 9159
                },
                {
                    "description": "Parent/Headquarters",
                    "dnbCode": 9141
                }
            ],
            "hierarchyLevel": 2,
            "globalUltimateFamilyTreeMembersCount": 683,
            "globalUltimate": {
                "duns": "080155826",
                "primaryName": "Marquee Brands LLC",
                "primaryAddress": {
                    "addressCountry": {
                        "name": "United States",
                        "isoAlpha2Code": "US",
                        "fipsCode": "US"
                    },
                    "continentalRegion": {
                        "name": "North America"
                    },
                    "addressLocality": {
                        "name": "New York"
                    },
                    "addressRegion": {
                        "name": "New York",
                        "abbreviatedName": "NY"
                    },
                    "addressCounty": {},
                    "postalCode": "10019-3914",
                    "streetAddress": {
                        "line1": "50 W 57TH St",
                        "line2": null
                    }
                }
            },
            "domesticUltimate": {
                "duns": "080155826",
                "primaryName": "Marquee Brands LLC",
                "primaryAddress": {
                    "addressCountry": {
                        "name": "United States",
                        "isoAlpha2Code": "US",
                        "fipsCode": "US"
                    },
                    "continentalRegion": {
                        "name": "North America"
                    },
                    "addressLocality": {
                        "name": "New York"
                    },
                    "addressRegion": {
                        "name": "New York",
                        "abbreviatedName": "NY"
                    },
                    "addressCounty": {},
                    "postalCode": "10019-3914",
                    "streetAddress": {
                        "line1": "50 W 57TH St",
                        "line2": null
                    }
                }
            },
            "parent": {
                "duns": "080155826",
                "primaryName": "Marquee Brands LLC",
                "primaryAddress": {
                    "addressCountry": {
                        "name": "United States",
                        "isoAlpha2Code": "US",
                        "fipsCode": "US"
                    },
                    "continentalRegion": {
                        "name": "North America"
                    },
                    "addressLocality": {
                        "name": "New York"
                    },
                    "addressRegion": {
                        "name": "New York",
                        "abbreviatedName": "NY"
                    },
                    "addressCounty": {},
                    "postalCode": "10019-3914",
                    "streetAddress": {
                        "line1": "50 W 57TH St",
                        "line2": null
                    }
                }
            },
            "headQuarter": {}
        },
        "competitors": [
            {
                "duns": "432078058",
                "primaryName": "PRADA SPA",
                "individualEmployeeCount": 4435,
                "salesRevenue": 2.016749705E9,
                "issuedShareCapitalAmount": 10301.293
            },
            {
                "duns": "007727639",
                "primaryName": "Donna Karan International Inc.",
                "individualEmployeeCount": 1300,
                "salesRevenue": 3.37530761E8,
                "issuedShareCapitalAmount": null
            },
            {
                "duns": "005861955",
                "primaryName": "Premier Brands Group Holdings LLC",
                "individualEmployeeCount": 4350,
                "salesRevenue": 1.540279209E9,
                "issuedShareCapitalAmount": null
            }
        ],
        "franchiseOperationType": {},
        "capitalDetails": [],
        "dnbAssessment": {
            "marketingRiskClass": {},
            "historyRating": {
                "description": "Business",
                "dnbCode": 9081
            },
            "marketingSegmentationCluster": 16
        }
    }
}

Error: Batch or Batch+: MAP0012: first tag must be start array

This error indicates that the connector is unable to parse the export file. Export file must be in JSON format and the first tag must be an open array tag. The reason for such an issue is unsupported by the connector compression. In the export status, check for attribute file compression. The connector process exports files with the ZIP extension; files with GZIP can not be processed.

Resolution:

Set the default compression algorithm in the tenant physical configuration to ZIP.

Error: Many errors in "log: 4, Too many simultaneous connections (max=5)"

This error is related to a tenant’s physical configuration. The connector uses a lot of connections requests in parallel because of no batch request for Reltio API call connections. This request can reach a tenant’s limit.

Resolution:

Update a tenant’s physical configuration where the numbers can be different. To know more information, contact Reltio Support.

The match quality attributes are missing on some entities

This error indicates that some data has changed on an entity. A few other consequences can happen when the connector updates the entities in Reltio. The connector's operations related to match quality attributes are described as follows:
  1. Get match (on demand): The connector posts entities to DT with a crosswalk based on entity

    uri: DUNSNumber+entityUri(goldenId).

    After merging in CT, the entities have the DT crosswalk and values from matching responses.

  2. Batch+: The connector directly updates an entity in CT with match quality attributes when an entity does not have a DUNS number. Crosswalk values are DUNS Number.
    Note: When the entity already has the DUNS number, the D&B does not provide match quality attributes.
  3. On-demand enrichment: The connector updates entity on CT directly without match quality attributes in the D&B response. Crosswalk values are DUNS numbers.

Conclusions:

  1. The Get Match (on demand) and Batch+ enrichment for entities without DUNS will provide match quality attributes match that are involved in the operations. You must have an active mapping with match quality attributes included. The corresponding mappings were introduced in 2020.02.Batch+ on entities with DUNS number would not provide match quality attributes due to lack of information in sources.
  2. Enrichment (on demand) does not provide match quality. Moreover it erases match quality attributes and the data provided from the crosswalk value =DUNSNumber) assigned by Batch+. This is caused because of the entity updates from the same crosswalks.
  3. Presence of the Match quality attributes and irrelevant CC values.

When you know the customer tenant and want to find the respective data tenant

Use get profile by a tenant name endpoint. It will return the customer tenant, profile name, and the data tenant (if the data tenant exists).

Background jobs (monitoring, batch) do not work

In most cases, some errors happened during background job operations.
  1. Find the Job ID. For more information, see Get Jobs List.
  2. Work with batch, scheduled, and monitoring background job types.
  3. See the Status field in response to find the status or the reason of the error.

    Scheduled jobs will produce more jobs to execute the required operations. After you have the list, you can get the job status. For more information, see Get Job Status.

    .
  4. You can work with all types of jobs. The job status contains the problem description.

Error 800 for Type XXX is forbidden

You can see the following errors:
  • REL0001: Reltio API error: 800,Type configuration/entityTypes/Organization is forbidden. Required privileges: READ,Security error.
  • Required privileges: READ,Security error. Type configuration/entityTypes/Organization is forbidden. Required privileges: READ.

The errors mentioned above indicate that service user dnb.connector or dnb.connector.hipaa does not have the required privileges. Mostly, the metadata security is activated on your tenant.

You can find the details in LogDNA:

"context":{"entityUri":"entities/1SbOxTN0123","tenantId":"0A0AAYQZWBTpsLCHO","environment":"guk-test","operationType":"match_plus","operationId":"fbfa93e2-7326-4399-b7a2-987002ae388892","username":"dnb.connector"}}

When there is a URI mismatch

Before updating the target entity with D&B attributes and DUNS number, the connector verifies that the incoming DUNS does not exist in the tenant and is not assigned to another record with a different URI. The URI mismatch error protects against unauthorized entity matches. Do the following to solve this error:

  • mergeOrgsWithSameDUNS - enable this parameter to skip the URI mismatch and the entities with the same DUNS number in the crosswalk will be merged automatically.
  • mergeOrgsWithSameDUNSByPotentialMatches - enable this parameter to mark the operation as successful, and view the potential matches of entities.

To activate the mergeOrgsWithSameDUNSByPotentialMatches parameter:

  1. Check if you have an automatic match rule by the DUNS number in the entity on your Tenant.

  2. Set the mergeOrgsWithSameDUNS parameter =false to ensure the URI mismatch check is active.

  3. Set the mergeOrgsWithSameDUNSByPotentialMatches parameter =true to enable this parameter.

Table 1. Example scenarios
ScenariosParameterDescriptionSample responses
Scenario 1

mergeOrgsWithSameDUNS=false

mergeOrgsWithSameDUNSByPotentialMatches=false

  • No automatic match
  • URI mismatch error prevents obtaining the entity
{
    "success": "Fail",
    "message": "Uri mismatch: The D&B data for this DUNS number is already associated with a different Reltio Entity",
    "entities": [
        "target entity URI"
    ]
}
Scenario 2

mergeOrgsWithSameDUNS=true

mergeOrgsWithSameDUNSByPotentialMatches=false

  • Automatic merging of entities by DUNS value in the crosswalk.
{
    "success": "OK",
    "message": "Enriched",
    "entities": [
        "target entity URI"
    ]
}
Scenario 3

mergeOrgsWithSameDUNS=true

mergeOrgsWithSameDUNSByPotentialMatches=true

  • Automatic merging of entities by DUNS value in the crosswalk.
{
    "success": "OK",
    "message": "Enriched",
    "entities": [
        "target entity URI"
    ]
}
Scenario 4

mergeOrgsWithSameDUNS=false

mergeOrgsWithSameDUNSByPotentialMatches=true

  • No automatic match
  • URI mismatch error present
  • Entities are received as potential matches
{
    "success": "OK",
    "message": "Uri mismatch: The D&B data for this DUNS number is already associated with a different Reltio entity. Result entity will be presented as a potential match.",
    "entities": [
        "target entity URI"
    ]
}

Errors: D&B STP

Here's a list of STP errors and how to troubleshoot them:

Error CodeCauseSteps to Troubleshoot
DNB0001Incompatible data type or unacceptable data type sent in the request.
  1. Retrieve the requested parameters from the logs.
  2. Adjust the format of fields sent in the match cleansing request to ensure the correct data type is provided.
  3. For example, postal codes should be numeric. If Address attributes are not cleansed, postal codes may contain invalid characters.
  4. Update the filter mappings to ensure only valid data types are sent to D&B.
DNB0004The STP service is unavailable or not reachable.
  1. Check network connectivity and ensure access to the STP server.
  2. Verify the server status for maintenance or downtime.
  3. Review logs for additional error context.
  4. Retry the request as the issue might be transient.
DNB0005Cannot read the directory contents on the STP server.
  1. Verify the directory path on the STP server is "/gets" and accessible.
  2. Check that the user has permissions to read the directory.
  3. Review logs for further error details.
DNB0006Failure during the initialization of the SFTP client.
  1. Review the code responsible for initializing the SFTP client for misconfigurations.
  2. Ensure that library dependencies for the SFTP client are installed and up-to-date.
  3. Inspect logs for relevant error messages.
DNB0007Failed to connect during the first step of the SSH connection (username, host, and port).
  1. Verify the username, host, and port details.
  2. Check network access to ensure connectivity to the host and port.
  3. Test connectivity using tools like telnet or nc.
DNB0008Authentication failed during the second step of the SSH connection (password verification).
  1. Verify the username and password for correctness.
  2. Update credentials if they were recently changed.
  3. Manually verify credentials by logging into the STP server using an SSH client.
DNB0009Error during the process of reading a file from the STP server due to network issues, file corruption, or insufficient permissions.
  1. Ensure the file exists on the STP server and verify the path.
  2. Check for network interruptions during the file read process.
  3. Verify user permissions to access the file.
  4. Inspect file integrity or download it manually for validation.
DNB0010Error when attempting to open a file on the STP server. Possible causes include incorrect paths or permission issues.
  1. Verify the file path is correct, including the directory and file name.
  2. Ensure the user has permissions to open the file.
  3. Confirm the file is not locked by another process.
  4. Verify the file exists and is accessible on the STP server.
DNB0011Failure during the initialization of the SFTP session due to invalid server details, SSH key issues, or network problems.
  1. Verify the server's IP/hostname, port, and login credentials.
  2. Check network connectivity to the server.
  3. Ensure SSH keys (if used) are configured correctly and accessible.
  4. Confirm there are no firewall rules blocking the connection.
REQ0021The background monitoring job is started without providing S3 or STP parameters.
  1. Supply the necessary S3 or STP credentials depending on the registration destination type.
  2. Ensure the job configuration includes credentials to access D&B Seed and Notification files.
BCH0039Monitoring registration details are empty or null due to an internal D&B error.
  1. Validate that the monitoring registration details are populated.
  2. Retry the registration process.
  3. Contact D&B support if the issue persists.