Business Partner Storages

Business Partner Storage Public Webservice

Clear Data SourceWSDL

Clear all Business Partners of a data source.

SecurityapiKey

Request

path Parameters

dataSourceId required	string (BusinessPartnerStorageDataSourceId) Unique identifier for a Data Source of the Storage. Example: 648824a691d8d2503d65103e
storageId required	string (BusinessPartnerStorageId) Unique identifier of the Storage. Example: 72d6900fce6b326088f5d9d91049e3e6

Responses

200

post/storages/{storageId}/datasources/{dataSourceId}/clear

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"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."
}
]
}

Clear StorageWSDL

Remove all Business Partners from given Business Partner Storage.

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of a Business Partner Storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Responses

200

post/storages/{storageId}/clear

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"numberOfDeletes": "50"
}

Create Data Source

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.".

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of Business Partner storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Request Body schema: application/json
required

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"

Responses

200

400

Bad Request

post/storages/{storageId}/datasources

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix"
}

Response samples

application/json

{"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix"
}

Delete Data Source

Delete a data source and its dependencies:

Business Partners from a storage,
update monitors, data monitors and sharing scopes for that data source are adjusted (data source is removed from the data sources list of a resource and resource is removed if data source was the only one assigned).

SecurityapiKey

Request

path Parameters

dataSourceId required	string (BusinessPartnerStorageDataSourceId) Filter by specified Data Source ID. Example: 648824a691d8d2503d65103e
storageId required	string (BusinessPartnerStorageId) Unique ID of the Business Partner storage. Example: 72d6900fce6b326088f5d9d91049e3e6

Responses

200

delete/storages/{storageId}/datasources/{dataSourceId}

Request samples

curl
Python
Java
Node.js

Delete StorageWSDL

Delete a Business Partner Storage.

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of a Business Partner Storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Responses

200

delete/storages/{storageId}

Request samples

curl
Python
Java
Node.js

List Storages

List all Business Partner Storages of the user's organization.

SecurityapiKey

Request

query Parameters

dataMapperDefinitionId	Array of strings (DataMapperDefinitionId) Filter the result and Data Sources by Data Mapper Definition ID. Example: dataMapperDefinitionId=6440dba32b30176c5917b1b7
dataTransformationDefinitionId	Array of strings (DataTransformationDefinitionId) Filter the result and Data Sources by Data Transformation Definition ID. Example: dataTransformationDefinitionId=6440dba32b30176c5917b1b7
includeSharedStorages	boolean Default: false Optionally extend the result with metadata for Business Partner Storages that have been shared by other users of your organization. Example: includeSharedStorages=true
label	string Filter the result by the given label. Keep in mind that labels are case-sensitive. Example: label=My Storage
page	integer <int32> >= 0 Default: 0 Number of the page that will be retrieved. Example: page=10
pageSize	integer <int32> >= 1 Default: 20 Number of items to be returned on the page. Example: pageSize=10
sort	string Defines the attributes to sort by. Supported attributes are 'id', 'name' and 'createdAt', separated by comma (,) and the sort direction in front of each attribute. '+' means ascending, '-' means descending. Default sort, if direction is not given, is ascending. Example: sort=-createdAt

Responses

200

get/storages

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"page": "1",
"numberOfPages": "10",
"pageSize": "100",
"total": "67",
"values": [{"id": "648824a691d8d2503d65103e",
"name": "Internal customers",
"eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
"domain": "BusinessPartner",
"organization": "cdq_monitor",
"user": "johndoe",
"createdAt": "2024-11-22T13:20:20Z",
"expiresAt": "2024-11-22T13:20:20Z",
"dataMatchingDefinitionId": "6400955811c68a034bcef311",
"dataSources": [{"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix",
"mappingDisclosure": "true"
}
],
"dataMonitors": [{"id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
"frequency": "BI_WEEKLY",
"type": {"name": "Augmentation",
"technicalKey": "AUGMENTATION"
},
"dataSources": [{"id": "648824a691d8d2503d65103e",
"name": "Internal customers"
}
],
"enabled": true,
"disabledAt": "2024-11-22T13:20:20Z",
"configuration": {"id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}
}
],
"features": {"lookup": {"status": "ENABLED"
},
"updates": {"status": "ENABLED"
},
"sharing": {"status": "ENABLED"
},
"neverExpire": {"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:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"goldenRecordGenerationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"resultItems": [{"country": "CH",
"label": "Result Item label",
"numberOfRecords": "500",
"type": "Result Item type"
}
],
"validationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
]
},
"status": "FILE_IMPORTED_SUCCESSFULLY",
"statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
"sharedWithOrganization": "true",
"labels": ["Custom Storage Name"
]
}
]
}

List Update Monitors' Data SourcesDeprecated

List all data sources available for update monitoring.

SecurityapiKey

Responses

200

get/updatemonitors/datasources

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"dataSources": ["648824a691d8d2503d65103e"
]
}

Read Storage Metadata

Read metadata of a Business Partner Storage.

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of a Business Partner Storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Responses

200

get/storages/{storageId}

Request samples

curl
Python
Java
Node.js

Response samples

application/json

{"id": "648824a691d8d2503d65103e",
"name": "Internal customers",
"eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
"domain": "BusinessPartner",
"organization": "cdq_monitor",
"user": "johndoe",
"createdAt": "2024-11-22T13:20:20Z",
"expiresAt": "2024-11-22T13:20:20Z",
"dataMatchingDefinitionId": "6400955811c68a034bcef311",
"dataSources": [{"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix",
"mappingDisclosure": "true"
}
],
"dataMonitors": [{"id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
"frequency": "BI_WEEKLY",
"type": {"name": "Augmentation",
"technicalKey": "AUGMENTATION"
},
"dataSources": [{"id": "648824a691d8d2503d65103e",
"name": "Internal customers"
}
],
"enabled": true,
"disabledAt": "2024-11-22T13:20:20Z",
"configuration": {"id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}
}
],
"features": {"lookup": {"status": "ENABLED"
},
"updates": {"status": "ENABLED"
},
"sharing": {"status": "ENABLED"
},
"neverExpire": {"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:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"goldenRecordGenerationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"resultItems": [{"country": "CH",
"label": "Result Item label",
"numberOfRecords": "500",
"type": "Result Item type"
}
],
"validationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
]
},
"status": "FILE_IMPORTED_SUCCESSFULLY",
"statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
"sharedWithOrganization": "true",
"labels": ["Custom Storage Name"
]
}

Update Data Source

Update a Data Source.

SecurityapiKey

Request

path Parameters

dataSourceId required	string (BusinessPartnerStorageDataSourceId) Filter by specified Data Source ID. Example: 648824a691d8d2503d65103e
storageId required	string (BusinessPartnerStorageId) Unique ID of the Business Partner storage. Example: 72d6900fce6b326088f5d9d91049e3e6

Request Body schema: application/json
required

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"

Responses

200

400

Bad Request

put/storages/{storageId}/datasources/{dataSourceId}

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix"
}

Response samples

application/json

{"dataSource": {"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix"
},
"status": "OK"
}

Update Data SourcesDeprecated

This endpoint is deprecated. Please use

create data source to create a new data source,
update data source to update existing data source,
delete data source to delete existing data source.

Update all data sources of a given storage.

When a new data source without id is added to the list, it is created.
When existing data source is provided on a list with id included, it is updated.
When data source identified by id is not included in a list, it is deleted with all its related Business Partners, data monitors and sharing scopes for that data source are adjusted (data source is removed from the data sources list of a resource and resource is removed if data source was the only one assigned).

Note: all data sources that are expected to remain in the storage must be included on a list.

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of Business Partner storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Request Body schema: application/json
required

required

Array of objects (DataSourceParam) [ 1 .. 100 ] items

List of Data Sources.

Responses

200

put/storages/{storageId}/datasources

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"dataSources": [{"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix"
}
]
}

Response samples

application/json

{"created": "4",
"updated": "0",
"failed": "4"
}

Update Storage

Update a Business Partner Storage.

SecurityapiKey

Request

path Parameters

storageId

required

string (BusinessPartnerStorageId)

Unique ID of a Business Partner Storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

Request Body schema: application/json
required

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"

Responses

200

put/storages/{storageId}

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"name": "My Storage",
"labels": ["Custom Storage Name"
],
"dataMatchingDefinitionId": "6400955811c68a034bcef311",
"sharedWithOrganization": "true"
}

Response samples

application/json

{"id": "648824a691d8d2503d65103e",
"name": "Internal customers",
"eventStoreId": "72d6900fce6b326123f5d9d91049e3e6",
"domain": "BusinessPartner",
"organization": "cdq_monitor",
"user": "johndoe",
"createdAt": "2024-11-22T13:20:20Z",
"expiresAt": "2024-11-22T13:20:20Z",
"dataMatchingDefinitionId": "6400955811c68a034bcef311",
"dataSources": [{"id": "648824a691d8d2503d65103e",
"createdAt": "2024-11-22T13:20:20Z",
"lastUpdatedAt": "2024-11-22T13:20:20Z",
"name": "Internal customers",
"dataMapperDefinitionId": "6440dba32b30176c5917b1b7",
"dataTransformationDefinitionId": "6440dba32b30176c5917b1b7",
"prefix": "Custom prefix",
"mappingDisclosure": "true"
}
],
"dataMonitors": [{"id": "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf",
"frequency": "BI_WEEKLY",
"type": {"name": "Augmentation",
"technicalKey": "AUGMENTATION"
},
"dataSources": [{"id": "648824a691d8d2503d65103e",
"name": "Internal customers"
}
],
"enabled": true,
"disabledAt": "2024-11-22T13:20:20Z",
"configuration": {"id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}
}
],
"features": {"lookup": {"status": "ENABLED"
},
"updates": {"status": "ENABLED"
},
"sharing": {"status": "ENABLED"
},
"neverExpire": {"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:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"goldenRecordGenerationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
],
"resultItems": [{"country": "CH",
"label": "Result Item label",
"numberOfRecords": "500",
"type": "Result Item type"
}
],
"validationReports": [{"creationTimestamp": "2024-11-22T13:20:20Z",
"description": "Report description",
"name": "Report name",
"type": "Report type",
"url": "https://www.cdq.com"
}
]
},
"status": "FILE_IMPORTED_SUCCESSFULLY",
"statusMessage": "BusinessPartner batch could not be upserted into Business Partner Storage.",
"sharedWithOrganization": "true",
"labels": ["Custom Storage Name"
]
}

Business Partner Storages

Clear Data SourceWSDL

path Parameters

Clear StorageWSDL

path Parameters

Create Data Source

path Parameters

Request Body schema: application/jsonrequired

Delete Data Source

path Parameters

Delete StorageWSDL

path Parameters

List Storages

query Parameters

List Update Monitors' Data SourcesDeprecated

Read Storage Metadata

path Parameters

Update Data Source

path Parameters

Request Body schema: application/jsonrequired

Update Data SourcesDeprecated

path Parameters

Request Body schema: application/jsonrequired

Update Storage

path Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required