Public

Rdificate Custom RecordDeprecated

Rdificate a custom record. It returns rdf model of the record.

SecurityapiKey

Request

Request Body schema: application/json

baseURL required	string Base. Example: "http://meta.cdq.com/"
	object JSON object that will be RDFied. Record and jsonRecord cannot be present at the same time. Example: "{'recordId': 'id', 'name': 'demo'}"
knowledgeGraphId	string Knowledge Graph that contains required configuration for test cases rdfication process. Example: "kg_1_m_1"
pathToReferenceId required	string JSON path that can locate attribute, in case of non-existent path selection will fall back to referenceIdTag. Example: "\\fullPath\\recordId"
record	string Stringified data that will be RDFied. Record and jsonRecord cannot be present at the same time. Example: "{\\\"recordId\\\":\\\"id\\\",\\\"name\\\":\\\"demo\\\"}"
referenceIdTag required	string Name of the attribute that should be used as a main identifier for all triples generated based on the data sent. Will use first found value of an attribute with given name. Example: "record_id"
rootPrefix required	string Prefix that is used for generating TTL triples. Single resource URI is created by baseUrl + rootPrefix + encodedJSONPath ex. http://meta.cdq.com/data/name. Example: "data"

Responses

200

post/records/rdfify

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"jsonRecord": "{'recordId': 'id', 'name': 'demo'}",
"baseURL": "http://meta.cdq.com/",
"record": "{\\\"recordId\\\":\\\"id\\\",\\\"name\\\":\\\"demo\\\"}",
"referenceIdTag": "record_id",
"pathToReferenceId": "\\fullPath\\recordId",
"rootPrefix": "data",
"knowledgeGraphId": "kg_1_m_1"
}

Response samples

{"rdfRecord": "<http://monitor.test.cdq.com/380bdf33-ad17-41bc-a3e5-78b27befdca9> a <http://monitor.test.cdq.com/Record>; <http://monitor.test.cdq.com/Property/Has_record_id> '92912918-a85c-4d77-9f62-3b2ddb57a279'; <http://monitor.test.cdq.com/Property/Name> 'demo' ."
}

Validate Business PartnerDeprecated

Validates a Business Partner against data quality rules.

SecurityapiKey

Request

Request Body schema: application/json

activatedRules

Array of strings (BusinessRuleUrl)

Urls of cdl rules that are active during validation process.

Example: ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"]

bzstPrint

string

Request printed confirmation by German BZSt authority.

Example: "true"

configurationId

string (ConfigurationId)

Configuration ID used to set up data validation request. If provided, those parameters will be overridden:

profile
featuresOn
featuresOff

Example: "6513d25b63cf07787018790a"

Array of objects (Criticality)

Array of objects (DataSource)

Rules with data sources passed here are not used in validation process.

Array of objects (DataSource)

If data sources are disabled by feature toggle you can enable some of them passing their prefixes here.

featuresOff

Array of strings (ValidationFeature)

List of deactivated features.

Items Enum:	Description
ADDRESS_CHECKS	CDQ data quality profiling services enable the validation of addresses with respect to different data quality criteria.
BANKING_DATA_CHECKS	CDQ data quality profiling services enable the validation of bank master data with respect to different data quality criteria.
BUSINESS_PARTNER_CHECKS	Validate concepts that basically establish a business partner (e.g. name and legal form).
COUNTRY_CHECKS	Validate country information.
ENRICH_CATEGORIES	Enrich a CDL community standardized business partner category for a given entity.
ENRICH_DATA_MIRROR_CHANGES	Enriches the data with changes from the data mirror.
ENRICH_LEGAL_FORM	Identify and enriches the legal form of a company.
EU_VAT_QUALIFICATION_AT	Enforces to use AT.FON data source to qualify EU VATs.
EU_VAT_QUALIFICATION_DE	Enforces to use BZST data source for non-German business partners.
EU_VAT_QUALIFICATION_STANDARD	For a given EU VAT, it is checked whether the name and address are really associated with this identifier (same information maintained in the VAT register as provided by the user).
EXTERNAL_SOURCES_OFF	Turns off external data sources.
FORCE_EXTERNAL_CALL	Force external call.
IDENTIFIER_CHECKS	Validate business (VAT, tax, business register IDs) and location identifiers against different data quality rules categories.
IDENTIFIER_QUALIFICATION	Turns on identifier qualification (standard) which enables to qualify EU VAT identifiers.
LAB_BETA	Deprecated feature.
QUALIFICATION_SILENT_MODE	If enabled all exceptions occurring within execution of business rules are ignored. If not enabled then execution error will result in creating data defect. By default, part of profile QUALIFICATION.
SHOW_BUSINESSPARTNER	Shows business partner that was used in the request.
SHOW_DATA_DEFECTS	Shows found data defects - usually it is turned on.
SHOW_DEBUG_INFO	Shows additional information about validation process (number of applied rules, used categories, failed executions etc.).
SHOW_DECISIONS	Deprecated feature.
SHOW_LOOKUP_RESULTS	Displays results from the lookup endpoint (usually enriched data in comparison to the original business partner requested).
SHOW_QUALIFICATION_DECISIONS	Shows qualification decisions - used only in qualification endpoint in API v3. In APIv1 and APIv2 it is used in validation endpoint.
USE_SPARQL_VALIDATOR	Deprecated feature.

Example: ["SHOW_LOOKUP_RESULTS"]

featuresOn

Array of strings (ValidationFeature)

List of activated features.

Items Enum:	Description
ADDRESS_CHECKS	CDQ data quality profiling services enable the validation of addresses with respect to different data quality criteria.
BANKING_DATA_CHECKS	CDQ data quality profiling services enable the validation of bank master data with respect to different data quality criteria.
BUSINESS_PARTNER_CHECKS	Validate concepts that basically establish a business partner (e.g. name and legal form).
COUNTRY_CHECKS	Validate country information.
ENRICH_CATEGORIES	Enrich a CDL community standardized business partner category for a given entity.
ENRICH_DATA_MIRROR_CHANGES	Enriches the data with changes from the data mirror.
ENRICH_LEGAL_FORM	Identify and enriches the legal form of a company.
EU_VAT_QUALIFICATION_AT	Enforces to use AT.FON data source to qualify EU VATs.
EU_VAT_QUALIFICATION_DE	Enforces to use BZST data source for non-German business partners.
EU_VAT_QUALIFICATION_STANDARD	For a given EU VAT, it is checked whether the name and address are really associated with this identifier (same information maintained in the VAT register as provided by the user).
EXTERNAL_SOURCES_OFF	Turns off external data sources.
FORCE_EXTERNAL_CALL	Force external call.
IDENTIFIER_CHECKS	Validate business (VAT, tax, business register IDs) and location identifiers against different data quality rules categories.
IDENTIFIER_QUALIFICATION	Turns on identifier qualification (standard) which enables to qualify EU VAT identifiers.
LAB_BETA	Deprecated feature.
QUALIFICATION_SILENT_MODE	If enabled all exceptions occurring within execution of business rules are ignored. If not enabled then execution error will result in creating data defect. By default, part of profile QUALIFICATION.
SHOW_BUSINESSPARTNER	Shows business partner that was used in the request.
SHOW_DATA_DEFECTS	Shows found data defects - usually it is turned on.
SHOW_DEBUG_INFO	Shows additional information about validation process (number of applied rules, used categories, failed executions etc.).
SHOW_DECISIONS	Deprecated feature.
SHOW_LOOKUP_RESULTS	Displays results from the lookup endpoint (usually enriched data in comparison to the original business partner requested).
SHOW_QUALIFICATION_DECISIONS	Shows qualification decisions - used only in qualification endpoint in API v3. In APIv1 and APIv2 it is used in validation endpoint.
USE_SPARQL_VALIDATOR	Deprecated feature.

Example: ["SHOW_LOOKUP_RESULTS"]

ignoredRules

Array of strings (BusinessRuleUrl)

Urls of cdl rules ignored during validation process.

Example: ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"]

profile

string (ValidationProfile)

Profile which is used during validation. Default value is STANDARD.

Enum:	Description
QUICK	This profile checks data quality of records in a quick way, i.e. data quality rules that have a negative impact on performance.
STANDARD	This profile checks data quality using CDQ's standard configuration.
QUALIFICATION	Deprecated.
AUTOMATION	Deprecated.
EU_VAT_QUALIFICATION	This profile qualifies EU VATs using CDQ's default configuration of data quality rules for qualified checks of EU VATs
DATA_SHARING_QUALITY_GATE	Quality checks ensure that only valid data enters the CDQ Community Data Pool
IDENTIFIER_QUALITY	This profile checks identifiers with a standard configuration of data quality rules. It does not comprise qualified checks of identifiers regarding e.g. name or address.
ADDRESS_QUALITY	This profile checks addresses with a standard configuration of data quality rules.
WORLDWIDE_IDENTIFIER_QUALIFICATION	This profile qualifies any supported business identifier (e.g. tax numbers) worldwide using CDQ's default configuration of data quality rules for qualified checks of a particular identifier
FEATURES_OFF	This profile turns off any qualification rules and is designed for custom rules selection.

Example: "QUICK"

Array of objects (RuleCategoryOn)

Categories use for selecting active business rules.

ruleStatuses

Array of strings (RuleStatus)

Enable rules with provided statuses.

Items Enum:	Description
RELEASED	Rule was moved from status PLANNED automatically during daily testing or by manual maintenance.
DRAFT	Rule was created as a draft and it will be not executed.
HYPERCARE	Rule was moved from status DEACTIVATED automatically during daily testing.

Example: ["RELEASED"]

object (ValidationSource)

Source of the validation.

vatAtRequestor

string

Deprecated

DEPRECATED, use organizational settings to configure.

The requestor’s VAT identifier, required for execution of requests against external data sources.

Example: "AT123456789"

vatDeRequestor

string

Deprecated

DEPRECATED, use organizational settings to configure.

The requestor’s VAT identifier, required for execution of requests against external data sources.

Example: "DE123456789"

Responses

200

post/businesspartners/validate

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"profile": "QUICK",
"ruleStatuses": ["RELEASED"
],
"featuresOn": ["SHOW_LOOKUP_RESULTS"
],
"featuresOff": ["SHOW_LOOKUP_RESULTS"
],
"ruleCategoriesOn": [{"url": "https://meta.cdq.com/Identifier_checkdigit"
}
],
"dataSourcesOn": [{"prefix": "VIES"
}
],
"dataSourcesOff": [{"prefix": "VIES"
}
],
"vatAtRequestor": "AT123456789",
"vatDeRequestor": "DE123456789",
"bzstPrint": "true",
"validationSource": {"type": {"technicalKey": "VALIDATION_GRAPH",
"description": "Default CDL Model"
},
"value": "CDL"
},
"ignoredRules": ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
],
"activatedRules": ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
],
"criticalities": [{"businessRuleUrl": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))",
"violationLevel": "INFO"
}
],
"configurationId": "6513d25b63cf07787018790a"
}

Response samples

{"dataDefects": [{"validationSource": {"type": {"technicalKey": "VALIDATION_GRAPH",
"description": "Default CDL Model"
},
"value": "CDL"
},
"businessRule": {"name": "Identifier unknown (European value added tax identifier (The Netherlands))",
"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))",
"ruleStatus": "RELEASED",
"violationMessage": "Business Partner identifier is mandatory.",
"violationLevel": "INFO"
},
"executionContextProperties": [{"type": "businessPartner.identifiers.value",
"value": "STREET"
}
],
"categories": [{"url": "https://meta.cdq.com/Identifier_checkdigit",
"name": "Identifier checkdigit"
}
]
}
],
"qualificationResult": {"sourceData": [{"key": "addrz1",
"value": "CH-9000"
}
],
"formattedSourceData": {"code": "ATU12345678",
"message": "Message to be filled in.",
"businessPartnerName": "Muster AG",
"postCodeValue": "9000",
"thoroughfareValue": "Hauptstrasse",
"localityValue": "München"
},
"validatorStatus": "ONLINE",
"validatorMessage": "VAT ID is valid.",
"qualifiedBy": {"type": {"technicalKey": "VALIDATION_GRAPH",
"description": "Default CDL Model"
},
"value": "CDL"
},
"qualifiedAt": "2024-11-22T13:19:51Z",
"addressQualification": "QUALIFIED",
"addressQualificationDetails": {"localityQualification": "QUALIFIED",
"postCodeQualification": "QUALIFIED",
"thoroughfareNumberQualification": "QUALIFIED",
"thoroughfareQualification": "QUALIFIED"
},
"identifierValidity": "VALID",
"businessPartnerNameQualification": "QUALIFIED",
"overallQualification": "QUALIFIED"
},
"lookupResults": [{"businessPartner": {"id": "63e635235c06b7396330fe40",
"externalId": "The ID managed in the customer's SAP systems.",
"addresses": ["Lukasstraße 4, 9008 St. Gallen"
],
"names": ["Corporate Data Quality AG"
],
"identifiers": ["VAT identification number"
],
"legalForm": "Aktiengesellschaft",
"bankAccounts": [{"internationalBankAccountIdentifier": "CH8800781619278412000",
"internationalBankIdentifier": "KBSGCH22XXX",
"nationalBankAccountIdentifier": "619278412000",
"nationalBankIdentifier": "00781",
"bank": {"name": "Sparda Bank",
"branch": "Filiale München",
"address": {"localities": [ ],
"country": null,
"administrativeAreas": [ ],
"postCodes": [ ],
"thoroughfares": [ ]
}
}
}
],
"status": {"officialDenotation": "Good Standing",
"validFrom": "2024-11-22T13:19:51Z",
"validUntil": "2024-11-22T13:19:51Z",
"type": "In Liquidation"
},
"profile": {"contactEmails": ["developer-portal@cdq.com"
]
}
},
"address": "Lukasstraße 4, 9008 St. Gallen",
"matchingScore": "0.9",
"dataSource": "648824a691d8d2503d65103e",
"cdqId": "VIES:DE119267630"
}
],
"summary": {"validationLevel": "ERROR",
"dataQualityRecordStatus": {"name": "No issues found",
"description": "All rules have been executed, and we have found no data quality issues.",
"technicalKey": "NO_ISSUES_FOUND"
},
"action": "FULL_CHECK",
"statistics": {"numberOfInfoDataDefects": "10",
"numberOfErrorDataDefects": "10",
"numberOfWarningDataDefects": "10"
}
},
"debugInfo": {"externalServiceResponses": [{"status": "200",
"message": "There is no more quota left for this Data Source.",
"path": "/data-validation/businesspartners/validate",
"details": "Detailed message",
"timestamp": "2024-11-22T13:19:51Z",
"additionalInformation": [{"key": "requestId",
"value": "WAPIAAAAYse8yTdE"
}
]
}
],
"businessRulesExecutionSummary": {"numberOfRules": "274",
"numberOfExecutions": "273",
"numberOfFails": "1",
"failures": [{"externalId": "955775",
"message": "Message to be filled in.",
"businessRule": {"name": "Identifier unknown (European value added tax identifier (The Netherlands))",
"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))",
"ruleStatus": "RELEASED"
}
}
],
"warnings": [{"message": "Message to be filled in."
}
],
"dataSourcesOn": [{"prefix": "VIES"
}
],
"dataSourcesOff": [{"prefix": "VIES"
}
],
"activatedRules": ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
],
"ignoredRules": ["https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"
],
"ruleCategoriesOn": [{"url": "https://meta.cdq.com/Identifier_checkdigit"
}
],
"ruleStatuses": ["RELEASED"
],
"violationLevels": ["INFO"
]
}
},
"identifierResults": [{"property": {"value": "DE119267630",
"type": "EU_VAT_ID_DE"
},
"reliabilityLevel": {"name": "Identifier existence",
"url": "https://meta.cdq.com/Identifier_existence",
"value": "4",
"checks": [{"name": "Identifier existence",
"url": "https://meta.cdq.com/Identifier_existence",
"value": "4",
"status": "OK",
"validity": {"name": "Valid",
"description": "Identifier check was executed with success, confirms that identifier is meeting requirement for check to pass.",
"technicalKey": "VALID"
},
"message": "External service error."
}
]
},
"qualificationDecisions": [{"properties": [{"content": "DE12345678",
"contentSelector": "$.partnerProfile.minorityIndicator.value",
"name": "Minority Indicator Value",
"url": "http://meta.cdq.com/Business_Partner/Identifier_Value",
"rootConcept": {"id": null,
"idSelector": null,
"name": null,
"url": null
},
"parentConcept": {"id": null,
"idSelector": null,
"name": null,
"url": null
}
}
],
"businessRule": {"name": "Identifier unknown (European value added tax identifier (The Netherlands))",
"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))",
"ruleStatus": "RELEASED"
},
"qualificationTarget": "STREET",
"decision": "VALID",
"cdqId": "VIES:DE119267630",
"dataSource": "VIES",
"identifierValue": "DE119267630",
"identifierType": "EU_VAT_ID_DE",
"errorMessage": "Example.",
"externalServiceResponse": {"status": "200",
"message": "There is no more quota left for this Data Source.",
"path": "/data-validation/businesspartners/validate",
"details": "Detailed message",
"timestamp": "2024-11-22T13:19:51Z",
"additionalInformation": [{"key": null,
"value": null
}
]
}
}
]
}
],
"businessPartner": {"names": ["Corporate Data Quality AG"
],
"legalForm": "Aktiengesellschaft",
"identifiers": ["VAT identification number"
],
"categories": ["Hotel"
],
"status": {"officialDenotation": "Good Standing",
"validFrom": "2024-11-22T13:19:51Z",
"validUntil": "2024-11-22T13:19:51Z",
"type": "In Liquidation"
},
"addresses": ["Lukasstraße 4, 9008 St. Gallen"
],
"externalId": "The ID managed in the customer's SAP systems.",
"profile": {"contactEmails": ["developer-portal@cdq.com"
]
},
"formattedSapRecord": {"name1": "CDQ AG",
"name2": "CDQ AG",
"name3": "CDQ AG",
"name4": "CDQ AG",
"nameCo": "Aktiengesellschaft",
"legalEntity": "Aktiengesellschaft",
"legalForm": "Aktiengesellschaft",
"indSector": "NAF",
"narp": "Friedrich Nietzsche",
"stceg": "CHE-218.608.88",
"stcd1": "CHE-218.608.88",
"stcd2": "CHE-218.608.88",
"stcd3": "CHE-218.608.88",
"stcd4": "CHE-218.608.88",
"stcd5": "CHE-218.608.88",
"url": "www.cdq.com",
"telNumber": "+41 71 571 10 40",
"country": "Switzerland",
"countryCode": "CH",
"region": "Sankt Gallen",
"regionCodeSap": "9004",
"regionCode": "9004",
"county": "Sankt Gallen",
"countyCode": "9004",
"township": "Sankt Gallen",
"townshipCode": "9004",
"city": "Sankt Gallen",
"district": "St. Georgen",
"postalCode": "9000",
"postalCode3": "9000",
"street1": "Lukasstraße 4",
"street2": "Lukasstraße 4",
"street5": "Lukasstraße 4",
"houseNum": "4",
"houseNum2": "4",
"building": "Office 2",
"floor": "2",
"roomnumber": "123",
"poBoxCountry": "9000",
"poBoxCity": "9000",
"poBoxPostalCode": "9000",
"poBox": "9000",
"latitude": "47.439549",
"longitude": "9.395275"
},
"relations": ["Commercial ultimate"
],
"bankAccounts": [{"internationalBankAccountIdentifier": "CH8800781619278412000",
"internationalBankIdentifier": "KBSGCH22XXX",
"nationalBankAccountIdentifier": "619278412000",
"nationalBankIdentifier": "00781",
"bank": {"name": "Sparda Bank",
"branch": "Filiale München",
"address": {"localities": ["Sankt Gallen"
],
"country": "Switzerland CH",
"administrativeAreas": ["Sankt Gallen"
],
"postCodes": ["9000"
],
"thoroughfares": ["Lukasstraße 4"
]
}
},
"countryCode": "DE"
}
],
"types": [{"name": "Legal Entity",
"url": "https://meta.cdq.com/Business_partner/type",
"technicalKey": "LEGAL_ENTITY"
}
],
"externalContext": "LIFNR",
"id": "63e635235c06b7396330fe40",
"lastModifiedAt": "2024-11-22T13:19:51Z"
},
"rulesInError": [{"businessRule": {"name": "Identifier unknown (European value added tax identifier (The Netherlands))",
"url": "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))",
"ruleStatus": "RELEASED"
},
"executionStatus": "500",
"error": {"timestamp": "2024-11-22T13:19:51Z",
"message": "This user is not allowed to access this service.",
"error": "BAD_REQUEST",
"path": "/v2/businesspartners/lookup",
"status": "400",
"id": "REF_VIES_SERVICE_UNAVAILABLE_300"
},
"ruleResult": "parentConceptIdSelector = 'businessPartner.identifiers.technicalKey', content = '1633582012931231', parentConceptUrl='https://meta.cdq.com/Business_partner/identifier', recordId = '451ff2f9-8182-43fc-9728-aad9ce62d771', contentSelector = 'businessPartner.identifiers.value', contentSelectorUrl = 'https://meta.cdq.com/Business_partner/identifier/value', parentConceptId = 'EE_BRN'",
"violationLevel": "INFO",
"validationSource": "CDQ"
}
]
}