Lookup Business Partners
The Lookup Business Partners endpoint is designed to search for Business Partners within all available data sources. It is specifically crafted to provide data formatted to meet the unique needs of SAP users. The endpoint's primary objective is to offer a seamless integration of CDQ Data Model into the SAP One Domain Model, ensuring that the information is readily accessible and compatible with SAP systems.
CDQ Data Model | SAP One Domain Model |
---|---|
name | formattedOrgName?? |
identifiers | taxNumbers/identifications with their types |
legal form category | legal form |
Example:
To meet SAP ODM data expectations Lookup Business Partner endpoint checks the technicalKey in the CDQ Identifiers object and compares it with the SAP identificationType's code. Based on this comparison divides identifiers into specific groups e.g. taxNumber.
CDQ Data Model
{
"identifiers": [
{
"type":
{
"url": "https://meta.cdq.com/Business_Registration_Number_(Germany)",
"name": "Business Registration Number",
"technicalKey": "DE_BNUM"
},
"value": "HRB 739690",
"issuingBody":
{ }
}
]
}
SAP One Domain Model in the jsonRecord
{
"identifications": [
{
"country": { },
"identificationNumber": "HRB 739690",
"institute": "Amtsgericht Ulm",
"identificationType": {
"code": "BUP002"
}
}
]
}
To ensure seamless integration and compliance with SAP standards, data transformations are essential. CDQ data model often contains values like 'CHE-218.608.886 HR/MWST' while SAP ODM adheres to a specific format, 'CHE218608886' These transformations bridge the gap between data models, enabling data to pass through internal SAP Data Validation checkpoints. It aligns the data with SAP's stringent standards, making it ready for further processing and validation within SAP systems. These transformations not only harmonize the data but also streamline the validation process, ensuring data accuracy and consistency throughout the SAP ecosystem.
Lookup Business Partner provides alignment with the SAP Factory Standard but can be customized to customer needs.
Country | Field | Field type | Transformation Input | Transformation output |
---|---|---|---|---|
CH | Tax number | CH1 | CHE-218.608.886 HR/MWST | CHE218608886 |
Retrieves the Business Partner based on the Lookup and returning the result of the single record.
Read more about Golden Record here.
OK
Unauthorized
Forbidden
Not Found
{- "cdqId": "VIES:CZ46981691"
}
{- "cdqId": "VIES:CZ46981691",
- "dataSource": {
- "aleiPrefix": "VIES",
- "name": "VIES"
}, - "businessPartner": {
- "names": [
- {
- "type": {
- "name": "VAT Registered Name",
- "technicalKey": "VAT_REGISTERED"
}, - "value": "TESCOMA s.r.o.",
- "language": { }
}
], - "identifiers": [
- {
- "type": {
- "name": "Value added tax identification number",
- "technicalKey": "EU_VAT_ID_CZ"
}, - "value": "CZ46981691",
- "status": {
- "technicalKey": "ACTIVE"
}
}
], - "categories": [ ],
- "addresses": [
- {
- "version": {
- "characterSet": {
- "name": "Latin",
- "technicalKey": "LATIN"
}, - "language": {
- "name": "en",
- "technicalKey": "en"
}
}, - "country": {
- "shortName": "CZ",
- "value": "Czechia"
}, - "administrativeAreas": [ ],
- "postCodes": [
- {
- "value": "760 01",
- "type": {
- "name": "Regular",
- "technicalKey": "REGULAR"
}
}
], - "localities": [
- {
- "value": "Zlín"
}
], - "thoroughfares": [
- {
- "type": {
- "name": "Street",
- "technicalKey": "STREET"
}, - "number": "1",
- "value": "U Tescomy Lužkovice"
}
], - "premises": [ ],
- "postalDeliveryPoints": [ ],
- "types": [
- {
- "name": "VAT Registered Address",
- "technicalKey": "VAT_REGISTERED"
}
], - "formattedAddress": {
- "country": "Czechia",
- "locality": "Zlín",
- "postalCode": "760 01",
- "thoroughfare": "U Tescomy Lužkovice 1"
}
}
], - "formattedSapRecord": {
- "narp": "NO",
- "stceg": "CZ46981691",
- "country": "Czechia",
- "countryCode": "CZ",
- "city": "Zlín",
- "postalCode": "760 01",
- "street1": "U Tescomy Lužkovice",
- "houseNum": "1"
}, - "types": [ ]
}
}
Fetch business partner by CDQ-ID.
cdqId | string CDQ ID for business partner and address. Example: "VIES:PL8660001429" | ||||
featuresOff | Array of strings List of features to be deactivated.
Example: ["SHOW_DEBUG_INFO"] | ||||
featuresOn | Array of strings List of features to be activated.
Example: ["SHOW_DEBUG_INFO"] |
OK
Unauthorized
Forbidden
Not Found
{- "example": "VIES:PL8660001429"
}
{- "status": "OK",
- "message": "Service returned a correct response.",
- "cdqId": "VIES:PL8660001429",
- "dataSource": "BR_RF",
- "businessPartner": {
- "names": [
- {
- "shortName": "CDQ AG",
- "type": {
- "name": "Local Name",
- "technicalKey": "LOCAL"
}, - "value": "Corporate Data Quality AG",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "legalForm": {
- "name": "Aktiengesellschaft",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}, - "mainAbbreviation": "AG",
- "cdlElfCode": "AG",
- "categories": [
- {
- "name": "Limited Liability Company",
- "shortName": "LLC",
- "technicalKey": "LIMITED"
}
], - "technicalKey": "DE_9866"
}, - "identifiers": [
- {
- "value": "CHE-218.608.886 HR/MWST",
- "type": {
- "name": "CH_VAT_ID",
- "technicalKey": "CH_VAT_ID"
}, - "status": {
- "name": "ACTIVE",
- "technicalKey": "ACTIVE"
}, - "issuingBody": {
- "name": "Amtsgericht Aachen",
- "shortName": "Amtsgericht Aachen",
- "names": [
- {
- "shortName": "CDQ AG",
- "type": {
- "url": null,
- "name": null,
- "technicalKey": null
}, - "value": "Corporate Data Quality AG",
- "language": {
- "name": null,
- "technicalKey": null
}
}
], - "description": "Amtsgericht Aachen",
- "technicalKey": "Amtsgericht Aachen",
- "jurisdiction": {
- "country": {
- "shortName": "CH",
- "value": "Switzerland"
}, - "administrativeAreas": [
- {
- "value": null,
- "shortName": null,
- "fipsCode": null,
- "isoCode": null,
- "type": { },
- "language": { }
}
]
}, - "gleifCode": "RA000004",
- "localAuthorityCode": "R3101",
}
}
], - "addresses": [
- {
- "version": {
- "characterSet": {
- "name": "International",
- "technicalKey": "INTERNATIONAL"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}, - "identifyingName": {
- "value": "John Doe"
}, - "externalId": "1",
- "metadata": {
- "primaryProvenance": {
- "name": "VIES",
- "technicalKey": "VIES",
- "cdqId": "VIES:PL8660001429"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}, - "careOf": {
- "value": "CDQ GmbH c/o Product Department"
}, - "contexts": [
- {
- "value": "Production hall 7, Storage field 8."
}
], - "country": {
- "shortName": "CH",
- "value": "Switzerland"
}, - "administrativeAreas": [
- {
- "value": "Sankt Gallen",
- "shortName": "SG",
- "fipsCode": "SZ15",
- "isoCode": "CH-SG",
- "type": {
- "name": "COUNTY",
- "technicalKey": "COUNTY"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "postCodes": [
- "9000"
], - "localities": [
- {
- "type": {
- "name": "City",
- "technicalKey": "CITY"
}, - "shortName": "St. Gallen",
- "value": "Sankt Gallen",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "thoroughfares": [
- {
- "type": {
- "name": "Industrial zone",
- "technicalKey": "INDUSTRIAL_ZONE"
}, - "shortName": "Lukasstr. 4",
- "number": "4",
- "value": "Lukasstraße 4",
- "name": "Lukasstraße",
- "direction": "221-bis Baker Street, North",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "premises": [
- {
- "value": "Lukasstraße 4",
- "shortName": "Lukasstr. 4",
- "number": "4",
- "type": {
- "name": "Factory",
- "technicalKey": "FACTORY"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "postalDeliveryPoints": [
- {
- "type": {
- "name": "Mailbox",
- "technicalKey": "MAILBOX"
}, - "shortName": "St Gallen, Postfach 460",
- "number": "460",
- "value": "Postfach",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "openingHours": [
- {
- "openingHour": "09:00 AM",
- "closingHour": "05:00 PM",
- "weekday": "Monday"
}
], - "geographicCoordinates": {
- "latitude": "47.439549",
- "longitude": "9.395275"
}, - "types": [
- {
- "name": "Legal Address",
- "technicalKey": "LEGAL_ADDRESS"
}
], - "formattedAddress": {
- "country": "Switzerland",
- "administrativeArea": "Sankt Gallen",
- "region": "Sankt Gallen",
- "regionCode": "9004",
- "locality": "Sankt Gallen",
- "district": "City center",
- "postalCode": "9000",
- "thoroughfare": "Lukassstrasse",
- "premise": "Lukasstraße 4, Building 2, Floor 3, Room 4",
- "interurbanDeliveryPoint": "Sankt Gallen, Postfach 460",
- "mailbox": "Postfach 460",
- "postOfficeBox": "Postfach 460"
}
}
], - "externalId": "The ID managed in the customer's SAP systems.",
- "jsonRecord": {
- "displayId": "SAP",
- "businessPartnerType": "organization",
- "organization": {
- "nameDetails": {
- "formattedOrgNameLine1": "SAP SE",
- "formattedOrgNameLine2": "Hasso-Plattner-Ring 7",
- "formattedOrgNameLine3": "69190 Walldorf",
- "formattedOrgNameLine4": "Germany",
- "formattedOrgName": "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany",
- "customSalutation": "Additional information",
- "scriptVariants": [
- {
- "formattedOrgNameLine1": "SAP SE",
- "formattedOrgNameLine2": "Hasso-Plattner-Ring 7",
- "formattedOrgNameLine3": "69190 Walldorf",
- "formattedOrgNameLine4": "Germany",
- "formattedOrgName": "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany",
- "customSalutation": "Additional information",
- "scriptCode": {
- "name": null,
- "code": null
}
}
]
}, - "legalForm": {
- "name": "Code list entry name.",
- "code": "AG"
}, - "globalLocationNumber": "0847976000005"
}, - "identifications": [
- {
- "identificationType": {
- "name": "Code list entry name.",
- "code": "IDCARD"
}, - "identificationNumber": "DE123456789",
- "country": {
- "name": "Code list entry name.",
- "code": "DE"
}, - "region": {
- "name": "Code list entry name.",
- "code": "DE-BW"
}, - "institute": "Federal Republic of Germany"
}
], - "taxNumbers": [
- {
- "taxNumberType": {
- "name": "Code list entry name.",
- "code": "VAT"
}, - "taxNumber": "DE123456789"
}
], - "addressData": [
- {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "usages": [
- {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "usage": {
- "name": null,
- "code": null
}, - "isStandard": "true"
}
], - "postalAddressType": "organizationPostalAddress",
- "organizationPostalAddress": {
- "streetPrefix1": "StreetPrefix1",
- "streetPrefix2": "StreetPrefix1",
- "street": {
- "name": "Main Street",
- "ref": {
- "name": null,
- "code": null
}
}, - "streetSuffix1": "StreetSuffix1",
- "streetSuffix2": "StreetSuffix2",
- "houseNumber": "Building 1",
- "houseNumberSupplement": "2nd floor",
- "building": "Building 1",
- "floor": "2nd floor",
- "door": "Room 14",
- "careOf": "c/o John Doe",
- "primaryRegion": {
- "name": "Code list entry name.",
- "code": "DE-BW"
}, - "secondaryRegion": {
- "name": "Montgomery County",
- "ref": {
- "name": null,
- "code": null
}
}, - "tertiaryRegion": {
- "name": "Montgomery County",
- "ref": {
- "name": null,
- "code": null
}
}, - "town": {
- "name": "Berlin",
- "ref": {
- "name": null,
- "code": null
}
}, - "district": {
- "name": "Mitte",
- "ref": {
- "name": null,
- "code": null
}
}, - "country": {
- "name": "Code list entry name.",
- "code": "DE"
}, - "postCode": "10115",
- "alternative": {
- "country": {
- "name": null,
- "code": null
}, - "postCode": "10115",
- "primaryRegion": {
- "name": null,
- "code": null
}, - "secondaryRegion": {
- "name": null,
- "ref": { }
}, - "tertiaryRegion": {
- "name": null,
- "ref": { }
}, - "town": {
- "name": null,
- "ref": { }
}, - "district": {
- "name": null,
- "ref": { }
}, - "deliveryType": {
- "name": null,
- "code": null
}, - "deliveryServiceType": "POBoxDelivery",
- "deliveryServiceQualifier": "Post Office SouthEast",
- "deliveryServiceIdentifier": "1234"
}, - "coordinates": {
- "latitude": "52.520008",
- "longitude": "13.404954",
- "altitude": "34.0"
}, - "scriptVariants": [
- {
- "formattedOrgNameLine1": null,
- "formattedOrgNameLine2": null,
- "formattedOrgNameLine3": null,
- "formattedOrgNameLine4": null,
- "formattedOrgName": null,
- "streetPrefix1": null,
- "streetPrefix2": null,
- "street": { },
- "streetSuffix1": null,
- "streetSuffix2": null,
- "houseNumber": null,
- "houseNumberSupplement": null,
- "building": null,
- "floor": null,
- "door": null,
- "careOf": null,
- "primaryRegion": { },
- "secondaryRegion": { },
- "tertiaryRegion": { },
- "town": { },
- "district": { },
- "country": { },
- "postCode": null,
- "alternative": { },
- "coordinates": { },
- "scriptCode": { }
}
]
}, - "emailAddresses": {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "address": "developer-portal@cdq.com"
}, - "websites": {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
}
}
]
}, - "types": [
- {
- "name": "Legal Entity",
- "technicalKey": "LEGAL_ENTITY"
}
]
}
}
Perform a Business Partner lookup operation across all available Data Sources. The output of this operation will be a comprehensive list of Business Partners, each accompanied by their respective Data Sources and meticulously calculated matching scores. It is important to note that all accessible data sources are comprehensively documented within the Data_source Category on CDQ Wiki.
The Data Sources are categorized as follows:
The results of the Business Partner lookup operation are sorted in descending order based on their matching scores. Additionally, the results are conveniently paginated, allowing for efficient navigation through the extensive list. The page size can be effortlessly customized to accommodate specific preferences.
cmd
object Refers to an organizational entity engaged in various facets of another organization's business interactions. This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ (Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the specific Business Partner, ensuring comprehensive management and traceability within the system. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
configurationId | string Configuration ID used to set up lookup. If provided, those parameters will be affected. If any of them is provided in this request, will overwrite one from configuration (except for features which are merged):
Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dataSources | Array of strings Filter data sources used during lookup. Example: ["VIES"] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
featuresOff | Array of strings (businessPartnerFeaturesDescription) List of features to be deactivated.
Example: ["ACTIVATE_DATASOURCE_BVD"] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
featuresOn | Array of strings (businessPartnerFeaturesDescription) List of features to be activated.
Example: ["ACTIVATE_DATASOURCE_BVD"] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
limit | integer [ 0 .. 1000 ] Number of items per page. Default value is 10. Example: "20" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
matchingThreshold | number <double> [ 0 .. 1 ] Matching threshold for the lookup process. Default value is 0.5. Example: "0.5" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maxCandidates | integer [ 20 .. 200 ] Maximum number of candidates to be returned. Default value is 50. Example: "50" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
startAfter | string The ID which is used to read the page. Example: "5712566172571652" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects This field allows to filter data mirrors that will be queried. For each data mirror, data sources can also be filtered. Leave empty to include all available data mirrors in query. |
OK
Unauthorized
Forbidden
Not Found
Message ID | Technical Key | Message |
---|---|---|
429000007 | CREDITS_EXCEEDED | Credits exceeded. There is not enough credits to execute the request. Contact sales to get additional credits |
{- "matchingThreshold": 0,
- "pageSize": 10,
- "page": 0,
- "dataSources": [
- "string"
], - "businessPartner": {
- "names": [
- {
- "value": "string"
}
], - "identifiers": [
- {
- "value": "string",
- "type": {
- "technicalKey": "string"
}
}
], - "legalForm": {
- "value": "string"
}, - "addresses": [
- {
- "thoroughfares": [
- {
- "value": "string",
- "number": "string"
}
], - "localities": [
- {
- "value": "string"
}
], - "administrativeAreas": [
- {
- "value": "string"
}
], - "postCodes": [
- {
- "value": "string"
}
], - "country": {
- "shortName": "string"
}
}
]
}
}
{- "cdqId": "VIES:CZ46981691",
- "dataSource": {
- "aleiPrefix": "VIES",
- "name": "VIES"
}, - "businessPartner": {
- "names": [
- {
- "type": {
- "name": "VAT Registered Name",
- "technicalKey": "VAT_REGISTERED"
}, - "value": "TESCOMA s.r.o.",
- "language": { }
}
], - "identifiers": [
- {
- "type": {
- "name": "Value added tax identification number",
- "technicalKey": "EU_VAT_ID_CZ"
}, - "value": "CZ46981691",
- "status": {
- "technicalKey": "ACTIVE"
}
}
], - "categories": [ ],
- "addresses": [
- {
- "version": {
- "characterSet": {
- "name": "Latin",
- "technicalKey": "LATIN"
}, - "language": {
- "name": "en",
- "technicalKey": "en"
}
}, - "country": {
- "shortName": "CZ",
- "value": "Czechia"
}, - "administrativeAreas": [ ],
- "postCodes": [
- {
- "value": "760 01",
- "type": {
- "name": "Regular",
- "technicalKey": "REGULAR"
}
}
], - "localities": [
- {
- "value": "Zlín"
}
], - "thoroughfares": [
- {
- "type": {
- "name": "Street",
- "technicalKey": "STREET"
}, - "number": "1",
- "value": "U Tescomy Lužkovice"
}
], - "premises": [ ],
- "postalDeliveryPoints": [ ],
- "types": [
- {
- "name": "VAT Registered Address",
- "technicalKey": "VAT_REGISTERED"
}
], - "formattedAddress": {
- "country": "Czechia",
- "locality": "Zlín",
- "postalCode": "760 01",
- "thoroughfare": "U Tescomy Lužkovice 1"
}
}
], - "formattedSapRecord": {
- "narp": "NO",
- "stceg": "CZ46981691",
- "country": "Czechia",
- "countryCode": "CZ",
- "city": "Zlín",
- "postalCode": "760 01",
- "street1": "U Tescomy Lužkovice",
- "houseNum": "1"
}, - "types": [ ]
}
}
Lookup a business partner in all available data sources.
object An organizational entity engaged in various facets of another organization's business interactions. This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ (Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the specific Business Partner, ensuring comprehensive management and traceability within the system. | |||||||||
dataSources | Array of strings Filter Data Sources used during lookup. Example: "VIES" | ||||||||
featuresOff | Array of strings List of features to be deactivated.
Example: ["SHOW_DEBUG_INFO"] | ||||||||
featuresOn | Array of strings List of features to be activated.
Example: ["SHOW_DEBUG_INFO"] | ||||||||
limit | integer [ 0 .. 1000 ] Number of items per page. Example: "100" | ||||||||
matchingThreshold | number <double> [ 0 .. 1 ] The matching threshold for the lookup. Example: "0.5" | ||||||||
maxCandidates | integer [ 20 .. 100 ] The maximum number of candidates to be returned by the lookup. Default 50. Example: "50" | ||||||||
page | integer >= 0 Default: 0 Current page number. Example: "1" | ||||||||
pageSize | integer [ 1 .. 1000 ] Number of items per page. Default 10. Example: "100" | ||||||||
startAfter | string The ID which is used to read the page. Example: "5712566172571652" |
OK
Unauthorized
Forbidden
Not Found
{- "businessPartner": {
- "addresses": [
- {
- "country": {
- "shortName": "DE"
}
}
], - "names": [
- {
- "value": "SAP"
}
]
}
}
{- "pageSize": "100",
- "totals": "67",
- "page": "1",
- "limit": "100",
- "startAfter": "5712566172571652",
- "nextStartAfter": "5712566172571652",
- "values": [
- {
- "cdqId": "VIES:PL8660001429",
- "dataSource": "5e2874fb8d2a7400011acee1",
- "matchingProfile": {
- "matchingScores": {
- "overall": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}, - "businessPartner": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}, - "address": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}
}
}, - "businessPartner": {
- "names": [
- {
- "shortName": "CDQ AG",
- "type": {
- "name": "Local Name",
- "technicalKey": "LOCAL"
}, - "value": "Corporate Data Quality AG",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "legalForm": {
- "name": "Aktiengesellschaft",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}, - "mainAbbreviation": "AG",
- "cdlElfCode": "AG",
- "categories": [
- {
- "name": "Limited Liability Company",
- "shortName": "LLC",
- "technicalKey": "LIMITED"
}
], - "technicalKey": "DE_9866"
}, - "identifiers": [
- {
- "value": "CHE-218.608.886 HR/MWST",
- "type": {
- "name": "CH_VAT_ID",
- "technicalKey": "CH_VAT_ID"
}, - "status": {
- "name": "ACTIVE",
- "technicalKey": "ACTIVE"
}, - "issuingBody": {
- "name": "Amtsgericht Aachen",
- "shortName": "Amtsgericht Aachen",
- "names": [
- { }
], - "description": "Amtsgericht Aachen",
- "technicalKey": "Amtsgericht Aachen",
- "jurisdiction": {
- "country": { },
- "administrativeAreas": [ ]
}, - "gleifCode": "RA000004",
- "localAuthorityCode": "R3101",
}
}
], - "addresses": [
- {
- "version": {
- "characterSet": {
- "name": null,
- "technicalKey": null
}, - "language": {
- "name": null,
- "technicalKey": null
}
}, - "identifyingName": {
- "value": "John Doe"
}, - "externalId": "1",
- "metadata": {
- "primaryProvenance": {
- "name": null,
- "url": null,
- "technicalKey": null,
- "cdqId": null
}, - "language": {
- "name": null,
- "technicalKey": null
}
}, - "careOf": {
- "value": "CDQ GmbH c/o Product Department"
}, - "contexts": [
- {
- "value": null
}
], - "country": {
- "shortName": "CH",
- "value": "Switzerland"
}, - "administrativeAreas": [
- {
- "value": null,
- "shortName": null,
- "fipsCode": null,
- "isoCode": null,
- "type": { },
- "language": { }
}
], - "postCodes": [
- "9000"
], - "localities": [
- {
- "type": { },
- "shortName": null,
- "value": null,
- "language": { }
}
], - "thoroughfares": [
- {
- "type": { },
- "shortName": null,
- "number": null,
- "value": null,
- "name": null,
- "direction": null,
- "language": { }
}
], - "premises": [
- {
- "value": null,
- "shortName": null,
- "number": null,
- "type": { },
- "language": { }
}
], - "postalDeliveryPoints": [
- {
- "type": { },
- "shortName": null,
- "number": null,
- "value": null,
- "language": { }
}
], - "openingHours": [
- {
- "openingHour": null,
- "closingHour": null,
- "weekday": null
}
], - "geographicCoordinates": {
- "latitude": "47.439549",
- "longitude": "9.395275"
}, - "types": [
- {
- "name": null,
- "url": null,
- "technicalKey": null
}
], - "formattedAddress": {
- "country": "Switzerland",
- "administrativeArea": "Sankt Gallen",
- "region": "Sankt Gallen",
- "regionCode": "9004",
- "locality": "Sankt Gallen",
- "district": "City center",
- "postalCode": "9000",
- "thoroughfare": "Lukassstrasse",
- "premise": "Lukasstraße 4, Building 2, Floor 3, Room 4",
- "interurbanDeliveryPoint": "Sankt Gallen, Postfach 460",
- "mailbox": "Postfach 460",
- "postOfficeBox": "Postfach 460"
}
}
], - "externalId": "The ID managed in the customer's SAP systems.",
- "jsonRecord": {
- "displayId": "SAP",
- "businessPartnerType": "organization",
- "organization": {
- "nameDetails": {
- "formattedOrgNameLine1": "SAP SE",
- "formattedOrgNameLine2": "Hasso-Plattner-Ring 7",
- "formattedOrgNameLine3": "69190 Walldorf",
- "formattedOrgNameLine4": "Germany",
- "formattedOrgName": "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany",
- "customSalutation": "Additional information",
- "scriptVariants": [
- { }
]
}, - "legalForm": {
- "name": "Code list entry name.",
- "code": "AG"
}, - "globalLocationNumber": "0847976000005"
}, - "identifications": [
- {
- "identificationType": {
- "name": null,
- "code": null
}, - "identificationNumber": "DE123456789",
- "country": {
- "name": null,
- "code": null
}, - "region": {
- "name": null,
- "code": null
}, - "institute": "Federal Republic of Germany"
}
], - "taxNumbers": [
- {
- "taxNumberType": {
- "name": null,
- "code": null
}, - "taxNumber": "DE123456789"
}
], - "addressData": [
- {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "usages": [
- { }
], - "postalAddressType": "organizationPostalAddress",
- "organizationPostalAddress": {
- "streetPrefix1": null,
- "streetPrefix2": null,
- "street": { },
- "streetSuffix1": null,
- "streetSuffix2": null,
- "houseNumber": null,
- "houseNumberSupplement": null,
- "building": null,
- "floor": null,
- "door": null,
- "careOf": null,
- "primaryRegion": { },
- "secondaryRegion": { },
- "tertiaryRegion": { },
- "town": { },
- "district": { },
- "country": { },
- "postCode": null,
- "alternative": { },
- "coordinates": { },
- "scriptVariants": [ ]
}, - "emailAddresses": {
- "validFrom": null,
- "validTo": null,
- "address": null
}, - "websites": {
- "validFrom": null,
- "validTo": null,
- "url": null
}
}
]
}, - "types": [
- {
- "name": "Legal Entity",
- "technicalKey": "LEGAL_ENTITY"
}
]
}
}
], - "goldenRecord": {
- "cdqId": "VIES:PL8660001429",
- "matchingProfile": {
- "matchingScores": {
- "overall": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}, - "businessPartner": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}, - "address": {
- "classification": {
- "technicalKey": "HIGH",
- "name": "My Matching Configuration"
}, - "value": "0.9",
- "explanation": "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"
}
}
}, - "businessPartner": {
- "names": [
- {
- "shortName": "CDQ AG",
- "type": {
- "name": "Local Name",
- "technicalKey": "LOCAL"
}, - "value": "Corporate Data Quality AG",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}
}
], - "legalForm": {
- "name": "Aktiengesellschaft",
- "language": {
- "name": "German",
- "technicalKey": "DE"
}, - "mainAbbreviation": "AG",
- "cdlElfCode": "AG",
- "categories": [
- {
- "name": "Limited Liability Company",
- "shortName": "LLC",
- "technicalKey": "LIMITED"
}
], - "technicalKey": "DE_9866"
}, - "identifiers": [
- {
- "value": "CHE-218.608.886 HR/MWST",
- "type": {
- "name": "CH_VAT_ID",
- "technicalKey": "CH_VAT_ID"
}, - "status": {
- "name": "ACTIVE",
- "technicalKey": "ACTIVE"
}, - "issuingBody": {
- "name": "Amtsgericht Aachen",
- "shortName": "Amtsgericht Aachen",
- "names": [
- {
- "shortName": null,
- "type": { },
- "value": null,
- "language": { }
}
], - "description": "Amtsgericht Aachen",
- "technicalKey": "Amtsgericht Aachen",
- "jurisdiction": {
- "country": {
- "shortName": null,
- "value": null
}, - "administrativeAreas": [
- { }
]
}, - "gleifCode": "RA000004",
- "localAuthorityCode": "R3101",
}
}
], - "addresses": [
- {
- "version": {
- "characterSet": {
- "name": "International",
- "technicalKey": "INTERNATIONAL"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}, - "identifyingName": {
- "value": "John Doe"
}, - "externalId": "1",
- "metadata": {
- "primaryProvenance": {
- "name": "VIES",
- "technicalKey": "VIES",
- "cdqId": "VIES:PL8660001429"
}, - "language": {
- "name": "German",
- "technicalKey": "DE"
}
}, - "careOf": {
- "value": "CDQ GmbH c/o Product Department"
}, - "contexts": [
- {
- "value": "Production hall 7, Storage field 8."
}
], - "country": {
- "shortName": "CH",
- "value": "Switzerland"
}, - "administrativeAreas": [
- {
- "value": "Sankt Gallen",
- "shortName": "SG",
- "fipsCode": "SZ15",
- "isoCode": "CH-SG",
- "type": {
- "name": null,
- "url": null,
- "technicalKey": null
}, - "language": {
- "name": null,
- "technicalKey": null
}
}
], - "postCodes": [
- "9000"
], - "localities": [
- {
- "type": {
- "name": null,
- "url": null,
- "technicalKey": null
}, - "shortName": "St. Gallen",
- "value": "Sankt Gallen",
- "language": {
- "name": null,
- "technicalKey": null
}
}
], - "thoroughfares": [
- {
- "type": {
- "name": null,
- "url": null,
- "technicalKey": null
}, - "shortName": "Lukasstr. 4",
- "number": "4",
- "value": "Lukasstraße 4",
- "name": "Lukasstraße",
- "direction": "221-bis Baker Street, North",
- "language": {
- "name": null,
- "technicalKey": null
}
}
], - "premises": [
- {
- "value": "Lukasstraße 4",
- "shortName": "Lukasstr. 4",
- "number": "4",
- "type": {
- "name": null,
- "url": null,
- "technicalKey": null
}, - "language": {
- "name": null,
- "technicalKey": null
}
}
], - "postalDeliveryPoints": [
- {
- "type": {
- "name": null,
- "url": null,
- "technicalKey": null
}, - "shortName": "St Gallen, Postfach 460",
- "number": "460",
- "value": "Postfach",
- "language": {
- "name": null,
- "technicalKey": null
}
}
], - "openingHours": [
- {
- "openingHour": "09:00 AM",
- "closingHour": "05:00 PM",
- "weekday": "Monday"
}
], - "geographicCoordinates": {
- "latitude": "47.439549",
- "longitude": "9.395275"
}, - "types": [
- {
- "name": "Legal Address",
- "technicalKey": "LEGAL_ADDRESS"
}
], - "formattedAddress": {
- "country": "Switzerland",
- "administrativeArea": "Sankt Gallen",
- "region": "Sankt Gallen",
- "regionCode": "9004",
- "locality": "Sankt Gallen",
- "district": "City center",
- "postalCode": "9000",
- "thoroughfare": "Lukassstrasse",
- "premise": "Lukasstraße 4, Building 2, Floor 3, Room 4",
- "interurbanDeliveryPoint": "Sankt Gallen, Postfach 460",
- "mailbox": "Postfach 460",
- "postOfficeBox": "Postfach 460"
}
}
], - "externalId": "The ID managed in the customer's SAP systems.",
- "jsonRecord": {
- "displayId": "SAP",
- "businessPartnerType": "organization",
- "organization": {
- "nameDetails": {
- "formattedOrgNameLine1": "SAP SE",
- "formattedOrgNameLine2": "Hasso-Plattner-Ring 7",
- "formattedOrgNameLine3": "69190 Walldorf",
- "formattedOrgNameLine4": "Germany",
- "formattedOrgName": "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany",
- "customSalutation": "Additional information",
- "scriptVariants": [
- {
- "formattedOrgNameLine1": null,
- "formattedOrgNameLine2": null,
- "formattedOrgNameLine3": null,
- "formattedOrgNameLine4": null,
- "formattedOrgName": null,
- "customSalutation": null,
- "scriptCode": { }
}
]
}, - "legalForm": {
- "name": "Code list entry name.",
- "code": "AG"
}, - "globalLocationNumber": "0847976000005"
}, - "identifications": [
- {
- "identificationType": {
- "name": "Code list entry name.",
- "code": "IDCARD"
}, - "identificationNumber": "DE123456789",
- "country": {
- "name": "Code list entry name.",
- "code": "DE"
}, - "region": {
- "name": "Code list entry name.",
- "code": "DE-BW"
}, - "institute": "Federal Republic of Germany"
}
], - "taxNumbers": [
- {
- "taxNumberType": {
- "name": "Code list entry name.",
- "code": "VAT"
}, - "taxNumber": "DE123456789"
}
], - "addressData": [
- {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "usages": [
- {
- "validFrom": null,
- "validTo": null,
- "usage": { },
- "isStandard": null
}
], - "postalAddressType": "organizationPostalAddress",
- "organizationPostalAddress": {
- "streetPrefix1": "StreetPrefix1",
- "streetPrefix2": "StreetPrefix1",
- "street": {
- "name": null,
- "ref": { }
}, - "streetSuffix1": "StreetSuffix1",
- "streetSuffix2": "StreetSuffix2",
- "houseNumber": "Building 1",
- "houseNumberSupplement": "2nd floor",
- "building": "Building 1",
- "floor": "2nd floor",
- "door": "Room 14",
- "careOf": "c/o John Doe",
- "primaryRegion": {
- "name": null,
- "code": null
}, - "secondaryRegion": {
- "name": null,
- "ref": { }
}, - "tertiaryRegion": {
- "name": null,
- "ref": { }
}, - "town": {
- "name": null,
- "ref": { }
}, - "district": {
- "name": null,
- "ref": { }
}, - "country": {
- "name": null,
- "code": null
}, - "postCode": "10115",
- "alternative": {
- "country": { },
- "postCode": null,
- "primaryRegion": { },
- "secondaryRegion": { },
- "tertiaryRegion": { },
- "town": { },
- "district": { },
- "deliveryType": { },
- "deliveryServiceType": null,
- "deliveryServiceQualifier": null,
- "deliveryServiceIdentifier": null
}, - "coordinates": {
- "latitude": null,
- "longitude": null,
- "altitude": null
}, - "scriptVariants": [
- { }
]
}, - "emailAddresses": {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
- "address": "developer-portal@cdq.com"
}, - "websites": {
- "validFrom": "2024-10-07T09:48:51Z",
- "validTo": "2024-10-07T09:48:51Z",
}
}
]
}, - "types": [
- {
- "name": "Legal Entity",
- "technicalKey": "LEGAL_ENTITY"
}
]
}
}
}