PwsTransferCost

Owned by Bettina Borces
Nov 11, 2019
4 min read

Overview


This web service transfers one or more cost cards to another project.

Request Format


PwsTransferTime

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
Ae5AvD6kVj/g6kTMZkFbBQ==
AdjustRoleDatesAsNeededFlagBooleanNofalseIf set to true, the start and/or end date on any associated roles will be adjusted to accommodate the work date on the cost card(s)
true
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)

No
An explanation as to why this adjustment was applied.
cost card transfer
ReportOnlyFlagBooleanNo
If set to "true", the cost card importing process is exercised, but not completed. If there is any error triggered during the importing process, it will be reported in the response.
false
TransferOrdersPwsCostTransferOrderYes
This structure represents the cost cards that will be transferred

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:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsTransferCost>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>Ae5AvD6kVj/g6kTMZkFbBQ==</req:SessionTicket>
            <tim:AdjustProjectDatesAsNeededFlag>true</tim:AdjustProjectDatesAsNeededFlag>
            <tim:AdjustmentCodeIdentity>
               <com:AdjustmentCodeName>Other</com:AdjustmentCodeName>
               <com:AdjustmentCodeUid>1152921504606858479</com:AdjustmentCodeUid>
            </tim:AdjustmentCodeIdentity>
            <tim:Explanation>cost card transfer</tim:Explanation>
            <tim:ReportOnlyFlag>false</tim:ReportOnlyFlag>
            <tim:TransferOrders>
               <tim:PwsCostTransferOrder>
                  <tim:CostCardIdentities>
                     <tim:PwsVersionedCostCardRef>
                        <com:CostCardUid>1152921504614693734</com:CostCardUid>
                     </tim:PwsVersionedCostCardRef>
                  </tim:CostCardIdentities>
                  <tim:NewProjectIdentity>
                     <com:ProjectCode>P001556-001</com:ProjectCode>
                  </tim:NewProjectIdentity>
               </tim:PwsCostTransferOrder>
            </tim:TransferOrders>
         </pws:serviceRequest>
      </pws:PwsTransferCost>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


PwsTransferTime 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-07T22:24:06.8248708Z
CostCardIdentitiesPwsCostCardRefThe identities of the time cards that were updated.

Response Usage Example(s)


Example 01 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsTransferTimeResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsTransferTimeResult 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-07T22:24:06.8248708Z</ServerTimestampUtc>
            <a:TimeCardIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsTimecardRef>
                  <b:ReferenceId i:nil="true"/>
                  <b:TimecardId>45639611</b:TimecardId>
                  <b:TimecardType>T</b:TimecardType>
                  <b:TimecardUid>1152921504652486587</b:TimecardUid>
               </b:PwsTimecardRef>
            </a:TimeCardIdentities>
            <a:TimecardValuationReport/>
         </PwsTransferTimeResult>
      </PwsTransferTimeResponse>
   </s:Body>
</s:Envelope>

PwsTransferTime - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

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.