{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-apis/referencedata-api/@referencedata-api-v3/api-v3.yaml":"oas-apis/referencedata-api/@referencedata-api-v3/api-v3.yaml","oas-apis/data-curation-api/@data-curation-api-v2/api-v2.yaml":"oas-apis/data-curation-api/@data-curation-api-v2/api-v2.yaml","oas-apis/data-validation-api/@data-validation-api-v2/api-v2.yaml":"oas-apis/data-validation-api/@data-validation-api-v2/api-v2.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","partial","replay-openapi"]},"type":"markdown"},"seo":{"title":"CDQ First Time Right","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tutorial-cdq-first-time-right","__idx":0},"children":["Tutorial: CDQ First Time Right"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial describes the recommended use of CDQ Cloud Platform APIs for maintaining a single business partner data"," ","record. The presented flow provides the most comprehensive use of features and explains the API endpoints to be used."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ftr-overview.ecaf4c86a02ec70c8b6200adaad9ff4b03cf563df1fa85ce6bb10360524e19cd.cbb72118.png","alt":"","title":"#width=800px;"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Use Case: Situation, Approach and Results"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A complete use case description is available on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/Use_case/business_partner_data_maintenance_workflow"},"children":["Wiki"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learning Goals"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/processchart.b9b6e2c6140486955440a89888bf248f32d0d49c0d0df6738c192620e76d9e33.cbb72118.png","alt":"","title":"#width=800px;"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Common Process and involved APIs/Endpoints"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this tutorial, you will learn how:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify Business Partner existence in one of the public pools (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIES"]},") with the help of the CDQ reference data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enrich existing data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify data quality before storing"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following tutorial describes a ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["happy path"]}," based on a common use case. Depending on your particular business"," ","requirements, the steps may be different and/or need to be customized."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorization","__idx":3},"children":["Authorization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before trying CDQ APIs, user must be authenticated:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the API Key in the console's security bar into the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," field."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/auth7.0d4fb05fa55bc16d828c76e9976f979930ffadb949cfc149a6617cc6518ab57d.6fde6558.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After pasting the API Key, the green padlock will appear."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/auth8.28e02515b78db57ec32c07fd6bd7d296484e64f65ef6a3bc5296520cb1da8d65.6fde6558.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Be careful"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Green padlock doesn't mean that the API Key was pasted correctly."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check your API key for missing characters or extra space before trying."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"no-api-key","__idx":4},"children":["No API Key?"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check how to get one on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/instructions/authentication"},"children":["authentication page"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow the steps above."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"business-partner-data","__idx":5},"children":["Business Partner data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business Partner chosen for the tutorials:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Localities"},"children":["Localities"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Thoroughfares"},"children":["Thoroughfares"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"PL VAT ID"},"children":["PL VAT ID"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SWISS KRONO Sp. z o.o."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Żary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Serbska 56"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PL9280012700"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-source-activation","__idx":6},"children":["Data Source activation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remember to activate a VIES data source and accept terms of conditions before you start the tutorial."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To activate it use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://apps.cdq.com/dashboard/global-settings"},"children":["Global Settings"]}," app."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-data-pool-lookup-and-record-selection","__idx":7},"children":["Step 1 Data Pool Lookup and Record Selection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To verify given Business Partner in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIES"]}," public data pool:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Partner Lookup"]}," endpoint to send below request:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the above example in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try It Console"]}," now:"]}]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/referencedata-api/@referencedata-api-v3/api-v3.yaml","pointer":"/paths/~1v3~1businesspartners~1lookup/post","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the response. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"SWISS KRONO Sp. z o.o.\""]}," is presented in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIES:PL9280012700"]}," data pool."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure all required data sources are enabled. All data sources are listed in the feature table ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.cdq.com/reference-docs/reference-data/V3/tag/Business-Partners/#tag/Business-Partners/paths/~1v3~1businesspartners~1lookup/post"},"children":["here"]},"."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchingProfile"]}," in the response and find ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchingScores"]}," value for Business Partner reliability."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"matchingProfile\":{\n        \"matchingScores\":{\n            \"overall\":{\n                \"classification\":{\n                    \"technicalKey\": \"FULL_MATCH\",\n                    \"name\": \"Full Match\"\n                },\n                \"value\": 0.9928821602078861,\n                \"explanation\": \"BP: [overall: [NAME: 0.91; overall: 0.91;]] A: [overall: [LOCALITY: 0.65; overall: 0.65; THOROUGHFARE: 0.8; overall: 0.8813559322033899; THOROUGHFARE_NUMBER: 0.65; overall: 0.9324137931034483;]]\"\n            },\n            \"businessPartner\":{},\n            \"address\":{}\n        }\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchingScores"]}," above 0,88 generally indicates a great lookup result. Visit Wiki for more information about ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/Field/Business_Partner_Matching_Score"},"children":["Matching Score"]}," ","or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/Field/Business_Partner_Match_Classification"},"children":["Match Classification"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the presented case the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["classification"]}," shows ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FULL_MATCH"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchScores"]}," value equals ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.9928821602078861"]}," ","which means the provided Business Partner data are aligned with CDQ records."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Business Partner is verified in the CDQ repository! Go to the next step."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-address-cleansing","__idx":8},"children":["Step 2 Address Cleansing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this step, the user can perform activities to enrich desired data. During usage of Business Partner Curate, the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STANDARD"]}," profile is active by default."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All features included in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STANDARD"]}," profile are described in this ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/API/Data_Curation_API/Profile/STANDARD"},"children":["page"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enrich given Business Partner data:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Partner Curate"]}," endpoint to send below request:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the above example in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try It Console"]}," now:"]}]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/data-curation-api/@data-curation-api-v2/api-v2.yaml","pointer":"/paths/~1v2~1businesspartners~1curate/post","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Request can be different from the one visible on the user screen and be collapsed (if you are using the developer"," ","portal console)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addressCurationResults"]}," to see enriched data with detailed administrative area information, post-code and"," ","geographic coordinates."]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"addressCurationResults\": [\n      {\n        \"curatedAddress\": {\n            \"version\": {},\n            \"metadata\": {},\n            \"country\":\n              {\n                \"shortName\": \"PL\",\n                \"value\": \"Poland\"\n              },\n            \"administrativeAreas\":[\n              {\n                \"value\": \"Lubusz Voivodeship\",\n                \"shortName\": \"08\",\n                \"type\":{}\n              },\n              {\n                \"value\": \"Powiat Żarski\",\n                \"shortName\": \"Powiat Żarski\"\n              }\n            ],\n            \"postCodes\":[\n              {\n                \"value\": \"68-200\",\n                \"type\":{}\n              }\n            ],\n            \"localities\": [],\n            \"thoroughfares\": [],\n            \"geographicCoordinates\":{\n                \"latitude\": 51.63314,\n                \"longitude\": 15.10538\n            }\n        }\n      }\n    ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["curationAnalysis"]}," to find important indicator ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["curationLevel"]}," which shows ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LEVEL_6"]}," value. It means that"," ","enriched data is validated."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"curationAnalysis\":{\n        \"requestSimilarity\":{},\n        \"curationLevel\": \"LEVEL_6\",\n        \"accuracyIndicator\": 3,\n        \"outputLanguage\": \"EN\",\n        \"curationDecision\":{},\n        \"geographicCoordinatesAccuracy\": \"THOROUGHFARE_NUMBER\"\n      }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Business Partner data are enriched! Go to the next step!"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-data-quality-check","__idx":9},"children":["Step 3 Data Quality Check"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identifier-qualification","__idx":10},"children":["Identifier Qualification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Qualification is the most powerful data quality check for identifiers. It does not only check the format and general"," ","registration of a tax number but compared given name and address data to the authority record of the given tax number."," ","With a qualified tax number (i.e., a qualified tax number/name/address combination), you have proof that your data is"," ","equal to the particular authority's registry."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To validate given Business Partner data:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Partner Validate"]}," endpoint to send below request:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the above example in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try It Console"]}," now:"]}]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/data-validation-api/@data-validation-api-v2/api-v2.yaml","pointer":"/paths/~1v2~1businesspartners~1validate/post","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the response above and check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatorMessage"]}," for value."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n        \"validatorMessage\": \"VAT ID is valid.\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The message in the request body: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"VAT ID is valid.\""]}," confirms the reliability of the VAT identifier of the Business"," ","Partner."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not all examples shows the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatorMessage"]}," in the response. Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"featuresOn\": [\"SHOW_QUALIFICATION\"]"]}," to the body to"," ","see it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-quality-checks","__idx":11},"children":["Additional quality checks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To perform additional checks below feature send the request without any profile on, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STANDARD"]}," profile will be"," ","activated by default."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To validate given Business Partner data:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Partner Validate"]}," endpoint to send below request:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the above example in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try It Console"]}," now:"]}]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/data-validation-api/@data-validation-api-v2/api-v2.yaml","pointer":"/paths/~1v2~1businesspartners~1validate/post","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An additional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"businessPartner\""]}," object appeared in the response with Business Partner data."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"summary\":{\n        \"validationLevel\": \"NO_DEFECTS\",\n        \"action\": \"AUTO_APPROVE\",\n        \"statistics\": {}\n    },\n    \"debugInfo\":\n    {\n        \"businessRulesExecutionSummary\":{}\n    },\n    \"identifierResults\":[\n    {\n        \"property\":{\n            \"value\": \"PL9280012700\",\n            \"type\": \"EU_VAT_ID_PL\"\n        },\n        \"reliabilityLevel\":{\n            \"name\": \"Identifier existence\",\n            \"url\": \"https://meta.cdq.com/Identifier_existence\",\n            \"value\": 4,\n            \"checks\":[]\n        }\n    },\n    {\n        \"property\":{\n            \"value\": \"9280012700\",\n            \"type\": \"PL_NIP\"\n        },\n        \"reliabilityLevel\":{\n            \"name\": \"Identifier existence\",\n            \"url\": \"https://meta.cdq.com/Identifier_existence\",\n            \"value\": 4,\n            \"checks\":[]\n        }\n    },\n    {\n        \"property\":{\n            \"value\": \"970327738\",\n            \"type\": \"PL_REG\"\n        },\n        \"reliabilityLevel\":{\n            \"name\": \"Identifier existence\",\n            \"url\": \"https://meta.cdq.com/Identifier_existence\",\n            \"value\": 4,\n            \"checks\":[]\n        }\n    }\n    ],\n    \"businessPartner\":{\n        \"names\":[],\n        \"legalForm\":{},\n        \"identifiers\":[],\n        \"addresses\":[\n        {\n            \"country\":{\n                \"shortName\": \"PL\",\n                \"value\": \"Poland\"\n            },\n            \"administrativeAreas\":[\n            {\n                \"value\": \"lubuskie\"\n            }\n            ],\n            \"postCodes\":[\n            {\n                \"value\": \"68-200\"\n            }\n            ],\n            \"localities\":[\n            {\n                \"value\": \"Żary\"\n            }\n            ],\n            \"thoroughfares\":[\n            {\n                \"value\": \"Serbska 56\"\n            }\n            ]\n        }\n        ]\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Congratulations"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Business Partner data are validated!"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-data-ready-to-store","__idx":12},"children":["Step 4 Data ready to store"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After performing all the above steps, the Business Partner data can be stored in the corporate database."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"your-opinion-matters","__idx":13},"children":["Your opinion matters!"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We are constantly working on providing an outstanding user experience with our products. Please share your opinion about this tutorial!"]}]},"headings":[{"value":"Tutorial: CDQ First Time Right","id":"tutorial-cdq-first-time-right","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Authorization","id":"authorization","depth":3},{"value":"No API Key?","id":"no-api-key","depth":4},{"value":"Business Partner data","id":"business-partner-data","depth":3},{"value":"Data Source activation.","id":"data-source-activation","depth":3},{"value":"Step 1 Data Pool Lookup and Record Selection","id":"step-1-data-pool-lookup-and-record-selection","depth":2},{"value":"Step 2 Address Cleansing","id":"step-2-address-cleansing","depth":2},{"value":"Step 3 Data Quality Check","id":"step-3-data-quality-check","depth":2},{"value":"Identifier Qualification","id":"identifier-qualification","depth":3},{"value":"Additional quality checks","id":"additional-quality-checks","depth":3},{"value":"Step 4 Data ready to store","id":"step-4-data-ready-to-store","depth":2},{"value":"Your opinion matters!","id":"your-opinion-matters","depth":2}],"frontmatter":{"seo":{"title":"CDQ First Time Right"},"toc":{"enable":true}},"lastModified":"2026-05-14T08:19:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/_public/tutorials/solution-tutorial/cdq-first-time-right","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}