deleteParty

Description
This transaction can be used to delete a party record from the operational system based on a number of externalized rules.
Web Services
Operation name: deleteParty
Service name: PartyService
Example
Remove a party record, and its associated actions and events, when that party information is no longer necessary.
Usage information
This transaction applies to both person and organization parties, active or inactive.

A party cannot be deleted if its Do Not Delete Indicator (DND) value does not allow it:

  • If DND is blank or zero, neither operational or history data can be deleted.
  • If DND is 1, both operational and history data can be deleted.
  • If DND is 2, only party history can be deleted.

A party cannot be deleted if it is associated with one of the following entities:

  • an active Alert
  • an active PartyRelationship
  • an active PartyRelationshipRole
  • an active bank account or charge card or payroll deduction that are active payment sources for summary billings
  • an active Grouping association
  • an active GroupingRole
  • an active ContractPartyRole
  • an active PartyMacroRole
  • an active ClaimPartyRole
  • an active Hierarchy node
  • an active entity Hierarchy role
  • a pending critical data update request
  • an active Product-Party Role

A party cannot be deleted when its partyId is referenced in the providedByCont field in another CONTACT table record.

For a successful deleteParty transaction, you must first inactivate all the existing associations listed above.

Do not include a value for the PartyActiveIndicator in the request. This value is determined by the MDM operational server and will be included in the transaction return. This sets the PartyActiveIndicator apart from other indicators such as AlertIndicator, SolicitationIndicator, and ConfidentialIndicator.

Preconditions
Party must exist.
Mandatory input
  • PartyId
Inquiry levels
Not applicable
Filter values
Not applicable
Transaction behavior
  • Deleting a Party record includes the deletion of a Party's child objects and a Party's associated objects. There are 4 external rules that regulate the deleteParty transaction:
  • Rule Id 89 – This external rule retrieves all party and child objects to validate and then delete them.
  • Rule Id 90 – This external rule is invoked by each party and child object at the component level for delete validation. This rule has no business logic implementation by default.
  • Rule Id 91 – This external rule retrieves all the party associations and checks for deletion rules around each of the party's association,s with respect to the party. After the checks, it invokes the component delete operation for the party association.
  • Rule Id 92 – This external rule is invoked by ContractPartyRole at the component level, for delete validation. It contains the business delete rules for party role child objects.
  • When a Party is successfully deleted, in History a D, or delete, record is created.
Request message
TCRMTxType> deleteParty

<TCRMTxObject> TCRMPartyBObj

<TCRMObject> TCRMPartyBObj

Response objects
TCRMDeletedPartyBObj

with optional business objects:

Special note
When you delete a party record from the operational table, all associated events, ProcessControl and ProcessAction records created for event management are also deleted.