Versions Compared

Key

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

Overview


This web service writes up/down selected cost cards, suppresses them from invoicing, and creates a single invoice-ready cost card for each combination of resource, project, expense report, and day. Per diem cost cards will be created within the same expense report as the cost cards they were created from.

...

Panel
titlePwsAdjustCostForPerDiem Request

...

This structure represents the unique key fields associated with identifying a cost Card

Element

Data Type

Required?

Default

Description

Sample Data

RequestIdInt32No
Click here for more information
1
SessionTicket

String

Yes
Click here for more information
AWuKIeUvHQC5lNzuzE3UggAZZLhIFhqIg+w/UlZKyCfg==
AdjustmentCodeIdentityPwsAdjustmentCodeRefNo
This structure represents the unique key fields associated with identifying an adjustment code. Adjustment codes are required whenever you make some monetary adjustment to a time or cost card.  This is not applicable to this service.CostCardIdentitiesPwsVersionedCostCardRefYes.
AdjustmentOrdersPwsPerDiemAdjustmentOrder [1..100]Yes
This structure represents the fields associated with a per diem cost card adjustment
Explanation

String (1024)

No
An explanation as to why this adjustment was applied.
Per Diem adjustment

...

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:PwsAdjustCostForPerDiem>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AWuKIeUvHQC5lNzuzE3UggSessionTicket>AZZLhIFhqIg+w/UlZKyCfg==</req:SessionTicket>
            <tim:AdjustmentCodeIdentity>
               <com:AdjustmentCodeName>Other</com:AdjustmentCodeName>
               <com:AdjustmentCodeUid>1152921504606858479</com:AdjustmentCodeUid>
            </tim:AdjustmentCodeIdentity>
            <tim:AdjustmentOrders>
               <tim:PwsPerDiemAdjustmentOrder>
                  <tim:CostCardIdentities>
                     <tim:PwsVersionedCostCardRef>
                        <com:CostCardUid>1152921504614678656<:CostCardUid>1152921504614693606</com:CostCardUid>
                     </tim:PwsVersionedCostCardRef>
                     <tim:PwsVersionedCostCardRef>
                        <com:CostCardUid>1152921504614693607</com:CostCardUid>
                     </tim:PwsVersionedCostCardRef>
                  </tim:CostCardIdentities>
                  <tim:ExpenseTypeIdentity>
                     <com:ExpenseTypeName>Per Diem</com:ExpenseTypeName>
                     <com:ExpenseTypeUid>1152921504606881747</com:ExpenseTypeUid>
                  </tim:ExpenseTypeIdentity>
                  <tim:PerDiemAmount>100</tim:PerDiemAmount>
               </tim:PwsPerDiemAdjustmentOrder>
            </tim:AdjustmentOrders>
            <tim:Explanation>Per Diem adjustment</tim:Explanation>
         </pws:serviceRequest>
      </pws:PwsAdjustCostForPerDiem>
   </soapenv:Body>
</soapenv:Envelope>

...

Panel
titlePwsAdjustCostForPerDiem 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
CostCardIdentitiesPwsCostCardRef [1..100]The identities of the cost 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>
      <PwsAdjustCostForPerDiemResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsAdjustCostForPerDiemResult 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-11T1511T16:5734:0533.3206586Z<6517829Z</ServerTimestampUtc>
            <a:CostCardIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsCostCardRef>
                  <b:CostCardId>7846630</b:CostCardId>
                  <b:CostCardUid>1152921504614693606</b:CostCardUid>
                  <b:ReferenceId i:nil="true"/>
               </b:PwsCostCardRef>
               <b:PwsCostCardRef>
                  <b:CostCardId>7064419<CostCardId>7846631</b:CostCardId>
                  <b:CostCardUid>1152921504613911395<CostCardUid>1152921504614693607</b:CostCardUid>
                  <b:ReferenceId i:nil="true"/>
               </b:PwsCostCardRef>
               <b:PwsCostCardRef>
                  <b:CostCardId>7846629<CostCardId>7846632</b:CostCardId>
                  <b:CostCardUid>1152921504614693605<CostCardUid>1152921504614693608</b:CostCardUid>
                  <b:ReferenceId i:nil="true"/>
               </b:PwsCostCardRef>
            </a:CostCardIdentities>
         </PwsAdjustCostForPerDiemResult>
      </PwsAdjustCostForPerDiemResponse>
   </s:Body>
</s:Envelope>


PwsAdjustCostForPerDiem

...

-

...

common Errors and Warnings

...

ErrorNumber

ErrorCode

ErrorText

50024EntityNotFoundCost Card was not found. Another user may have deleted it.
64365OneOrMoreTimeCardsIneligibleForAdjustmentAdjustment cannot be completed because one or more cards has changed or is ineligible for adjustment.
65171PdcCostCardGroupingErrorAll cost cards for a particular resource and date must be from a single project and expense document.
65374CostCardHasBeenDeletedOne or more referenced cost card(s) have been deleted.