Versions Compared

Key

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

Overview


This web service adds/update updates a location on one or more existing time cards.

...

Panel
titlePwsAdjustTimeLocation Request

Request Elements


Element

Data Type

Required?

Default

Description

Sample Data

RequestIdInt32No
Click here for more information
1
SessionTicket

String

Yes
Click here for more information
AWuKIeUvHQC5lNzuzE3Ugg==
AdjustmentCodeIdentityPwsAdjustmentCodeRefNo
This structure represents the unique key fields associated with identifying an adjustment code.
 Adjustment codes are required whenever you make a monetary adjustment to a time or cost card.
 
This is not applicable to this service.Explanation

String (1024)

NoAn explanation as to why this adjustment was applied.
Time Card Description update
DescriptionString (1000)YesThe description to be added / updated to the time card
Preliminary Client Meeting
TimeCardIdentitiesPwsVersionedTimeCardRef

NewLocationIdentityPwsLocationRefYes
This structure contains the unique key fields associated with a location.
TimeCardIdentitiesPwsVersionedTimeCardRef [1..100]Yes
This structure represents the unique key fields associated with identifying a Time Card. Time Cards can be identified with a TimeCardUid. 

Request Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsAdjustTimeLocation>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AWuKIeUvHQC5lNzuzE3Ugg==</req:SessionTicket>
            <tim:Explanation>PwsAdjustTimeLocation</tim:Explanation>
            <tim:NewLocationIdentity>
               <com:LocationId>16548</com:LocationId>
            </tim:NewLocationIdentity>
            <tim:TimeCardIdentities>
               <tim:PwsVersionedTimecardRef>
                  <com:TimecardType>T</com:TimecardType>
                  <com:TimecardUid>1152921504652486584</com:TimecardUid>
               </tim:PwsVersionedTimecardRef>
            </tim:TimeCardIdentities>
         </pws:serviceRequest>
      </pws:PwsAdjustTimeLocation>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


Panel
titlePwsAdjustTimeLocation Response

Response Elements


Element

Data Type

Description

Sample Data

MessagesPwsMessage[]

The web service response status and message. Click here for more information.


ResponseIdInt32Click here for more information
1
StatusRequestStatusClick here for more information
Ok
ServerTimestampUtcDateTimeClick here for more information
2019-11-07T17:09:11.3549604Z
TimeCardIdentitiesPwsTimeCardRef [1..100]The identities of the time cards that were updated.

Response Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsAdjustTimeLocationResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsAdjustTimeLocationResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" 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/">2019-11-07T17:09:11.3549604Z</ServerTimestampUtc>
            <a:TimeCardIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsTimecardRef>
                  <b:ReferenceId i:nil="true"/>
                  <b:TimecardId>45639608</b:TimecardId>
                  <b:TimecardType>T</b:TimecardType>
                  <b:TimecardUid>1152921504652486584</b:TimecardUid>
               </b:PwsTimecardRef>
            </a:TimeCardIdentities>
         </PwsAdjustTimeLocationResult>
      </PwsAdjustTimeLocationResponse>
   </s:Body>
</s:Envelope>

PwsAdjustTimeLocation - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

50024EntityNotFoundNew Location: Location was not found. Another user may have deleted it.
50024EntityNotFoundTime Card was not found. Another user may have deleted it.
64365OneOrMoreTimeCardsIneligibleForAdjustment

Adjustment cannot be completed because one or more cards has changed or is ineligible for adjustment.