Tutorial: How to qualify a Business Partner with local registers?
Overview
Use case
CDQ's Qualification service was designed and implemented to provide a robust and easy-to-understand qualification methodology for Business Partners. Currently, the service supports 18 external data sources, with only three of them supporting EU VAT identifiers. With appropriate usage, Business Partners can be qualified in the context of local (national) reference data sources (official registers). The following examples present some useful tips on qualifying Business Partners using any supported reference data set. It's important to note that to qualify against any data source (exceptVIES
, AT.FON
, BZST
, or other European data
sources), the profile needs to be set to WORLDWIDE_TAX_QUALIFICATION (if only European registers are used, the EU_TAX_QUALIFICATION
profile can be used as well), and the necessary data sources must be provided. If there's no qualification rule for a Business
Partner's attribute, the NOT_PROCESSED
decision will be returned.Documentation
For more details check the endpoint's documentation.
Learning Goals
In this tutorial, the user focuses on:
- Qualifying a Business Partner using local registers
- Understanding the qualification results
- Analyzing the qualification results
Prerequisites
Authorization
Before trying CDQ APIs, user must be authenticated:
- Paste the API Key in the console's security bar into the
X-API-KEY
field.
- After pasting the API Key, the green padlock will appear.
Be careful
Green padlock doesn't mean that the API Key was pasted correctly.
- Check your API key for missing characters or extra space before trying.
No API Key?
- Check how to get one on authentication page.
- Follow the steps above.
Qualification process
info
Before starting the qualification of the Business Partner, it's important to understand the qualification process well. Check the Qualification Process in CDQ Knowledge Base.
Step 1: Qualification of a Business Partner using local registers
In this step, the user will qualify a Business Partner using local registers. The user can select one of the following examples:
Example name | Description |
---|---|
Qualification of a Czech Business Partner | This example is dedicated to a Czech Business Partner qualification. In this case, the WORLDWIDE_TAX_QUALIFICATION profile will be used, and an additional dataSources field with the CZ.REE value. |
Qualification of an Australian Business Partner | This example focuses on an Australian Business Partner qualification. Currently, there are only two rules for qualifying such a Business Partner: name and postcode. Thus, the identifier qualification is approached similarly to the method outlined in the first example of this section. It is important to note that Australia is the only country with just two rules; in all other supported countries, there are at least four rules, which include qualification of postcode, name, thoroughfare, and locality. For VIES , BZST , and AT.FON , typically five rules apply, with the additional rule concerning the qualification of a Business Partner's identifier. |
Qualification of a Polish Business Partner | This example is dedicated to a Polish Business Partner qualification against two registers together: a local one (NOBR ) and a European one (VIES ). In this case, qualification will be done separately for each data source and each identifier. |
To qualify a Business Partner with local registers:
- Use the Qualify Business Partner endpoint to send the below request,
- Select one of the below examples,
- Send the request.
info
Step 2: Understand the qualification results
Response components explanation
The response from the qualification endpoint includes a new field calledqualificationResults
, which contains entries for
each identifier of a Business Partner based on the data sources it was checked against. Each qualificationResults
entry
consists of two main components:- the
qualificationDecisionSummary
, which provides an overview of the qualification decisions, - the
qualificationDecisionDetails
, which presents the qualifications related to each target concept.
qualificationResults
field represents results from only one data source.
Therefore, qualificationResults
is structured as an array, where each element contains qualification decisions from a single
data source.{
"qualificationResults": [
{
"identifier": { },
"qualifiedAt": "SOME_VALUE",
"dataSourceTechnicalKey": "SOME_VALUE",
"dataSourceRequestIdentifiers": [ ],
"qualificationDecisionSummary": { },
"qualificationDecisionDetails": [ ]
}
],
"debugInfo": { },
"businessPartner": {},
"lookupResults" : [],
"rulesInError" : []
}
{
"qualificationDecisionSummary": {
"identifierQualificationDecision": "SOME_VALUE",
"nameQualificationDecision": "SOME_VALUE",
"addressQualificationDecision": "SOME_VALUE",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "SOME_VALUE",
"postCodeQualificationDecision": "SOME_VALUE",
"thoroughfareQualificationDecision": "SOME_VALUE"
},
"overallQualificationDecision": "SOME_VALUE"
}
}
{
"qualificationDecisionDetails": [
{
"businessRule": {
"name": "SOME_VALUE",
"url": "SOME_VALUE",
"ruleStatus": "SOME_VALUE",
"violationMessage": "SOME_VALUE"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "SOME_VALUE"
},
{
"name": "targetInputValue",
"value": "SOME_VALUE"
},
{
"name": "targetReferenceValue",
"value": "SOME_VALUE"
},
{
"name": "dataSourceTechnicalKey",
"value": "SOME_VALUE"
},
{
"name": "dataSourceRequestIdentifier",
"value": "SOME_VALUE"
}
],
"cdqId": "SOME_VALUE",
"decision": "SOME_VALUE",
"error": {}
}
]
}
/businesspartners/qualify
endpoint follows a specific structure as detailed in the qualification response
example preceding. Within this structure, SOME_VALUE
can denote various types of elements, including:- identifier,
- name,
- date and time,
- decision,
- other values.
key
, such as qualifiedAt
or dataSourceRequestIdentifiers
, is placed before the value, providing insights
into the expected content.Detailed response structure explanation:
ThequalificationResults
top structure includes the following elements:Property Name | Description |
---|---|
identifier | The value and type of an identifier. |
qualifiedAt | The timestamp when the check was performed. |
dataSourceTechnicalKey | The data source that was queried. |
dataSourceRequestIdentifier | For the VIES data source, this field provides a request identifier confirming that a request has been sent; this feature requires the FORCE_EXTERNAL_CALL setting to be enabled. |
qualificationDecisionSummary | A summary of the qualification decisions. |
qualificationDecisionDetails | Detailed information about each decision obtained. |
executionContextProperties | A set of execution context properties represented as "name": "value" pairs. Currently, the following property names are available: |
info
qualificationDecisionSummary
, qualificationDecisionDetails
and executionContextProperties
details are listed below.qualificationDecisionSummary
top structure includes the following elements:Property Name | Description |
---|---|
identifierQualificationDecision | Decision regarding the provided identifier. |
nameQualificationDecision | Decision about the Business Partner's name. |
addressQualificationDecision | Decision based on the provided address fields, calculated using decisions about postcode, locality, and thoroughfare. |
addressQualificationDecisionDetails | Detailed information about address decisions, which includes: localityQualificationDecision , postCodeQualificationDecision , and thoroughfareQualificationDecision . |
overallQualificationDecision | The overall decision, determined by the following hierarchy: NOT_PROCESSED < NO_INPUT_PROVIDED < VALID < NO_REFERENCE_AVAILABLE < INVALID < EXECUTION_ERROR . This hierarchy represents the highest decision based on the previous decisions about the identifier, name, locality, postcode, and thoroughfare. |
qualificationDecisionDetails
structure includes the following elements:businessRule
: The specific rule that led to a decision.
Property Name | Description |
---|---|
name | The name of the rule. |
url | The rule's URL on our Wiki. |
ruleStatus | The current status of the rule: HYPERCARE or RELEASED . |
violationMessage | A message detailing any violations related to defective data. |
executionContextProperties
structure includes the following elements:Property Name | Description |
---|---|
qualificationTarget | The target type being qualified, with possible values of IDENTIFIER , NAME_LOCAL , CITY , STREET , and POST_CODE_REGULAR . |
targetInputValue | The value provided by a user. |
targetReferenceValue | The value returned by a reference data source (e.g., VIES ). |
dataSourceTechnicalKey | The queried data source (e.g., VIES , BZST , AT.FON ). |
dataSourceRequestIdentifier | The request identifier provided by VIES . |
cdqId
- TheCDQ ID
value, if it exists, which uniquely identifies the data source and identifier for a Business Partner.decision
- The current decision returned by the rule.error
- If the check fails, an appropriate error message is provided, including an optional ID value. If applicable, therulesInError
object will contain a list of failed rules.
debugInfo
structure, which provides additional details about the qualification
process. This includes statistics on executed and failed rules, categories of rules considered, and activated data sources.
Additionally, if available, it provides a raw response from external data sources. To access the debugInfo
data, users
must enable specific feature. More information about potential structures that the /qualify
endpoint may return can be
found in the Qualifications Profiles and Qualification Features sections.Step 3: Complete response to analyze
Depending on the selected example in Step 1, scroll down and find matching response. It will contain the qualification results for a Business Partner. Chose one of the below cases to see the response:
Qualification of a Czech Business Partner
AllVALID
decisions were obtained against the CZ.REE
data source. It's important to note that the executed rules included
postcode, thoroughfare, locality, and name of a Business Partner. If any of these rules returns VALID
, the identifier
qualification decision is set to VALID
. This approach was used due to the absence of a specific rule for checking identifiers
only against CZ.REE
. In cases where all checked attributes result in INVALID
decisions, the identifier qualification
decision will also be marked as INVALID
. Nevertheless, efforts are ongoing to add more rules, and in the future, each
identifier will have its own dedicated qualification rule.{
"qualificationResults": [
{
"identifier": {
"value": "28107152",
"type": {
"technicalKey": "CZ_ICO"
}
},
"qualifiedAt": "2024-09-03T08:43:54.988607665",
"dataSourceTechnicalKey": "CZ.REE",
"dataSourceRequestIdentifiers": [],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "VALID",
"nameQualificationDecision": "VALID",
"addressQualificationDecision": "VALID",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "VALID",
"postCodeQualificationDecision": "VALID",
"thoroughfareQualificationDecision": "VALID"
},
"overallQualificationDecision": "VALID"
},
"qualificationDecisionDetails": [
{
"businessRule": {
"name": "Thoroughfare Qualification (ICO number (Czech Republic), Data source:CZ.REE)",
"url": "https://meta.cdq.com/Thoroughfare_Qualification_(ICO_number_(Czech_Republic),_Data_source:CZ.REE)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the ICO number (Czech Republic)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "STREET"
},
{
"name": "targetInputValue",
"value": "Hroznová"
},
{
"name": "targetReferenceValue",
"value": "Hroznová"
},
{
"name": "dataSourceTechnicalKey",
"value": "CZ.REE"
}
],
"cdqId": "CZ.REE:28107152",
"decision": "VALID"
},
{
"businessRule": {
"name": "Post code Qualification (ICO number (Czech Republic), Data source:CZ.REE)",
"url": "https://meta.cdq.com/Post_code_Qualification_(ICO_number_(Czech_Republic),_Data_source:CZ.REE)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the ICO number (Czech Republic)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "POST_CODE_REGULAR"
},
{
"name": "targetInputValue",
"value": "37001"
},
{
"name": "targetReferenceValue",
"value": "37001"
},
{
"name": "dataSourceTechnicalKey",
"value": "CZ.REE"
}
],
"cdqId": "CZ.REE:28107152",
"decision": "VALID"
},
{
"businessRule": {
"name": "Name Qualification (ICO number (Czech Republic), Data source:CZ.REE)",
"url": "https://meta.cdq.com/Name_Qualification_(ICO_number_(Czech_Republic),_Data_source:CZ.REE)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the ICO number (Czech Republic)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "NAME_LOCAL"
},
{
"name": "targetInputValue",
"value": "Budweiser Gastro s.r.o."
},
{
"name": "targetReferenceValue",
"value": "Budweiser Gastro s.r.o."
},
{
"name": "dataSourceTechnicalKey",
"value": "CZ.REE"
}
],
"cdqId": "CZ.REE:28107152",
"decision": "VALID"
},
{
"businessRule": {
"name": "Locality Qualification (ICO number (Czech Republic), Data source:CZ.REE)",
"url": "https://meta.cdq.com/Locality_Qualification_(ICO_number_(Czech_Republic),_Data_source:CZ.REE)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the ICO number (Czech Republic)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "CITY"
},
{
"name": "targetInputValue",
"value": "České Budějovice"
},
{
"name": "targetReferenceValue",
"value": "České Budějovice"
},
{
"name": "dataSourceTechnicalKey",
"value": "CZ.REE"
}
],
"cdqId": "CZ.REE:28107152",
"decision": "VALID"
}
]
}
],
"lookupResults": [],
"debugInfo": {
"externalServiceResponses": [
{
"status": 200,
"timestamp": "2024-09-03T08:43:54.909036117Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"ico\":\"28107152\",\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"pravniForma\":\"112\",\"financniUrad\":\"077\",\"datumVzniku\":\"2009-06-25\",\"datumAktualizace\":\"2024-06-28\",\"dic\":\"CZ28107152\",\"icoId\":\"28107152\",\"adresaDorucovaci\":{\"radekAdresy1\":\"Hroznová 487/25\",\"radekAdresy2\":\"České Budějovice 1\",\"radekAdresy3\":\"37001 České Budějovice\"},\"seznamRegistraci\":{\"stavZdrojeVr\":\"AKTIVNI\",\"stavZdrojeRes\":\"AKTIVNI\",\"stavZdrojeRzp\":\"AKTIVNI\",\"stavZdrojeNrpzs\":\"NEEXISTUJICI\",\"stavZdrojeRpsh\":\"NEEXISTUJICI\",\"stavZdrojeRcns\":\"NEEXISTUJICI\",\"stavZdrojeSzr\":\"NEEXISTUJICI\",\"stavZdrojeDph\":\"AKTIVNI\",\"stavZdrojeSd\":\"NEEXISTUJICI\",\"stavZdrojeIr\":\"NEEXISTUJICI\",\"stavZdrojeCeu\":\"NEEXISTUJICI\",\"stavZdrojeRs\":\"NEEXISTUJICI\",\"stavZdrojeRed\":\"AKTIVNI\"},\"primarniZdroj\":\"vr\",\"dalsiUdaje\":[{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"res\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"rzp\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"spisovaZnacka\":\"C 17562/KSCB\",\"datovyZdroj\":\"vr\"}],\"czNace\":[\"00\",\"1101\",\"56100\"]}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T08:43:54.909036117Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"ico\":\"28107152\",\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"pravniForma\":\"112\",\"financniUrad\":\"077\",\"datumVzniku\":\"2009-06-25\",\"datumAktualizace\":\"2024-06-28\",\"dic\":\"CZ28107152\",\"icoId\":\"28107152\",\"adresaDorucovaci\":{\"radekAdresy1\":\"Hroznová 487/25\",\"radekAdresy2\":\"České Budějovice 1\",\"radekAdresy3\":\"37001 České Budějovice\"},\"seznamRegistraci\":{\"stavZdrojeVr\":\"AKTIVNI\",\"stavZdrojeRes\":\"AKTIVNI\",\"stavZdrojeRzp\":\"AKTIVNI\",\"stavZdrojeNrpzs\":\"NEEXISTUJICI\",\"stavZdrojeRpsh\":\"NEEXISTUJICI\",\"stavZdrojeRcns\":\"NEEXISTUJICI\",\"stavZdrojeSzr\":\"NEEXISTUJICI\",\"stavZdrojeDph\":\"AKTIVNI\",\"stavZdrojeSd\":\"NEEXISTUJICI\",\"stavZdrojeIr\":\"NEEXISTUJICI\",\"stavZdrojeCeu\":\"NEEXISTUJICI\",\"stavZdrojeRs\":\"NEEXISTUJICI\",\"stavZdrojeRed\":\"AKTIVNI\"},\"primarniZdroj\":\"vr\",\"dalsiUdaje\":[{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"res\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"rzp\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"spisovaZnacka\":\"C 17562/KSCB\",\"datovyZdroj\":\"vr\"}],\"czNace\":[\"00\",\"1101\",\"56100\"]}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T08:43:54.909036117Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"ico\":\"28107152\",\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"pravniForma\":\"112\",\"financniUrad\":\"077\",\"datumVzniku\":\"2009-06-25\",\"datumAktualizace\":\"2024-06-28\",\"dic\":\"CZ28107152\",\"icoId\":\"28107152\",\"adresaDorucovaci\":{\"radekAdresy1\":\"Hroznová 487/25\",\"radekAdresy2\":\"České Budějovice 1\",\"radekAdresy3\":\"37001 České Budějovice\"},\"seznamRegistraci\":{\"stavZdrojeVr\":\"AKTIVNI\",\"stavZdrojeRes\":\"AKTIVNI\",\"stavZdrojeRzp\":\"AKTIVNI\",\"stavZdrojeNrpzs\":\"NEEXISTUJICI\",\"stavZdrojeRpsh\":\"NEEXISTUJICI\",\"stavZdrojeRcns\":\"NEEXISTUJICI\",\"stavZdrojeSzr\":\"NEEXISTUJICI\",\"stavZdrojeDph\":\"AKTIVNI\",\"stavZdrojeSd\":\"NEEXISTUJICI\",\"stavZdrojeIr\":\"NEEXISTUJICI\",\"stavZdrojeCeu\":\"NEEXISTUJICI\",\"stavZdrojeRs\":\"NEEXISTUJICI\",\"stavZdrojeRed\":\"AKTIVNI\"},\"primarniZdroj\":\"vr\",\"dalsiUdaje\":[{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"res\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"rzp\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"spisovaZnacka\":\"C 17562/KSCB\",\"datovyZdroj\":\"vr\"}],\"czNace\":[\"00\",\"1101\",\"56100\"]}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T08:43:54.909036117Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"ico\":\"28107152\",\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"pravniForma\":\"112\",\"financniUrad\":\"077\",\"datumVzniku\":\"2009-06-25\",\"datumAktualizace\":\"2024-06-28\",\"dic\":\"CZ28107152\",\"icoId\":\"28107152\",\"adresaDorucovaci\":{\"radekAdresy1\":\"Hroznová 487/25\",\"radekAdresy2\":\"České Budějovice 1\",\"radekAdresy3\":\"37001 České Budějovice\"},\"seznamRegistraci\":{\"stavZdrojeVr\":\"AKTIVNI\",\"stavZdrojeRes\":\"AKTIVNI\",\"stavZdrojeRzp\":\"AKTIVNI\",\"stavZdrojeNrpzs\":\"NEEXISTUJICI\",\"stavZdrojeRpsh\":\"NEEXISTUJICI\",\"stavZdrojeRcns\":\"NEEXISTUJICI\",\"stavZdrojeSzr\":\"NEEXISTUJICI\",\"stavZdrojeDph\":\"AKTIVNI\",\"stavZdrojeSd\":\"NEEXISTUJICI\",\"stavZdrojeIr\":\"NEEXISTUJICI\",\"stavZdrojeCeu\":\"NEEXISTUJICI\",\"stavZdrojeRs\":\"NEEXISTUJICI\",\"stavZdrojeRed\":\"AKTIVNI\"},\"primarniZdroj\":\"vr\",\"dalsiUdaje\":[{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"res\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"datovyZdroj\":\"rzp\"},{\"obchodniJmeno\":[{\"obchodniJmeno\":\"Budweiser Gastro s.r.o.\",\"primarniZaznam\":true}],\"sidlo\":[{\"sidlo\":{\"kodStatu\":\"CZ\",\"nazevStatu\":\"Česká republika\",\"kodKraje\":35,\"nazevKraje\":\"Jihočeský kraj\",\"kodOkresu\":3301,\"nazevOkresu\":\"České Budějovice\",\"kodObce\":544256,\"nazevObce\":\"České Budějovice\",\"kodUlice\":74225,\"nazevUlice\":\"Hroznová\",\"cisloDomovni\":487,\"kodCastiObce\":403865,\"cisloOrientacni\":25,\"nazevCastiObce\":\"České Budějovice 1\",\"kodAdresnihoMista\":26465604,\"psc\":37001,\"textovaAdresa\":\"Hroznová 487/25, České Budějovice 1, 37001 České Budějovice\",\"typCisloDomovni\":\"1\",\"standardizaceAdresy\":true},\"primarniZaznam\":true}],\"pravniForma\":\"112\",\"spisovaZnacka\":\"C 17562/KSCB\",\"datovyZdroj\":\"vr\"}],\"czNace\":[\"00\",\"1101\",\"56100\"]}]"
}
]
}
],
"businessRulesExecutionSummary": {
"numberOfRules": 4,
"numberOfExecutions": 4,
"numberOfFails": 0,
"failures": [],
"dataSourcesOn": [
{
"prefix": "CZ.REE"
}
],
"ruleCategoriesOn": [
{
"url": "https://meta.cdq.com/Qualification"
},
{
"url": "https://meta.cdq.com/EU_TAX_Qualification"
},
{
"url": "https://meta.cdq.com/Worldwide_TAX_Qualification"
}
]
}
}
}
Qualification of an Australian Business Partner
As seen from the response, for attributes where rules aren't implemented, the output isNOT_PROCESSED
. Since at least one
VALID
decision has been obtained, the identifier qualification decision is also VALID
.{
"qualificationResults": [
{
"identifier": {
"value": "64481100531",
"type": {
"technicalKey": "ABN_AU"
}
},
"qualifiedAt": "2024-09-03T12:25:35.653349548",
"dataSourceTechnicalKey": "AU.BR",
"dataSourceRequestIdentifiers": [],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "VALID",
"nameQualificationDecision": "VALID",
"addressQualificationDecision": "VALID",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "NOT_PROCESSED",
"postCodeQualificationDecision": "VALID",
"thoroughfareQualificationDecision": "NOT_PROCESSED"
},
"overallQualificationDecision": "VALID"
},
"qualificationDecisionDetails": [
{
"businessRule": {
"name": "Post code Qualification (Business Number (Australia), Data source:AU.BR)",
"url": "https://meta.cdq.com/Post_code_Qualification_(Business_Number_(Australia),_Data_source:AU.BR)",
"ruleStatus": "RELEASED",
"violationMessage": "Post code deviates from the reference post code registered with the Business Number (Australia)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "POST_CODE_REGULAR"
},
{
"name": "targetInputValue",
"value": "5142"
},
{
"name": "targetReferenceValue",
"value": "5142"
},
{
"name": "dataSourceTechnicalKey",
"value": "AU.BR"
}
],
"cdqId": "AU.BR:64481100531",
"decision": "VALID"
},
{
"businessRule": {
"name": "Name Qualification (Business Number (Australia), Data source:AU.BR)",
"url": "https://meta.cdq.com/Name_Qualification_(Business_Number_(Australia),_Data_source:AU.BR)",
"ruleStatus": "RELEASED",
"violationMessage": "Name deviates from the reference name registered with the Business Number (Australia)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "NAME_LOCAL"
},
{
"name": "targetInputValue",
"value": "BAYER PTY LTD"
},
{
"name": "targetReferenceValue",
"value": "The Trustee for STEFAN WAGNER FAMILY TRUST"
},
{
"name": "dataSourceTechnicalKey",
"value": "AU.BR"
}
],
"cdqId": "AU.BR:64481100531",
"decision": "VALID"
}
]
}
],
"lookupResults": [],
"debugInfo": {
"externalServiceResponses": [
{
"status": 200,
"timestamp": "2024-09-03T12:25:35.618289494Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"recordLastUpdatedDate\":\"2016-02-05T00:00:00.000+00:00\",\"abn\":[{\"identifierValue\":\"64481100531\",\"isCurrentIndicator\":\"Y\",\"replacedFrom\":\"0001-01-03T00:00:00.000+00:00\"}],\"entityStatus\":[{\"entityStatusCode\":\"Active\",\"effectiveFrom\":\"2001-04-02T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}],\"entityType\":{\"entityTypeCode\":\"DTT\",\"entityDescription\":\"Discretionary Trading Trust\"},\"goodsAndServicesTax\":[{\"effectiveFrom\":\"2016-01-27T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}],\"legalNameOrMainName\":[{\"organisationName\":\"The Trustee for STEFAN WAGNER FAMILY TRUST\",\"effectiveFrom\":\"2003-02-10T00:00:00.000+00:00\"}],\"mainTradingName\":[{\"organisationName\":\"BAYER PTY LTD\",\"effectiveFrom\":\"2003-02-22T00:00:00.000+00:00\"}],\"mainBusinessPhysicalAddress\":[{\"stateCode\":\"SA\",\"postcode\":\"5142\",\"effectiveFrom\":\"2014-09-21T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}]}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T12:25:35.618289494Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"recordLastUpdatedDate\":\"2016-02-05T00:00:00.000+00:00\",\"abn\":[{\"identifierValue\":\"64481100531\",\"isCurrentIndicator\":\"Y\",\"replacedFrom\":\"0001-01-03T00:00:00.000+00:00\"}],\"entityStatus\":[{\"entityStatusCode\":\"Active\",\"effectiveFrom\":\"2001-04-02T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}],\"entityType\":{\"entityTypeCode\":\"DTT\",\"entityDescription\":\"Discretionary Trading Trust\"},\"goodsAndServicesTax\":[{\"effectiveFrom\":\"2016-01-27T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}],\"legalNameOrMainName\":[{\"organisationName\":\"The Trustee for STEFAN WAGNER FAMILY TRUST\",\"effectiveFrom\":\"2003-02-10T00:00:00.000+00:00\"}],\"mainTradingName\":[{\"organisationName\":\"BAYER PTY LTD\",\"effectiveFrom\":\"2003-02-22T00:00:00.000+00:00\"}],\"mainBusinessPhysicalAddress\":[{\"stateCode\":\"SA\",\"postcode\":\"5142\",\"effectiveFrom\":\"2014-09-21T00:00:00.000+00:00\",\"effectiveTo\":\"0001-01-03T00:00:00.000+00:00\"}]}]"
}
]
}
],
"businessRulesExecutionSummary": {
"numberOfRules": 2,
"numberOfExecutions": 2,
"numberOfFails": 0,
"failures": [],
"dataSourcesOn": [
{
"prefix": "AU.BR"
}
],
"ruleCategoriesOn": [
{
"url": "https://meta.cdq.com/Qualification"
},
{
"url": "https://meta.cdq.com/EU_TAX_Qualification"
},
{
"url": "https://meta.cdq.com/Worldwide_TAX_Qualification"
}
]
}
}
}
Qualification of a Polish Business Partner
The returned response shows four results because each identifier was checked against each data source (2x2=4). This behavior arises from the knowledge graph's design to qualify all provided identifiers against all given data sources.VALID
decisions
were obtained for both the PL_REG
identifier and the EU_VAT_ID_PL
identifier. To qualify one identifier against one data
source, the request must contain exactly one identifier and one data source, or one identifier while relying on a specific
profile's default settings. Unnecessary qualification results can be filtered out. If all qualification decisions are marked
as NOT_PROCESSED
, those decisions aren't taken into consideration.{
"qualificationResults": [
{
"identifier": {
"value": "364493408",
"type": {
"technicalKey": "PL_REG"
}
},
"qualifiedAt": "2024-09-03T14:37:16.740096414",
"dataSourceTechnicalKey": "VIES",
"dataSourceRequestIdentifiers": [],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "NOT_PROCESSED",
"nameQualificationDecision": "NOT_PROCESSED",
"addressQualificationDecision": "NOT_PROCESSED",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "NOT_PROCESSED",
"postCodeQualificationDecision": "NOT_PROCESSED",
"thoroughfareQualificationDecision": "NOT_PROCESSED"
},
"overallQualificationDecision": "NOT_PROCESSED"
},
"qualificationDecisionDetails": [
{
"error": {
"error": "This identifier is not supported or configuration does not trigger any qualification rules.",
"status": 200
}
}
]
},
{
"identifier": {
"value": "PL8992790965",
"type": {
"technicalKey": "EU_VAT_ID_PL"
}
},
"qualifiedAt": "2024-09-03T14:37:16.740204251",
"dataSourceTechnicalKey": "VIES",
"dataSourceRequestIdentifiers": [
{
"dataSourceTechnicalKey": "VIES",
"value": "WAPIAAAAZG4UYbYX"
}
],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "VALID",
"nameQualificationDecision": "VALID",
"addressQualificationDecision": "VALID",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "VALID",
"postCodeQualificationDecision": "VALID",
"thoroughfareQualificationDecision": "VALID"
},
"overallQualificationDecision": "VALID"
},
"qualificationDecisionDetails": [
{
"businessRule": {
"name": "Thoroughfare Qualification (European value added tax identifier (Poland), Data source:VIES)",
"url": "https://meta.cdq.com/Thoroughfare_Qualification_(European_value_added_tax_identifier_(Poland),_Data_source:VIES)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the European value added tax identifier (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "STREET"
},
{
"name": "targetInputValue",
"value": "Stanisława Leszczyńskiego"
},
{
"name": "targetReferenceValue",
"value": "Stanisława Leszczyńskiego"
},
{
"name": "dataSourceTechnicalKey",
"value": "VIES"
},
{
"name": "dataSourceRequestIdentifier",
"value": "WAPIAAAAZG4UYbYX"
}
],
"cdqId": "VIES:PL8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Post code Qualification (European value added tax identifier (Poland), Data source:VIES)",
"url": "https://meta.cdq.com/Post_code_Qualification_(European_value_added_tax_identifier_(Poland),_Data_source:VIES)",
"ruleStatus": "RELEASED",
"violationMessage": "Post code deviates from the reference post code registered with the European value added tax identifier (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "POST_CODE_REGULAR"
},
{
"name": "targetInputValue",
"value": "50-078"
},
{
"name": "targetReferenceValue",
"value": "50-078"
},
{
"name": "dataSourceTechnicalKey",
"value": "VIES"
},
{
"name": "dataSourceRequestIdentifier",
"value": "WAPIAAAAZG4UYbYX"
}
],
"cdqId": "VIES:PL8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Name Qualification (European value added tax identifier (Poland), Data source:VIES)",
"url": "https://meta.cdq.com/Name_Qualification_(European_value_added_tax_identifier_(Poland),_Data_source:VIES)",
"ruleStatus": "RELEASED",
"violationMessage": "Name deviates from the reference name registered with the European value added tax identifier (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "NAME_LOCAL"
},
{
"name": "targetInputValue",
"value": "CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ"
},
{
"name": "targetReferenceValue",
"value": "CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ"
},
{
"name": "dataSourceTechnicalKey",
"value": "VIES"
},
{
"name": "dataSourceRequestIdentifier",
"value": "WAPIAAAAZG4UYbYX"
}
],
"cdqId": "VIES:PL8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Locality Qualification (European value added tax identifier (Poland), Data source:VIES)",
"url": "https://meta.cdq.com/Locality_Qualification_(European_value_added_tax_identifier_(Poland),_Data_source:VIES)",
"ruleStatus": "RELEASED",
"violationMessage": "City deviates from the reference city registered with the European value added tax identifier (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "CITY"
},
{
"name": "targetInputValue",
"value": "Wrocław"
},
{
"name": "targetReferenceValue",
"value": "Wrocław"
},
{
"name": "dataSourceTechnicalKey",
"value": "VIES"
},
{
"name": "dataSourceRequestIdentifier",
"value": "WAPIAAAAZG4UYbYX"
}
],
"cdqId": "VIES:PL8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Identifier Qualification (European value added tax identifier (Poland), Data source:VIES)",
"url": "https://meta.cdq.com/Identifier_Qualification_(European_value_added_tax_identifier_(Poland),_Data_source:VIES)",
"ruleStatus": "RELEASED",
"violationMessage": "Identifier deviates from the reference identifier registered with the European value added tax identifier (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "IDENTIFIER"
},
{
"name": "targetInputValue",
"value": "PL8992790965"
},
{
"name": "targetReferenceValue",
"value": "PL8992790965"
},
{
"name": "dataSourceTechnicalKey",
"value": "VIES"
},
{
"name": "dataSourceRequestIdentifier",
"value": "WAPIAAAAZG4UYbYX"
}
],
"cdqId": "VIES:PL8992790965",
"decision": "VALID"
}
]
},
{
"identifier": {
"value": "364493408",
"type": {
"technicalKey": "PL_REG"
}
},
"qualifiedAt": "2024-09-03T14:37:16.740676603",
"dataSourceTechnicalKey": "PL.NOBR",
"dataSourceRequestIdentifiers": [],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "VALID",
"nameQualificationDecision": "VALID",
"addressQualificationDecision": "VALID",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "VALID",
"postCodeQualificationDecision": "VALID",
"thoroughfareQualificationDecision": "VALID"
},
"overallQualificationDecision": "VALID"
},
"qualificationDecisionDetails": [
{
"businessRule": {
"name": "Thoroughfare Qualification (REGON (Poland), Data source:PL.NOBR)",
"url": "https://meta.cdq.com/Thoroughfare_Qualification_(REGON_(Poland),_Data_source:PL.NOBR)",
"ruleStatus": "RELEASED",
"violationMessage": "Street deviates from the reference street registered with the REGON (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "STREET"
},
{
"name": "targetInputValue",
"value": "Stanisława Leszczyńskiego"
},
{
"name": "targetReferenceValue",
"value": "ul. Stanisława Leszczyńskiego"
},
{
"name": "dataSourceTechnicalKey",
"value": "PL.NOBR"
}
],
"cdqId": "PL.NOBR:8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Post code Qualification (REGON (Poland), Data source:PL.NOBR)",
"url": "https://meta.cdq.com/Post_code_Qualification_(REGON_(Poland),_Data_source:PL.NOBR)",
"ruleStatus": "RELEASED",
"violationMessage": "Post code deviates from the reference post code registered with the REGON (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "POST_CODE_REGULAR"
},
{
"name": "targetInputValue",
"value": "50-078"
},
{
"name": "targetReferenceValue",
"value": "50-078"
},
{
"name": "dataSourceTechnicalKey",
"value": "PL.NOBR"
}
],
"cdqId": "PL.NOBR:8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Name Qualification (REGON (Poland), Data source:PL.NOBR)",
"url": "https://meta.cdq.com/Name_Qualification_(REGON_(Poland),_Data_source:PL.NOBR)",
"ruleStatus": "RELEASED",
"violationMessage": "Name deviates from the reference name registered with the REGON (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "NAME_LOCAL"
},
{
"name": "targetInputValue",
"value": "CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ"
},
{
"name": "targetReferenceValue",
"value": "CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ"
},
{
"name": "dataSourceTechnicalKey",
"value": "PL.NOBR"
}
],
"cdqId": "PL.NOBR:8992790965",
"decision": "VALID"
},
{
"businessRule": {
"name": "Locality Qualification (REGON (Poland), Data source:PL.NOBR)",
"url": "https://meta.cdq.com/Locality_Qualification_(REGON_(Poland),_Data_source:PL.NOBR)",
"ruleStatus": "RELEASED",
"violationMessage": "City deviates from the reference city registered with the REGON (Poland)"
},
"executionContextProperties": [
{
"name": "qualificationTarget",
"value": "CITY"
},
{
"name": "targetInputValue",
"value": "Wrocław"
},
{
"name": "targetReferenceValue",
"value": "Wrocław"
},
{
"name": "dataSourceTechnicalKey",
"value": "PL.NOBR"
}
],
"cdqId": "PL.NOBR:8992790965",
"decision": "VALID"
}
]
},
{
"identifier": {
"value": "PL8992790965",
"type": {
"technicalKey": "EU_VAT_ID_PL"
}
},
"qualifiedAt": "2024-09-03T14:37:16.740789359",
"dataSourceTechnicalKey": "PL.NOBR",
"dataSourceRequestIdentifiers": [],
"qualificationDecisionSummary": {
"identifierQualificationDecision": "NOT_PROCESSED",
"nameQualificationDecision": "NOT_PROCESSED",
"addressQualificationDecision": "NOT_PROCESSED",
"addressQualificationDecisionDetails": {
"localityQualificationDecision": "NOT_PROCESSED",
"postCodeQualificationDecision": "NOT_PROCESSED",
"thoroughfareQualificationDecision": "NOT_PROCESSED"
},
"overallQualificationDecision": "NOT_PROCESSED"
},
"qualificationDecisionDetails": [
{
"error": {
"error": "This identifier is not supported or configuration does not trigger any qualification rules.",
"status": 200
}
}
]
}
],
"lookupResults": [],
"debugInfo": {
"externalServiceResponses": [
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.504303084Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"miejscowoscPoczty\":\"Wrocław\",\"regon\":\"364493408\",\"nip\":\"8992790965\",\"nazwa\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\",\"wojewodztwo\":\"DOLNOŚLĄSKIE\",\"powiat\":\"Wrocław\",\"gmina\":\"Wrocław-Stare Miasto\",\"miejscowosc\":\"Wrocław\",\"kodPocztowy\":\"50-078\",\"ulica\":\"ul. Stanisława Leszczyńskiego\",\"nrNieruchomosci\":\"4\",\"nrLokalu\":\"29\",\"typ\":\"P\",\"silosID\":\"6\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.504303084Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"miejscowoscPoczty\":\"Wrocław\",\"regon\":\"364493408\",\"nip\":\"8992790965\",\"nazwa\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\",\"wojewodztwo\":\"DOLNOŚLĄSKIE\",\"powiat\":\"Wrocław\",\"gmina\":\"Wrocław-Stare Miasto\",\"miejscowosc\":\"Wrocław\",\"kodPocztowy\":\"50-078\",\"ulica\":\"ul. Stanisława Leszczyńskiego\",\"nrNieruchomosci\":\"4\",\"nrLokalu\":\"29\",\"typ\":\"P\",\"silosID\":\"6\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.504303084Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"miejscowoscPoczty\":\"Wrocław\",\"regon\":\"364493408\",\"nip\":\"8992790965\",\"nazwa\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\",\"wojewodztwo\":\"DOLNOŚLĄSKIE\",\"powiat\":\"Wrocław\",\"gmina\":\"Wrocław-Stare Miasto\",\"miejscowosc\":\"Wrocław\",\"kodPocztowy\":\"50-078\",\"ulica\":\"ul. Stanisława Leszczyńskiego\",\"nrNieruchomosci\":\"4\",\"nrLokalu\":\"29\",\"typ\":\"P\",\"silosID\":\"6\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.504303084Z",
"additionalInformation": [
{
"key": "rawJson",
"value": "[{\"miejscowoscPoczty\":\"Wrocław\",\"regon\":\"364493408\",\"nip\":\"8992790965\",\"nazwa\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\",\"wojewodztwo\":\"DOLNOŚLĄSKIE\",\"powiat\":\"Wrocław\",\"gmina\":\"Wrocław-Stare Miasto\",\"miejscowosc\":\"Wrocław\",\"kodPocztowy\":\"50-078\",\"ulica\":\"ul. Stanisława Leszczyńskiego\",\"nrNieruchomosci\":\"4\",\"nrLokalu\":\"29\",\"typ\":\"P\",\"silosID\":\"6\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.702314579Z",
"additionalInformation": [
{
"key": "requestorId",
"value": "DE307699628"
},
{
"key": "requestId",
"value": "WAPIAAAAZG4UYbYX"
},
{
"key": "rawJson",
"value": "[{\"vatValue\":{\"value\":\"8992790965\"},\"requestDate\":{\"value\":\"2024-09-02T22:00:00.000+00:00\"},\"countryCode\":{\"value\":\"PL\"},\"valid\":{\"value\":true},\"traderAddress\":{\"value\":\"STANISŁAWA LESZCZYŃSKIEGO 4 M29\\n50-078 WROCŁAW\"},\"traderName\":{\"value\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\"},\"traderCompanyType\":{\"value\":\"---\"},\"traderStreet\":{},\"traderPostcode\":{},\"traderCity\":{},\"traderNameMatch\":{},\"traderCompanyTypeMatch\":{},\"traderStreetMatch\":{},\"traderPostcodeMatch\":{},\"traderCityMatch\":{},\"requestIdentifier\":{\"value\":\"WAPIAAAAZG4UYbYX\"},\"referenceAddressDto\":{\"version\":{\"characterSet\":{\"name\":\"International\",\"technicalKey\":\"INTERNATIONAL\"},\"language\":{\"name\":\"en\",\"technicalKey\":\"en\"}},\"metadata\":{},\"country\":{\"shortName\":\"PL\",\"value\":\"Poland\"},\"postCodes\":[{\"value\":\"50-078\"}],\"localities\":[{\"type\":{\"name\":\"City\",\"url\":\"https://meta.cdq.com/Address/locality/type/city\",\"technicalKey\":\"CITY\"},\"shortName\":\"Wrocław\",\"value\":\"Wrocław\"}],\"thoroughfares\":[{\"type\":{\"name\":\"Street\",\"url\":\"https://meta.cdq.com/Address/thoroughfare/type/street\",\"technicalKey\":\"STREET\"},\"shortName\":\"Stanisława Leszczyńskiego\",\"number\":\"4\",\"value\":\"Stanisława Leszczyńskiego\",\"name\":\"stanisława leszczyńskiego\"}],\"premises\":[{\"value\":\"M. 29\",\"shortName\":\"M\",\"number\":\"29\",\"type\":{\"name\":\"Apartment\",\"url\":\"https://meta.cdq.com/Address/premise/type/apartment\",\"technicalKey\":\"APARTMENT\"}}]},\"requesterVatNumber\":\"307699628\",\"requesterCountryCode\":\"DE\",\"refreshReason\":\"FORCED_BY_CUSTOMER\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.702314579Z",
"additionalInformation": [
{
"key": "requestorId",
"value": "DE307699628"
},
{
"key": "requestId",
"value": "WAPIAAAAZG4UYbYX"
},
{
"key": "rawJson",
"value": "[{\"vatValue\":{\"value\":\"8992790965\"},\"requestDate\":{\"value\":\"2024-09-02T22:00:00.000+00:00\"},\"countryCode\":{\"value\":\"PL\"},\"valid\":{\"value\":true},\"traderAddress\":{\"value\":\"STANISŁAWA LESZCZYŃSKIEGO 4 M29\\n50-078 WROCŁAW\"},\"traderName\":{\"value\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\"},\"traderCompanyType\":{\"value\":\"---\"},\"traderStreet\":{},\"traderPostcode\":{},\"traderCity\":{},\"traderNameMatch\":{},\"traderCompanyTypeMatch\":{},\"traderStreetMatch\":{},\"traderPostcodeMatch\":{},\"traderCityMatch\":{},\"requestIdentifier\":{\"value\":\"WAPIAAAAZG4UYbYX\"},\"referenceAddressDto\":{\"version\":{\"characterSet\":{\"name\":\"International\",\"technicalKey\":\"INTERNATIONAL\"},\"language\":{\"name\":\"en\",\"technicalKey\":\"en\"}},\"metadata\":{},\"country\":{\"shortName\":\"PL\",\"value\":\"Poland\"},\"postCodes\":[{\"value\":\"50-078\"}],\"localities\":[{\"type\":{\"name\":\"City\",\"url\":\"https://meta.cdq.com/Address/locality/type/city\",\"technicalKey\":\"CITY\"},\"shortName\":\"Wrocław\",\"value\":\"Wrocław\"}],\"thoroughfares\":[{\"type\":{\"name\":\"Street\",\"url\":\"https://meta.cdq.com/Address/thoroughfare/type/street\",\"technicalKey\":\"STREET\"},\"shortName\":\"Stanisława Leszczyńskiego\",\"number\":\"4\",\"value\":\"Stanisława Leszczyńskiego\",\"name\":\"stanisława leszczyńskiego\"}],\"premises\":[{\"value\":\"M. 29\",\"shortName\":\"M\",\"number\":\"29\",\"type\":{\"name\":\"Apartment\",\"url\":\"https://meta.cdq.com/Address/premise/type/apartment\",\"technicalKey\":\"APARTMENT\"}}]},\"requesterVatNumber\":\"307699628\",\"requesterCountryCode\":\"DE\",\"refreshReason\":\"FORCED_BY_CUSTOMER\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.702314579Z",
"additionalInformation": [
{
"key": "requestorId",
"value": "DE307699628"
},
{
"key": "requestId",
"value": "WAPIAAAAZG4UYbYX"
},
{
"key": "rawJson",
"value": "[{\"vatValue\":{\"value\":\"8992790965\"},\"requestDate\":{\"value\":\"2024-09-02T22:00:00.000+00:00\"},\"countryCode\":{\"value\":\"PL\"},\"valid\":{\"value\":true},\"traderAddress\":{\"value\":\"STANISŁAWA LESZCZYŃSKIEGO 4 M29\\n50-078 WROCŁAW\"},\"traderName\":{\"value\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\"},\"traderCompanyType\":{\"value\":\"---\"},\"traderStreet\":{},\"traderPostcode\":{},\"traderCity\":{},\"traderNameMatch\":{},\"traderCompanyTypeMatch\":{},\"traderStreetMatch\":{},\"traderPostcodeMatch\":{},\"traderCityMatch\":{},\"requestIdentifier\":{\"value\":\"WAPIAAAAZG4UYbYX\"},\"referenceAddressDto\":{\"version\":{\"characterSet\":{\"name\":\"International\",\"technicalKey\":\"INTERNATIONAL\"},\"language\":{\"name\":\"en\",\"technicalKey\":\"en\"}},\"metadata\":{},\"country\":{\"shortName\":\"PL\",\"value\":\"Poland\"},\"postCodes\":[{\"value\":\"50-078\"}],\"localities\":[{\"type\":{\"name\":\"City\",\"url\":\"https://meta.cdq.com/Address/locality/type/city\",\"technicalKey\":\"CITY\"},\"shortName\":\"Wrocław\",\"value\":\"Wrocław\"}],\"thoroughfares\":[{\"type\":{\"name\":\"Street\",\"url\":\"https://meta.cdq.com/Address/thoroughfare/type/street\",\"technicalKey\":\"STREET\"},\"shortName\":\"Stanisława Leszczyńskiego\",\"number\":\"4\",\"value\":\"Stanisława Leszczyńskiego\",\"name\":\"stanisława leszczyńskiego\"}],\"premises\":[{\"value\":\"M. 29\",\"shortName\":\"M\",\"number\":\"29\",\"type\":{\"name\":\"Apartment\",\"url\":\"https://meta.cdq.com/Address/premise/type/apartment\",\"technicalKey\":\"APARTMENT\"}}]},\"requesterVatNumber\":\"307699628\",\"requesterCountryCode\":\"DE\",\"refreshReason\":\"FORCED_BY_CUSTOMER\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.702314579Z",
"additionalInformation": [
{
"key": "requestorId",
"value": "DE307699628"
},
{
"key": "requestId",
"value": "WAPIAAAAZG4UYbYX"
},
{
"key": "rawJson",
"value": "[{\"vatValue\":{\"value\":\"8992790965\"},\"requestDate\":{\"value\":\"2024-09-02T22:00:00.000+00:00\"},\"countryCode\":{\"value\":\"PL\"},\"valid\":{\"value\":true},\"traderAddress\":{\"value\":\"STANISŁAWA LESZCZYŃSKIEGO 4 M29\\n50-078 WROCŁAW\"},\"traderName\":{\"value\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\"},\"traderCompanyType\":{\"value\":\"---\"},\"traderStreet\":{},\"traderPostcode\":{},\"traderCity\":{},\"traderNameMatch\":{},\"traderCompanyTypeMatch\":{},\"traderStreetMatch\":{},\"traderPostcodeMatch\":{},\"traderCityMatch\":{},\"requestIdentifier\":{\"value\":\"WAPIAAAAZG4UYbYX\"},\"referenceAddressDto\":{\"version\":{\"characterSet\":{\"name\":\"International\",\"technicalKey\":\"INTERNATIONAL\"},\"language\":{\"name\":\"en\",\"technicalKey\":\"en\"}},\"metadata\":{},\"country\":{\"shortName\":\"PL\",\"value\":\"Poland\"},\"postCodes\":[{\"value\":\"50-078\"}],\"localities\":[{\"type\":{\"name\":\"City\",\"url\":\"https://meta.cdq.com/Address/locality/type/city\",\"technicalKey\":\"CITY\"},\"shortName\":\"Wrocław\",\"value\":\"Wrocław\"}],\"thoroughfares\":[{\"type\":{\"name\":\"Street\",\"url\":\"https://meta.cdq.com/Address/thoroughfare/type/street\",\"technicalKey\":\"STREET\"},\"shortName\":\"Stanisława Leszczyńskiego\",\"number\":\"4\",\"value\":\"Stanisława Leszczyńskiego\",\"name\":\"stanisława leszczyńskiego\"}],\"premises\":[{\"value\":\"M. 29\",\"shortName\":\"M\",\"number\":\"29\",\"type\":{\"name\":\"Apartment\",\"url\":\"https://meta.cdq.com/Address/premise/type/apartment\",\"technicalKey\":\"APARTMENT\"}}]},\"requesterVatNumber\":\"307699628\",\"requesterCountryCode\":\"DE\",\"refreshReason\":\"FORCED_BY_CUSTOMER\"}]"
}
]
},
{
"status": 200,
"timestamp": "2024-09-03T14:37:16.702314579Z",
"additionalInformation": [
{
"key": "requestorId",
"value": "DE307699628"
},
{
"key": "requestId",
"value": "WAPIAAAAZG4UYbYX"
},
{
"key": "rawJson",
"value": "[{\"vatValue\":{\"value\":\"8992790965\"},\"requestDate\":{\"value\":\"2024-09-02T22:00:00.000+00:00\"},\"countryCode\":{\"value\":\"PL\"},\"valid\":{\"value\":true},\"traderAddress\":{\"value\":\"STANISŁAWA LESZCZYŃSKIEGO 4 M29\\n50-078 WROCŁAW\"},\"traderName\":{\"value\":\"CDQ POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ\"},\"traderCompanyType\":{\"value\":\"---\"},\"traderStreet\":{},\"traderPostcode\":{},\"traderCity\":{},\"traderNameMatch\":{},\"traderCompanyTypeMatch\":{},\"traderStreetMatch\":{},\"traderPostcodeMatch\":{},\"traderCityMatch\":{},\"requestIdentifier\":{\"value\":\"WAPIAAAAZG4UYbYX\"},\"referenceAddressDto\":{\"version\":{\"characterSet\":{\"name\":\"International\",\"technicalKey\":\"INTERNATIONAL\"},\"language\":{\"name\":\"en\",\"technicalKey\":\"en\"}},\"metadata\":{},\"country\":{\"shortName\":\"PL\",\"value\":\"Poland\"},\"postCodes\":[{\"value\":\"50-078\"}],\"localities\":[{\"type\":{\"name\":\"City\",\"url\":\"https://meta.cdq.com/Address/locality/type/city\",\"technicalKey\":\"CITY\"},\"shortName\":\"Wrocław\",\"value\":\"Wrocław\"}],\"thoroughfares\":[{\"type\":{\"name\":\"Street\",\"url\":\"https://meta.cdq.com/Address/thoroughfare/type/street\",\"technicalKey\":\"STREET\"},\"shortName\":\"Stanisława Leszczyńskiego\",\"number\":\"4\",\"value\":\"Stanisława Leszczyńskiego\",\"name\":\"stanisława leszczyńskiego\"}],\"premises\":[{\"value\":\"M. 29\",\"shortName\":\"M\",\"number\":\"29\",\"type\":{\"name\":\"Apartment\",\"url\":\"https://meta.cdq.com/Address/premise/type/apartment\",\"technicalKey\":\"APARTMENT\"}}]},\"requesterVatNumber\":\"307699628\",\"requesterCountryCode\":\"DE\",\"refreshReason\":\"FORCED_BY_CUSTOMER\"}]"
}
]
}
],
"businessRulesExecutionSummary": {
"numberOfRules": 9,
"numberOfExecutions": 9,
"numberOfFails": 0,
"failures": [],
"dataSourcesOn": [
{
"prefix": "VIES"
},
{
"prefix": "PL.NOBR"
}
],
"ruleCategoriesOn": [
{
"url": "https://meta.cdq.com/Qualification"
},
{
"url": "https://meta.cdq.com/EU_TAX_Qualification"
},
{
"url": "https://meta.cdq.com/Worldwide_TAX_Qualification"
}
]
}
}
}
Current Limitations and Restrictions of CDQ's Qualification
The/businesspartners/qualify
endpoint enables the use of 18 different data sources. Not all data sources behave the same
way or provide results in the same format. To integrate all of them, the necessary steps were taken to follow each data
source's restrictions. A common interface has been provided with the following limitations:Limitations |
---|
BZST does not support German Business Partners. |
VIES can validate only the EU VAT identifier of German Business Partners but does not provide reference data for the German address and name. |
VIES does not return reference data for Spanish Business Partners; it merely indicates whether a given input, such as name and address, is a match. |
Currently, only AT.FON can fully qualify German Business Partners with all attributes: identifier, postcode, name, locality, and thoroughfare. |
If the dataSources attribute is included in a request, results for each identifier from each requested data source will be provided, which may lead to many NOT_PROCESSED decisions. |
In some cases, qualification of an identifier is based on the calculation of other checked fields: postcode, name, locality, and thoroughfare due to the absence of specific rules for checking the identifier alone; this remains under active development. |
Qualification can fail if issues arise with connecting to a reference data source, such as if it is undergoing maintenance. All issues that occur during execution will be available in the debugInfo data field of a response. |
Currently, it is possible to qualify five data fields: identifier, postcode, name, locality, and thoroughfare of a Business Partner. If other Business Partner attributes require qualification, customers are encouraged to create an idea in the idea portal. |
Values that are empty or missing fields, such as not present "postCodes": [] data, result in the NO_INPUT_PROVIDED decision. |
Your opinion matters!
We are constantly working on providing an outstanding user experience with our products. Please share your opinion about this tutorial!
Mail our developer-portal team: developer-portal@cdq.com