PwsTransferOverageHours

Owned by Bettina Borces
Last updated: Nov 07, 2019
3 min read

Overview


This web service is used in the context of a service contract to transfer hours from a contract line item to a contract line item associated with an overage project

Request Format


PwsTransferOverageHours

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==
TransferOrdersPwsOverageTransferOrderNo
This structure represents the fields associated with a service contract overage hours transfer

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:PwsTransferOverageHours>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AWuKIeUvHQC5lNzuzE3Ugg==</req:SessionTicket>
            <tim:TransferOrders>
               <tim:PwsOverageTransferOrder>
                  <tim:ActualsCutoffDate>2019-10-14T00:00:00.000Z</tim:ActualsCutoffDate>
                  <tim:ContractLineItemIdentity>
                     <com:ContractLineItemUid>1152921504607111583</com:ContractLineItemUid>
                  </tim:ContractLineItemIdentity>
               </tim:PwsOverageTransferOrder>
            </tim:TransferOrders>
         </pws:serviceRequest>
      </pws:PwsTransferOverageHours>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


PwsTransferOverageHours 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-06T17:18:38.6934436Z
TransferResultsPwsOverageTransferResultThe identities of the contract line items that were affected

Usage Example(s)


Example 01 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsTransferOverageHoursResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsTransferOverageHoursResult 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-07T21:08:59.2772811Z</ServerTimestampUtc>
            <a:TransferResults>
               <a:PwsOverageTransferResult>
                  <a:AffectedContractLineItemIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                     <b:PwsContractLineItemRef>
                        <b:ContractLineItemCode>P001552-CL1</b:ContractLineItemCode>
                        <b:ContractLineItemId>264607</b:ContractLineItemId>
                        <b:ContractLineItemUid>1152921504607111583</b:ContractLineItemUid>
                     </b:PwsContractLineItemRef>
                     <b:PwsContractLineItemRef>
                        <b:ContractLineItemCode>P001552-CL2</b:ContractLineItemCode>
                        <b:ContractLineItemId>264608</b:ContractLineItemId>
                        <b:ContractLineItemUid>1152921504607111584</b:ContractLineItemUid>
                     </b:PwsContractLineItemRef>
                  </a:AffectedContractLineItemIdentities>
                  <a:ReferenceIdentity i:nil="true"/>
               </a:PwsOverageTransferResult>
            </a:TransferResults>
         </PwsTransferOverageHoursResult>
      </PwsTransferOverageHoursResponse>
   </s:Body>
</s:Envelope>

PwsTransferOverageHours - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

50024EntityNotFoundContract Line Item was not found. Another user may have deleted it.
64138CannotTransferOverageDueToWrongCliTypeThis adjustment is only supported for contract line items that support contracted hours and overages.
64142CannotTransferOverageDueToNoPriorPeriodThere is no completed contract period prior to the cutoff date.
64157CannotTransferOverageDueToNoOverageHoursThere are no overage hours to be transferred.