Download OpenAPI specification:Download
API for SAP Business Network (BN) to simplify the integration of CDQ services.
Confirms the validity of a trading partner by checking the provided data against various CDQ services.
The API specification provides a mock server at
this URL.
The following examples are defined and can be requested by the example ID in
header field x-redocly-response-body-example
:
Example ID | Summary |
---|---|
allOK |
All checks confirm the trading partner's information successfully. |
companyKnownButWrongStreetNoVatNumber |
Company is known but street is wrong and no VAT number is provided. |
companyKnownButSanctioned |
Company is known but on a sanction list. |
companyNotKnown |
Company is not known, i.e., the provided data can not be verified by a Trusted Data Source. |
object (BusinessPartner) A business partner is globally uniquely identifiable by a CDQ ID, and all managed information such as addresses, documents, and hierarchies is linked to a business partner. |
OK
Bad Request
Unauthorized
Forbidden
Not Found
{- "businessPartner": {
- "jsonRecord": {
- "name": "CDQ GmbH",
- "vatNumber": "DE307699628",
- "country": "DE",
- "city": "Friedrichshafen",
- "postalCode": "88045",
- "street": "Albrechtstraße 8",
- "houseNumber": "8"
}
}
}
{- "companyConfirmation": {
- "decision": {
- "technicalKey": "OK"
}, - "details": {
- "matchedCompanyData": {
- "jsonRecord": {
- "city": "Friedrichshafen",
- "country": "DE",
- "houseNumber": "8",
- "name": "CDQ GmbH",
- "postalCode": "88045",
- "street": "Albrechtstraße"
}
}, - "matchingProfile": {
- "matchingScores": {
- "address": {
- "classification": "FULL_MATCH",
- "value": 0.9461161651504549
}, - "businessPartner": {
- "classification": "FULL_MATCH",
- "value": 0.9941860465116279
}, - "overall": {
- "classification": "FULL_MATCH",
- "explanation": "BP: [overall: [EU_VAT_ID_DE: 0.9; overall: 0.9; NAME: 0.95; overall: 0.9941860465116279;]] A: [overall: [LOCALITY: 0.65; overall: 0.65; POST_CODE: 0.56; overall: 0.7027027027027027; THOROUGHFARE: 0.8; overall: 0.9043478260869566; COUNTRY_SHORTNAME: 0.5; overall: 0.9043478260869566; THOROUGHFARE_NUMBER: 0.65; overall: 0.9461161651504549;]]",
- "value": 0.9996670543825589
}
}
}
}, - "summary": {
- "dataSourceName": "Common register portal of the German federal states",
- "overallMatchingClassification": "FULL_MATCH",
- "overallMatchingScore": 0.9996670543825589
}
}, - "dataQualityConfirmation": {
- "decision": {
- "technicalKey": "OK"
}, - "details": {
- "errors": [ ],
- "infos": [
- {
- "businessRule": {
- "name": "Identifier missing (Business Registration Number (Germany))",
- "ruleStatus": "RELEASED",
}, - "violationLevel": "INFO",
- "violationMessage": "Business partner misses the business registration number"
}
], - "warnings": [ ]
}, - "summary": {
- "numErrors": 0,
- "numInfos": 1,
- "numWarnings": 0
}
}, - "sanctionComplianceConfirmation": {
- "decision": {
- "technicalKey": "OK"
}
}, - "vatNumberConfirmation": {
- "decision": {
- "technicalKey": "OK"
}, - "details": {
- "identifierResults": {
- "qualificationDecisions": [
- {
- "businessRule": {
- "name": "Thoroughfare Qualification (European value added tax identifier (Germany), Data source:AT.FON)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "AT.FON",
- "decision": "VALID",
- "qualificationTarget": "STREET"
}, - {
- "businessRule": {
- "name": "Post code Qualification (European value added tax identifier (Germany), Data source:AT.FON)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "AT.FON",
- "decision": "VALID"
}, - {
- "businessRule": {
- "name": "Name Qualification (European value added tax identifier (Germany), Data source:AT.FON)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "AT.FON",
- "decision": "VALID",
- "qualificationTarget": "NAME"
}, - {
- "businessRule": {
- "name": "Locality Qualification (European value added tax identifier (Germany), Data source:AT.FON)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "AT.FON",
- "decision": "VALID",
- "qualificationTarget": "CITY"
}, - {
- "businessRule": {
- "name": "Identifier Qualification (European value added tax identifier (Germany), Data source:AT.FON)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "AT.FON",
- "decision": "VALID",
- "qualificationTarget": "IDENTIFIER"
}, - {
- "businessRule": {
- "name": "Identifier Qualification (European value added tax identifier (Germany), Data source:VIES)",
- "ruleStatus": "RELEASED",
}, - "dataSourceName": "VIES",
- "decision": "VALID",
- "qualificationTarget": "IDENTIFIER"
}
]
}
}, - "summary": {
- "dataSourceName": "AT.FON",
- "decisionCity": "VALID",
- "decisionIdentifier": "VALID",
- "decisionName": "VALID",
- "decisionStreet": "VALID"
}
}
}