Clear all Business Partners of a data source.
OK
{- "numberOfDeletes": "50",
- "numberOfFailures": "0",
- "failures": [
- {
- "id": "63e635235c06b7396330fe40",
- "dataSource": "648824a691d8d2503d65103e",
- "externalId": "The ID managed in the customer's SAP systems.",
- "message": "This record could not be stored due to timeout."
}
]
}
Create a new data source. Max 100 data sources are allowed.
Warn: If you have an integration with one data source, please check if data source id is included in the upsert request before adding a new data source. Otherwise, adding new data source may lead to upsert failures visible as bad request containing message "No DataSource was provided for the given Business Partners and the storage has more than one attached to it.".
OK
Bad Request
{- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix"
}
{- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix"
}
If no data source is provided, a minimal data source (name=default and without mapping ID) is attached.
OK
The sent request is malformed.
{- "name": "string",
- "dataMatchingDefinitionId": "string",
- "dataSources": [
- {
- "dataSourceName": "string",
- "dataMapperDefinitionId": "string"
}
], - "featuresOn": [
- "LOOKUP"
], - "sharedWithOrganization": false,
- "labels": [
- "string"
]
}
{- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers",
- "eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
- "decisionLogId": "72d6900fc3wb326088f5d9d91044e3e6",
- "domain": "BusinessPartner",
- "organization": "cdq_monitor",
- "user": "johndoe",
- "createdAt": "2024-11-22T13:20:14Z",
- "expiresAt": "2024-11-22T13:20:14Z",
- "dataMatchingDefinitionId": "6400955811c68a034bcef311",
- "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix",
- "mappingDisclosure": "true"
}
], - "dataMonitors": [
- {
- "id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
- "type": {
- "name": "Augmentation",
- "technicalKey": "AUGMENTATION"
}, - "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers"
}
], - "enabled": true,
- "disabledAt": "2024-11-22T13:20:14Z",
- "configuration": {
- "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}, - "executions": [
- {
- "type": {
- "technicalKey": "TRIGGER"
}, - "frequency": "BI_WEEKLY"
}
], - "validitySpan": {
- "technicalKey": "YEAR"
}, - "createdAt": "2024-11-22T13:20:14Z",
- "createdBy": "76248934691294444",
- "modifiedAt": "2024-11-22T13:20:14Z",
- "modifiedBy": "76248934691294444",
- "featuresOn": [
- "BUILD_REPORT"
]
}
], - "features": {
- "lookup": {
- "status": "ENABLED"
}, - "updates": {
- "status": "ENABLED"
}, - "sharing": {
- "status": "ENABLED"
}, - "neverExpire": {
- "status": "ENABLED"
}, - "tagsManagedByUpsert": {
- "status": "ENABLED"
}
}, - "numberOfCountries": "12",
- "numberOfRecords": "500",
- "countryStatistics": [
- {
- "countryCode": "CH",
- "numberOfRecords": "500"
}
], - "originalFileHeader": [
- "BusinessPartnerId, Name, Address"
], - "originalFileName": "business-partner.csv",
- "results": {
- "addressCurationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "goldenRecordGenerationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "resultItems": [
- {
- "country": "CH",
- "label": "Result Item label",
- "numberOfRecords": "500",
- "type": "Result Item type"
}
], - "validationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
]
}, - "status": "FILE_IMPORTED_SUCCESSFULLY",
- "statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
- "sharedWithOrganization": "true",
- "labels": [
- "Custom Storage Name"
]
}
Delete a data source and its dependencies:
OK
List all storages to which user has access to.
OK
{- "values": [
- {
- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers",
- "eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
- "decisionLogId": "72d6900fc3wb326088f5d9d91044e3e6",
- "domain": "BusinessPartner",
- "organization": "cdq_monitor",
- "user": "johndoe",
- "createdAt": "2024-11-22T13:20:14Z",
- "expiresAt": "2024-11-22T13:20:14Z",
- "dataMatchingDefinitionId": "6400955811c68a034bcef311",
- "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix",
- "mappingDisclosure": "true"
}
], - "dataMonitors": [
- {
- "id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
- "type": {
- "name": "Augmentation",
- "technicalKey": "AUGMENTATION"
}, - "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers"
}
], - "enabled": true,
- "disabledAt": "2024-11-22T13:20:14Z",
- "configuration": {
- "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}, - "executions": [
- {
- "type": {
- "technicalKey": null
}, - "frequency": "BI_WEEKLY"
}
], - "validitySpan": {
- "technicalKey": "YEAR"
}, - "createdAt": "2024-11-22T13:20:14Z",
- "createdBy": "76248934691294444",
- "modifiedAt": "2024-11-22T13:20:14Z",
- "modifiedBy": "76248934691294444",
- "featuresOn": [
- "BUILD_REPORT"
]
}
], - "features": {
- "lookup": {
- "status": "ENABLED"
}, - "updates": {
- "status": "ENABLED"
}, - "sharing": {
- "status": "ENABLED"
}, - "neverExpire": {
- "status": "ENABLED"
}, - "tagsManagedByUpsert": {
- "status": "ENABLED"
}
}, - "numberOfCountries": "12",
- "numberOfRecords": "500",
- "countryStatistics": [
- {
- "countryCode": "CH",
- "numberOfRecords": "500"
}
], - "originalFileHeader": [
- "BusinessPartnerId, Name, Address"
], - "originalFileName": "business-partner.csv",
- "results": {
- "addressCurationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "goldenRecordGenerationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "resultItems": [
- {
- "country": "CH",
- "label": "Result Item label",
- "numberOfRecords": "500",
- "type": "Result Item type"
}
], - "validationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
]
}, - "status": "FILE_IMPORTED_SUCCESSFULLY",
- "statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
- "sharedWithOrganization": "true",
- "labels": [
- "Custom Storage Name"
]
}
], - "limit": "100",
- "startAfter": "5712566172571652",
- "nextStartAfter": "5712566172571652",
- "total": "67"
}
List all data sources available for update monitoring.
OK
{- "referenceDataSources": [
- {
- "aleiPrefix": "VIES",
- "technicalKey": "VIES",
- "activationStatus": "ACTIVE"
}
]
}
Read metadata of a storage.
dataSource | string (BusinessPartnerDataSource) Data Source (name or ID) to be measured during calculating statistics. By default, all Data Sources are measured. Example: dataSource="CUSTOM_DATA_SOURCE" or "648824a691d8d2503d65103e" | ||||||
featuresOn | Array of strings Features to be activated during reading the metadata.
Example: featuresOn=WITH_COUNTRY_STATISTICS |
OK
{- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers",
- "eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
- "decisionLogId": "72d6900fc3wb326088f5d9d91044e3e6",
- "domain": "BusinessPartner",
- "organization": "cdq_monitor",
- "user": "johndoe",
- "createdAt": "2024-11-22T13:20:14Z",
- "expiresAt": "2024-11-22T13:20:14Z",
- "dataMatchingDefinitionId": "6400955811c68a034bcef311",
- "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix",
- "mappingDisclosure": "true"
}
], - "dataMonitors": [
- {
- "id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
- "type": {
- "name": "Augmentation",
- "technicalKey": "AUGMENTATION"
}, - "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers"
}
], - "enabled": true,
- "disabledAt": "2024-11-22T13:20:14Z",
- "configuration": {
- "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}, - "executions": [
- {
- "type": {
- "technicalKey": "TRIGGER"
}, - "frequency": "BI_WEEKLY"
}
], - "validitySpan": {
- "technicalKey": "YEAR"
}, - "createdAt": "2024-11-22T13:20:14Z",
- "createdBy": "76248934691294444",
- "modifiedAt": "2024-11-22T13:20:14Z",
- "modifiedBy": "76248934691294444",
- "featuresOn": [
- "BUILD_REPORT"
]
}
], - "features": {
- "lookup": {
- "status": "ENABLED"
}, - "updates": {
- "status": "ENABLED"
}, - "sharing": {
- "status": "ENABLED"
}, - "neverExpire": {
- "status": "ENABLED"
}, - "tagsManagedByUpsert": {
- "status": "ENABLED"
}
}, - "numberOfCountries": "12",
- "numberOfRecords": "500",
- "countryStatistics": [
- {
- "countryCode": "CH",
- "numberOfRecords": "500"
}
], - "originalFileHeader": [
- "BusinessPartnerId, Name, Address"
], - "originalFileName": "business-partner.csv",
- "results": {
- "addressCurationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "goldenRecordGenerationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "resultItems": [
- {
- "country": "CH",
- "label": "Result Item label",
- "numberOfRecords": "500",
- "type": "Result Item type"
}
], - "validationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
]
}, - "status": "FILE_IMPORTED_SUCCESSFULLY",
- "statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
- "sharedWithOrganization": "true",
- "labels": [
- "Custom Storage Name"
]
}
Update a Data Source.
dataMapperDefinitionId | string (DataMapperDefinitionId) ID of related Data Mapper Definition that is used for mapping data of this Business Partner Storage. Example: "6440dba32b30176c5917b1b7" |
dataTransformationDefinitionId | string (DataTransformationDefinitionId) ID of related Data Transformation Definition that is used for mapping data of this Business Partner Storage. Example: "6440dba32b30176c5917b1b7" |
name | string (BusinessPartnerStorageDataSourceName) Name of a data source of a storage. Example: "Internal customers" |
prefix | string (Prefix) Additional prefix for data source name. Example: "Custom prefix" |
OK
Bad Request
{- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix"
}
{- "dataSource": {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix"
}, - "status": "OK"
}
This endpoint is deprecated. Please use
Update all data sources of a given storage.
Note: all data sources that are expected to remain in the storage must be included on a list.
Warn: If you have an integration with one data source, please check if data source id is included in the upsert request before adding a new data source. Otherwise, adding new data source may lead to upsert failures visible as bad request containing message "No DataSource was provided for the given Business Partners and the storage has more than one attached to it.".
OK
{- "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix"
}
]
}
{- "created": "4",
- "updated": "0",
- "failed": "4"
}
Update a Business Partner Storage.
dataMatchingDefinitionId | string (DataMatchingDefinitionId) ID of related data matching definition that is used for matching lookup candidates for internal lookup of this Business Partner Storage. Example: "6400955811c68a034bcef311" |
labels | Array of strings (StorageLabels) <= 10 items unique List of Storages labels. Example: ["Custom Storage Name"] |
name | string <= 50 characters Name of the Business Partner Storage. Example: "My Storage" |
sharedWithOrganization | boolean (SharedWithOrganization) Indicates if this Business Partner Storage is shared with all users of the same organization Example: "true" |
OK
{- "name": "My Storage",
- "labels": [
- "Custom Storage Name"
], - "dataMatchingDefinitionId": "6400955811c68a034bcef311",
- "sharedWithOrganization": "true"
}
{- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers",
- "eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
- "decisionLogId": "72d6900fc3wb326088f5d9d91044e3e6",
- "domain": "BusinessPartner",
- "organization": "cdq_monitor",
- "user": "johndoe",
- "createdAt": "2024-11-22T13:20:14Z",
- "expiresAt": "2024-11-22T13:20:14Z",
- "dataMatchingDefinitionId": "6400955811c68a034bcef311",
- "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "createdAt": "2024-11-22T13:20:14Z",
- "lastUpdatedAt": "2024-11-22T13:20:14Z",
- "name": "Internal customers",
- "dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
- "dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
- "prefix": "Custom prefix",
- "mappingDisclosure": "true"
}
], - "dataMonitors": [
- {
- "id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
- "type": {
- "name": "Augmentation",
- "technicalKey": "AUGMENTATION"
}, - "dataSources": [
- {
- "id": "648824a691d8d2503d65103e",
- "name": "Internal customers"
}
], - "enabled": true,
- "disabledAt": "2024-11-22T13:20:14Z",
- "configuration": {
- "id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}, - "executions": [
- {
- "type": {
- "technicalKey": "TRIGGER"
}, - "frequency": "BI_WEEKLY"
}
], - "validitySpan": {
- "technicalKey": "YEAR"
}, - "createdAt": "2024-11-22T13:20:14Z",
- "createdBy": "76248934691294444",
- "modifiedAt": "2024-11-22T13:20:14Z",
- "modifiedBy": "76248934691294444",
- "featuresOn": [
- "BUILD_REPORT"
]
}
], - "features": {
- "lookup": {
- "status": "ENABLED"
}, - "updates": {
- "status": "ENABLED"
}, - "sharing": {
- "status": "ENABLED"
}, - "neverExpire": {
- "status": "ENABLED"
}, - "tagsManagedByUpsert": {
- "status": "ENABLED"
}
}, - "numberOfCountries": "12",
- "numberOfRecords": "500",
- "countryStatistics": [
- {
- "countryCode": "CH",
- "numberOfRecords": "500"
}
], - "originalFileHeader": [
- "BusinessPartnerId, Name, Address"
], - "originalFileName": "business-partner.csv",
- "results": {
- "addressCurationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "goldenRecordGenerationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
], - "resultItems": [
- {
- "country": "CH",
- "label": "Result Item label",
- "numberOfRecords": "500",
- "type": "Result Item type"
}
], - "validationReports": [
- {
- "creationTimestamp": "2024-11-22T13:20:14Z",
- "description": "Report description",
- "name": "Report name",
- "type": "Report type",
}
]
}, - "status": "FILE_IMPORTED_SUCCESSFULLY",
- "statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
- "sharedWithOrganization": "true",
- "labels": [
- "Custom Storage Name"
]
}