Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
titlePwsDeleteClientRq
  • PwsDeleteClientRq
    • CascadeDeleteFlag: Boolean
    • ClientIdentity: PwsClientRef [1]
    • InactivateIfInuseFlag: Boolean

Request Elements


Common Input
ElementData TypeRequired?DefaultDescriptionCommon Input Elements
CascadeDeleteFlagBooleanNo"false"

This flag is set to "true" when the user wants to delete the client and, all of the client's children

  • If set to "false", an attempt to delete a client that has one more children will fail
  • If set to "true", and the client and all of its children can be deleted, all clients are deleted
  • If set to "true", and the InactivateIfInUseFlag is also set to true, the client and its children will be deleted if possible, otherwise they will be marked inactive. A client can be deleted if it is not in use elsewhere and all its children (if any) can be deleted. Otherwise, it must be inactivated
  • If set to "true", and the InactivateIfInUseFlag is set to false, an error is returned (because at least one client cannot be deleted, per bullet 2 above)
ClientIdentityPwsClientRef [1]

This is the identity of the client to be deleted
InactivateIfInuseFlagBooleanNo"false"If set to true, a client that cannot be deleted because it is in use will be set to inactive, otherwise the request will fail.

...

Panel
titlePwsDeleteClientRs

Response Elements


Common Output
ElementData TypeDescriptionCommon Output Elements
ClientIdentityPwsClientRef [0..1]

...

Code Block
languagexml
titleResponse 01
collapsetrue
      <PwsDeleteClientResponse>
         <PwsDeleteClientResult>
            <Messages>
               <PwsMessage>
                  <AdditionalErrorText i:nil="true"/>
                  <ErrorCode i:nil="true"/>
                  <ErrorNumber i:nil="true"/>
                  <ErrorText i:nil="true"/>
                  <Type i:nil="true"/>
                  <ReferenceId1 i:nil="true"/>
                  <ReferenceId2 i:nil="true"/>
               </PwsMessage>
            </Messages>
            <ResponseId>1</ResponseId>
            <Status>Ok</Status>
            <ServerTimestampUtc>2017-12-21T16:14:01.7558585Z</ServerTimestampUtc>
            <ClientIdentity>
               <ClientId i:nil="true"/>
               <ClientNumber>C000117</ClientNumber>
               <ClientUid>1152921504606989806</ClientUid>
            </ClientIdentity>
         </PwsDeleteClientResult>
      </PwsDeleteClientResponse>

Errors and Warnings


ErrorCodeErrorNumberErrorCodeErrorTextType
ClientInactivated101The client could not be deleted and instead it was marked inactiveWarning
UpdatePermissionDenied50046Permission deniedError
UnexpectedErrorDeletingClient57623Unexpected error deleting clientError
ClientHasChildClients57624Client could not be deleted because it has at least one child client (CascadeDeleteFlag = false)Error
ChildClientCouldNotBeDeleted57625Client could not be deleted because it has at least one child client that cannot be deleted (CascadeDeleteFlag = true)Error
ChildIsReferencedByEngagement57626The client could not be deleted because at least one engagement is associated with this client.Error
ClientIsReferencedByUser

57627

Client could not be deleted because it is referenced by at least one userError
ClientIsReferencedByInvoice

57628

Client could not be deleted because it is referenced by at least one invoiceError




...