Overview
This web service adjusts one or more time cards for daily billing. Daily billing allows you to round hours to a whole day and invoice for that day. For example, if you worked four hours, but your minimum billing is for full days, the bill will be adjusted up from four to eight hours.
Request Format
| Panel | ||
|---|---|---|
| ||
|
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 | AWuKIeUvHQC5lNzuzE3Ugg== | |
| AdjustmentCodeIdentity | PwsAdjustmentCodeRef | No | This structure represents the unique key fields associated with identifying an adjustment code. |
| AdjustmentOrders | PwsDailyBillingAdjustmentOrder [1..100] | No | This structure represents the fields associated with a time card daily billing adjustment | ||
| Explanation | String (1024) | No | An explanation as to why this adjustment was applied. | Time Card Description update |
Request Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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:PwsAdjustTimeForDailyBilling>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AWuKIeUvHQC5lNzuzE3Ugg==</req:SessionTicket>
<tim:AdjustmentCodeIdentity>
<com:AdjustmentCodeUid>1152921504606858479</com:AdjustmentCodeUid>
</tim:AdjustmentCodeIdentity>
<tim:AdjustmentOrders>
<tim:PwsDailyBillingAdjustmentOrder>
<tim:NumberDays>2</tim:NumberDays>
<tim:TimeCardIdentities>
<tim:PwsVersionedTimecardRef>
<com:TimecardType>T</com:TimecardType>
<com:TimecardUid>1152921504652486584</com:TimecardUid>
</tim:PwsVersionedTimecardRef>
</tim:TimeCardIdentities>
</tim:PwsDailyBillingAdjustmentOrder>
</tim:AdjustmentOrders>
<tim:Explanation>Agreed with Client</tim:Explanation>
</pws:serviceRequest>
</pws:PwsAdjustTimeForDailyBilling>
</soapenv:Body>
</soapenv:Envelope> |
Response Format
| Panel | ||
|---|---|---|
| ||
|
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 | 2019-11-07T16:34:28.3799228Z |
| TimeCardIdentities | PwsTimeCardRef [1..100] | The identities of the time cards that were updated. |
Response Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<PwsAdjustTimeForDailyBillingResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
<PwsAdjustTimeForDailyBillingResult 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-07T16:34:28.3799228Z</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>
</PwsAdjustTimeForDailyBillingResult>
</PwsAdjustTimeForDailyBillingResponse>
</s:Body>
</s:Envelope> |
PwsAdjustTimeForDailyBilling - Common Errors and Warnings
- For all errors and warnings please refer to the Complete List of Errors and Warnings
ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 20036 | NumberOfDaysOutOfRange | The specified value for number of days is out of range. Please specify a value greater than zero. |
| 50024 | EntityNotFound | Time Card was not found. Another user may have deleted it. |
| 64365 | OneOrMoreTimeCardsIneligibleForAdjustment | Adjustment cannot be completed because one or more cards has changed or is ineligible for adjustment. |