Toggle Business Partners Update Monitoring

To toggle update monitoring on multiple BusinessPartners, the permission can be changed via a list of Business Partners, identified by their ID.

After the job is finished, the following actions are taken for Business Partners which match the businessPartnerIds criteria:

businessPartner.updateMonitoring fields takes a value of ToggleUpdateMonitoringJobRequest#enable
if enable is true then:
- an attempt is taken to find Business Partner in all configured update monitors for non-commercial reference data sources and links are created if matches are found via defined linkage strategies
- if the storage has UPDATES feature activated, updates for linked Business Partners from non-commercial reference data sources are propagated to Business Partner updates
if enable is false then:
- all existing links of a Business Partner to Business Partners in non-commercial reference data sources are removed
- updates are no more propagated for this Business Partner
- linkage is not performed for any non-commercial reference data source

For toggling a complete Data Source or for a certain Country of a Data Source, please go to Start Toggle Update Monitoring Job.

SecurityapiKey

Request

storageId

required

string (BusinessPartnerStorageId)

Unique identifier of the Storage.

Example: 72d6900fce6b326088f5d9d91049e3e6

businessPartnerIds required	Array of strings (BusinessPartnerId) [ 1 .. 1000 ] items List of Business Partner IDs to identify all those Business Partners that should be activated/deactivated. Example: ["63e635235c06b7396330fe40"]
enable required	boolean (ToggleUpdateMonitoringRequestEnable) Parameter to describe if the Business Partners should be activated for update monitoring (true) or deactivated (false) for non-commercial reference data sources. Example: "true"

Responses

204

put/storages/{storageId}/businesspartners/toggleUpdateMonitoring

Request samples

application/json

{"enable": "true",
"businessPartnerIds": ["63e635235c06b7396330fe40"
]
}