Overview

This web service deletes a specified client (PwsClientRef). The service will return the identity of the deleted client (PwsClientRef).

Rate Limiting

In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior.

Request Format

PwsDeleteClient Request

PwsDeleteClientRq
- RequestId: Int32
- SessionTicket: String
- CascadeDeleteFlag: Boolean
- ClientIdentity: PwsClientRef
- InactivateIfInuseFlag: Boolean

Request Elements

Element	Data Type	Required?	Default	Description	Sample Data
RequestId	Int32	No		Click here for more information	1
SessionTicket	String	Yes		Click here for more information	AavFwbZgVb9V4tr3R7BbzQ==
CascadeDeleteFlag	Boolean	No	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)	true/false
ClientIdentity	PwsClientRef	Yes		This is the identity of the client to be deleted
InactivateIfInuseFlag	Boolean	No	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	true/false

Request Usage Example(s)

Example 01

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsDeleteClient>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AavFwbZgVb9V4tr3R7BbzQ==</req:SessionTicket>
            <req:CascadeDeleteFlag>true</req:CascadeDeleteFlag>
            <req:ClientIdentity>
               <com:ClientNumber>C000122</com:ClientNumber>
            </req:ClientIdentity>
            <req:InactivateIfInuseFlag>true</req:InactivateIfInuseFlag>
         </pws:serviceRequest>
      </pws:PwsDeleteClient>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

PwsDeleteClientRs

PwsDeleteClientRs
- Messages: PwsMessage[]
- ResponseId: Int32
- Status: RequestStatus
- ServerTimestampUtc: DateTime
- PwsClientRef

Response Elements

Element	Data Type	Description	Sample Data
Messages	PwsMessage[]	The web service response status and message. Click here for more information.
ResponseId	Int32	Click here for more information	1
Status	RequestStatus	Click here for more information	Ok
ServerTimestampUtc	DateTime	Click here for more information	2018-01-17T19:00:18.2269303Z
ClientIdentity	PwsClientRef	The identity of the deleted client

Response Usage Example(s)

Example 01

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsDeleteClientResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsDeleteClientResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-01-17T19:00:18.2269303Z</ServerTimestampUtc>
            <a:ClientIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:ClientId i:nil="true"/>
               <b:ClientNumber>C000122</b:ClientNumber>
               <b:ClientUid>1152921504606998463</b:ClientUid>
            </a:ClientIdentity>
         </PwsDeleteClientResult>
      </PwsDeleteClientResponse>
   </s:Body>
</s:Envelope>

PwsDeleteClient - Common Errors and Warnings

For all errors and warnings please refer to the Complete List of Errors and Warnings

ErrorNumber	ErrorCode	ErrorText
101	ClientInactivated	The client could not be deleted and instead it was marked inactive
50046	UpdatePermissionDenied	You do not have permission to update this item.
57623	UnexpectedErrorDeletingClient	There was an unexpected error while trying to delete the client.
57624	ClientHasChildClients	The client could not be deleted because there are one or more child clients of this client.
57625	ChildClientCouldNotBeDeleted	The client could not be deleted because one of its child clients could not be deleted.
57626	ChildIsReferencedByEngagement	The client could not be deleted because at least one engagement is associated with this client.
57627	ClientIsReferencedByUser	The client could not be deleted because at least one user is associated with this client.
57628	ClientIsReferencedByInvoice	The client could not be deleted because at least one invoice is associated with this client.
57629	ClientNotFound	The specified client was not found.
57631	ClientNotSpecified	A specified client identity was incomplete. Each client identity must specify either a client id, client uid or client number.