Skip to content

Data Validation API (3)

This API provides services used for business partner qualification

Data Validation API
Overview
URL

https://www.cdq.ch/team

Paweł Siwoń

pawel.siwon@cdq.com

Languages
Servers
Mock server

https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/

Production SOAP

https://api.corporate-data-league.ch/data-validation/soap/v3/

Production

https://api.corporate-data-league.ch/data-validation/

Qualification

Provides funcionalities for qualification of Business Partners. Includes endpoints that allow users to submit Business Partner data for qualification, retrieve qualification results, and handle various qualification scenarios.

Operations

Validation

Provides funcionalities for validation of Business Partner data.

Operations

Batch Validation

Provides funcionalities for validation of multiple records or entities in a single request. Includes endpoints that allow users to start validation jobs, poll the status of these jobs, and retrieve validation results.

Operations

Business Partners

Provides funcionalities for managing Business Partners. Includes endpoints that allow users to validate Business Partners against data quality rules.

Operations

Configuration

Provides funcionalities for managing configurations. Includes endpoints that allow users to create, update, and delete configurations for the current user.

Operations

List Users Configuration

Request

Fetches the current users' configuration. If no configuration exists, a default configuration is returned.

Security
basicAuth
Query
startAfterstring(StartAfter)

Start after the given index. Use this to paginate through the results. The first page is returned if this parameter is not provided.

Example: startAfter=5712566172571652
limitinteger(Limit)

Maximum number of results to return. The default is 100.

Example: limit=100
defaultConfigurationboolean

Is default workspace configuration of given type.

Example: defaultConfiguration=true
clientIdstring

API Key ID or Client ID. When present returns only configurations assigned to the given API key.

Example: clientId=12345678-1234-5678-1234-567812345678
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation

Responses

Successful operation

Bodyapplication/json
startAfterstring(StartAfter)

The ID which is used to read the page.

Example: "5712566172571652"
nextStartAfterstring(NextStartAfter)

Provides a value to be used as a startAfter in next page request.

Example: "5712566172571652"
totalinteger(PageTotal)

Total number of items which can be paged.

Example: "67"
valuesArray of objects(WorkspaceConfiguration)

List of configurations.

Response
application/json
{
  "startAfter": "0",
  "nextStartAfter": "1",
  "total": 2,
  "values": [
    { … },
    { … }
  ]
}

Create Configuration

Request

Creates a new configuration for the current user. The configuration is stored in the users workspace and can be used for validation of business partners and identifiers.

Security
basicAuth
Bodyapplication/json
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
featuresOnArray of strings(TransactionFeaturesOn)

Features to be enabled. Do not use CREATE_TRANSACTION and COMMIT_TRANSACTION at the same time.

Items Enum ValueDescription
CREATE_TRANSACTION

Creates a new transaction and makes the current request a part of it. By default, turned off.

COMMIT_TRANSACTION

Commit transaction. By default, turned off.

Example: ["CREATE_TRANSACTION"]
workspaceIdstring(WorkspaceId)

Uniquely identifying ID of the workspace.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
namestring

The name of the configuration.

Example: "Custom configuration name"
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

copiedFromobject(WorkspaceConfigurationCopiedFrom)

The configuration from which the new configuration is copied.

curl -i -X POST \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "demo config",
    "configuration": {
      "ignoredRules": [
        "https://meta.cdq.com/Care_of_information_misplaced_(business_partner_name)",
        "https://meta.cdq.com/Checkdigit_of_state_tax_number_(Brasil_-_Acre_(AC))"
      ],
      "activatedRules": [
        "https://meta.cdq.com/Business_partner_name_missing_(Name_LOCAL)"
      ],
      "featuresOff": [
        "ENRICH_LEGAL_FORM",
        "SHOW_DECISIONS"
      ],
      "featuresOn": [
        "SHOW_LOOKUP_RESULTS",
        "SHOW_BUSINESSPARTNER",
        "SHOW_DATA_DEFECTS"
      ],
      "ruleCategoriesOn": [
        {
          "url": "https://meta.cdq.ch/Missing_legal_form"
        }
      ],
      "criticalities": [
        {
          "businessRuleUrl": "https://meta.cdq.com/Dummy_post_code_detected_(AF)",
          "violationLevel": "WARNING"
        },
        {
          "businessRuleUrl": "https://meta.cdq.com/Unallowed_pattern_in_name_detected_(AF)",
          "violationLevel": "INFO"
        }
      ],
      "ruleStatuses": [
        "RELEASED"
      ],
      "dataSourcesOn": [
        {
          "prefix": "VIES"
        }
      ],
      "validationProfile": "EU_VAT_QUALIFICATION"
    }
  }'

Responses

Configuration created successfully

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "configuration": {
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "dataSourcesOn": [ … ],
    "featuresOff": [ … ],
    "featuresOn": [ … ],
    "criticalities": [ … ],
    "ruleStatuses": [ … ],
    "validationProfile": "EU_VAT_QUALIFICATION",
    "ruleCategoriesOn": [ … ]
  },
  "id": "63a1d5a1335faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579921335Z",
  "modifiedAt": "2022-12-20T15:32:49.579949313Z",
  "createdBy": "demo"
}

Fetch Configuration

Request

Fetches an existing configuration for the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4

Responses

Configuration updated successful.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "configuration": {
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "dataSourcesOn": [ … ],
    "featuresOff": [ … ],
    "featuresOn": [ … ],
    "criticalities": [ … ],
    "ruleStatuses": [ … ],
    "validationProfile": "EU_VAT_QUALIFICATION",
    "ruleCategoriesOn": [ … ]
  },
  "id": "63a1d5a13b5faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579Z",
  "modifiedAt": "2022-12-20T15:32:49.579Z",
  "createdBy": "demo"
}

Update Configuration

Request

Updates an existing configuration for the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
Bodyapplication/json
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
featuresOnArray of strings(WorkspaceConfigurationUpdateFeaturesOn)

Features to be enabled.

Items ValueDescription
REEVALUATION_ON_CHANGES

Re-evaluates business partners based on changes in the configuration.

Example: ["REEVALUATION_ON_CHANGES"]
namestring

The name of the configuration.

Example: "Custom configuration name"
defaultConfigurationboolean

Is default workspace configuration. Only one configuration of the same type can be a default configuration in a given workspace.

Default false
Example: true
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

curl -i -X PUT \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4 \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "demo config",
    "configuration": {}
  }'

Responses

Configuration updated successful.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "id": "63a1d5a13b5faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579Z",
  "modifiedAt": "2022-12-20T15:43:43.158949713Z",
  "createdBy": "demo"
}

Delete Configuration

Request

Deletes a configuration for the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
Query
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: transactionId=8e37da1e-ee9d-4ee0-b03d-24a1f89988f2
featuresOnArray of strings(TransactionFeatureParam)

Features to be enabled. Do not use CREATE_TRANSACTION and COMMIT_TRANSACTION at the same time.

Items Enum ValueDescription
CREATE_TRANSACTION

Creates a new transaction and makes the current request a part of it. By default, turned off.

COMMIT_TRANSACTION

Commit transaction. By default, turned off.

Example: featuresOn=CREATE_TRANSACTION
curl -i -X DELETE \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4

Responses

OK.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "configurationId": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "version": 1,
  "configuration": {
    "validationProfile": "QUICK",
    "ruleStatuses": [ … ],
    "featuresOn": [ … ],
    "featuresOff": [ … ],
    "ruleCategoriesOn": [ … ],
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "criticalities": [ … ],
    "dataSourcesOn": [ … ],
    "dataSourcesOff": [ … ],
    "violationMessages": [ … ]
  },
  "createdAt": "2020-08-31T16:47+00:00",
  "modifiedAt": "2020-08-31T16:47+00:00",
  "createdBy": "76248934691294444",
  "transactionId": "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
}

Read Business Partner Validation Configuration Version

Request

Read a specific version of a business partner validation configuration by id and version number.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
versionintegerrequired

Version number of the configuration.

Example: 1
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/businesspartnervalidation/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4/versions/1

Responses

Successful operation.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
namestring

The name of the configuration

Example: "Configuration Name"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring

Date and time when the first version of the configuration was created (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring

Date and time when this version of the configuration was created (ISO 8601-compliant).

Example: "2020-08-22T13:45+00:00"
createdBystring

User who created the first version of the configuration.

Example: "69129435489347624"
modifiedBystring

User who created this version of the configuration.

Example: "76248934691294444"
Response
application/json
{
  "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "name": "Configuration Name",
  "configurationId": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "version": 1,
  "configuration": {
    "validationProfile": "QUICK",
    "ruleStatuses": [ … ],
    "featuresOn": [ … ],
    "featuresOff": [ … ],
    "ruleCategoriesOn": [ … ],
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "criticalities": [ … ],
    "dataSourcesOn": [ … ],
    "dataSourcesOff": [ … ],
    "violationMessages": [ … ]
  },
  "createdAt": "2020-08-31T16:47+00:00",
  "modifiedAt": "2020-08-22T13:45+00:00",
  "createdBy": "69129435489347624",
  "modifiedBy": "76248934691294444"
}

List Tax Guard Identifier Qualification Configurations.

Request

List all Tax Guard Identifier Qualification configurations of the current user.

Security
basicAuth
Query
limitinteger(Limit)

Maximum number of configurations to return. Used for pagination.

Example: limit=100
startAfterstring(StartAfter)

ID of the last configuration returned in the previous request. Used for pagination.

Example: startAfter=5712566172571652
defaultConfigurationboolean

Limit search to configurations with provided default flag value. If left empty, all configurations will be returned.

Default null
Example: defaultConfiguration=true
clientIdstring

API Key ID or Client ID. When present returns only configurations assigned to the given API key.

Example: clientId=12345678-1234-5678-1234-567812345678
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification

Responses

Successful operation

Bodyapplication/json
startAfterstring(StartAfter)

The ID which is used to read the page.

Example: "5712566172571652"
nextStartAfterstring(NextStartAfter)

Provides a value to be used as a startAfter in next page request.

Example: "5712566172571652"
totalinteger(PageTotal)

Total number of items which can be paged.

Example: "67"
valuesArray of objects(WorkspaceConfiguration)

List of configurations.

Response
application/json
{
  "startAfter": "0",
  "nextStartAfter": "1",
  "total": 2,
  "values": [
    { … },
    { … }
  ]
}

Create Tax Guard Identifier Qualification Configuration

Request

Create a new Tax Guard Identifier Qualification configuration for the current user.

Security
basicAuth
Bodyapplication/json
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
featuresOnArray of strings(TransactionFeaturesOn)

Features to be enabled. Do not use CREATE_TRANSACTION and COMMIT_TRANSACTION at the same time.

Items Enum ValueDescription
CREATE_TRANSACTION

Creates a new transaction and makes the current request a part of it. By default, turned off.

COMMIT_TRANSACTION

Commit transaction. By default, turned off.

Example: ["CREATE_TRANSACTION"]
workspaceIdstring(WorkspaceId)

Uniquely identifying ID of the workspace.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
namestring

The name of the configuration.

Example: "Custom configuration name"
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

copiedFromobject(WorkspaceConfigurationCopiedFrom)

The configuration from which the new configuration is copied.

curl -i -X POST \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "demo config",
    "configuration": {
      "ignoredRules": [
        "https://meta.cdq.com/Care_of_information_misplaced_(business_partner_name)",
        "https://meta.cdq.com/Checkdigit_of_state_tax_number_(Brasil_-_Acre_(AC))"
      ],
      "activatedRules": [
        "https://meta.cdq.com/Business_partner_name_missing_(Name_LOCAL)"
      ],
      "featuresOff": [
        "SHOW_DEBUG_INFO"
      ],
      "featuresOn": [
        "SHOW_LOOKUP_RESULTS",
        "SHOW_BUSINESS_PARTNER"
      ],
      "ruleCategoriesOn": [
        {
          "url": "https://meta.cdq.ch/Missing_legal_form"
        }
      ],
      "criticalities": [
        {
          "businessRuleUrl": "https://meta.cdq.com/Dummy_post_code_detected_(AF)",
          "violationLevel": "WARNING"
        },
        {
          "businessRuleUrl": "https://meta.cdq.com/Unallowed_pattern_in_name_detected_(AF)",
          "violationLevel": "INFO"
        }
      ],
      "ruleStatuses": [
        "RELEASED"
      ],
      "dataSourcesOn": [
        {
          "prefix": "VIES"
        }
      ],
      "qualificationProfile": "EU_TAX_QUALIFICATION"
    }
  }'

Responses

Configuration created successfully

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "configuration": {
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "dataSourcesOn": [ … ],
    "featuresOff": [ … ],
    "featuresOn": [ … ],
    "criticalities": [ … ],
    "ruleStatuses": [ … ],
    "qualificationProfile": "EU_TAX_QUALIFICATION",
    "ruleCategoriesOn": [ … ]
  },
  "id": "63a1d5a1335faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579921335Z",
  "modifiedAt": "2022-12-20T15:32:49.579949313Z",
  "createdBy": "demo"
}

Read Tax Guard Identifier Qualification Configuration

Request

Read an Tax Guard Identifier Qualification configuration of the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4

Responses

Successful operation

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "configuration": {
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "dataSourcesOn": [ … ],
    "featuresOff": [ … ],
    "featuresOn": [ … ],
    "criticalities": [ … ],
    "ruleStatuses": [ … ],
    "qualificationProfile": "EU_VAT_QUALIFICATION",
    "ruleCategoriesOn": [ … ]
  },
  "id": "63a1d5a13b5faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579Z",
  "modifiedAt": "2022-12-20T15:32:49.579Z",
  "createdBy": "demo"
}

Update Tax Guard Identifier Qualification Configuration

Request

Update an Tax Guard Identifier Qualification configuration of the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
Bodyapplication/json
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
featuresOnArray of strings(WorkspaceConfigurationUpdateFeaturesOn)

Features to be enabled.

Items ValueDescription
REEVALUATION_ON_CHANGES

Re-evaluates business partners based on changes in the configuration.

Example: ["REEVALUATION_ON_CHANGES"]
namestring

The name of the configuration.

Example: "Custom configuration name"
defaultConfigurationboolean

Is default workspace configuration. Only one configuration of the same type can be a default configuration in a given workspace.

Default false
Example: true
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

curl -i -X PUT \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4 \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "demo config",
    "configuration": {}
  }'

Responses

Configuration Tax Guard Identifier Qualification updated successfully

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "name": "demo config",
  "id": "63a1d5a13b5faf2f613164c0",
  "createdAt": "2022-12-20T15:32:49.579Z",
  "modifiedAt": "2022-12-20T15:43:43.158949713Z",
  "createdBy": "demo"
}

Delete Tax Guard Identifier Qualification Configuration

Request

Delete an Tax Guard Identifier Qualification configuration for the current user.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
curl -i -X DELETE \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4

Responses

OK.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring(CreatedAt)

Date of creation (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring(ModifiedAt)

Date of modification (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
createdBystring(CreatedBy)

Creator of a resource.

Example: "76248934691294444"
transactionIdstring(TransactionId)

ID of the transaction, pass it in subsequent requests to make them part of the transaction.

Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
Response
application/json
{
  "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "configurationId": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "version": 1,
  "configuration": {
    "validationProfile": "QUICK",
    "ruleStatuses": [ … ],
    "featuresOn": [ … ],
    "featuresOff": [ … ],
    "ruleCategoriesOn": [ … ],
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "criticalities": [ … ],
    "dataSourcesOn": [ … ],
    "dataSourcesOff": [ … ],
    "violationMessages": [ … ]
  },
  "createdAt": "2020-08-31T16:47+00:00",
  "modifiedAt": "2020-08-31T16:47+00:00",
  "createdBy": "76248934691294444",
  "transactionId": "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"
}

Read Tax Guard Identifier Qualification Configuration Version

Request

Read a specific version of an Tax Guard Identifier Qualification configuration by id and version number.

Security
basicAuth
Path
configurationIdstringrequired

ID of the configuration.

Example: c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4
versionintegerrequired

Version number of the configuration.

Example: 1
curl -i -X GET \
  -u <username>:<password> \
  https://idp.cdq.com/_mock/apis/data-validation-api/api-v3/configurations/qualification/c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4/versions/1

Responses

Successful operation.

Bodyapplication/json
idstring

Unique identifier of the business partner validation configuration version. Not to be confused with the configuration ID.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
namestring

The name of the configuration

Example: "Configuration Name"
configurationIdstring(schemas-ConfigurationId)

Uniquely identifies a configuration.

Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
versioninteger(ConfigurationVersionNumber)

Version number of the configuration.

Example: 1
configurationobject(BusinessPartnerValidationConfiguration)

Configuration of the validation process for a single Business Partner record.

createdAtstring

Date and time when the first version of the configuration was created (ISO 8601-compliant).

Example: "2020-08-31T16:47+00:00"
modifiedAtstring

Date and time when this version of the configuration was created (ISO 8601-compliant).

Example: "2020-08-22T13:45+00:00"
createdBystring

User who created the first version of the configuration.

Example: "69129435489347624"
modifiedBystring

User who created this version of the configuration.

Example: "76248934691294444"
Response
application/json
{
  "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "name": "Configuration Name",
  "configurationId": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4",
  "version": 1,
  "configuration": {
    "validationProfile": "QUICK",
    "ruleStatuses": [ … ],
    "featuresOn": [ … ],
    "featuresOff": [ … ],
    "ruleCategoriesOn": [ … ],
    "ignoredRules": [ … ],
    "activatedRules": [ … ],
    "criticalities": [ … ],
    "dataSourcesOn": [ … ],
    "dataSourcesOff": [ … ],
    "violationMessages": [ … ]
  },
  "createdAt": "2020-08-31T16:47+00:00",
  "modifiedAt": "2020-08-22T13:45+00:00",
  "createdBy": "69129435489347624",
  "modifiedBy": "76248934691294444"
}

Public

Provides funcionalities to provide an RDF model of a record and validate a Business Partner.

Operations

Records

Provides funcionalities for managing records. Includes endpoints that allow users to validate records.

Operations

Processing Logs

Provides funcionalities for managing processing logs. Includes endpoints that allow users to read processing log results.

Operations