Versions Compared

Key

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

Overview

...

Overview


This web service inserts or updates cost cards based on a detailed cost card structure (PwsCostCardDetail). The service returns the identity (PwsCostCardRef) of the cost card that has been inserted or updated. The caller can optionally request that the full cost card detail (PwsCostCardElement) be included in the response.

...

Panel
titlePwsSaveExpenseDocumentCostCard Request

...

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.

AfMtiadjKEErha/5LNfifA==

Comments

String

No 


Cost Card save / update comments.

Cost Card Creation

CostCard

PwsCostCardDetail

On Insert: No

On Update Yes 

The cost card details of an existing cost card

deprecated


*** This field has been deprecated ***


DeleteReceipts

PwsReceiptRef[]

No 


The receipts to be deleted.


ExpenseDocumentIdentity

PwsExpenseDocumentRef

On Insert: yes

On Update: No 


The expense document associated with the cost card.


ExpenseDocumentTimestamp

String

No


This is a Base64 encoded timestamp utilized for expense document locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned by a call to PwsSaveExpenseDocument PwsGetExpenseDocumentCostCard (or a prior call to PwsSaveExpenseDocument PwsSaveExpenseDocumentCostCard). This will cause the request to fail if any change has been made between invocations of PwsGetExpenseDocument and PwsSaveExpenseDocumentPwsGetExpenseDocumentCostCard and PwsSaveExpenseDocumentCostCard.


FullDetailFlag

Boolean

No 

false

If set to 'true', include full detailed cost card element in response

true

InsertReceiptsIfNotFoundOnUpdateFlag

Boolean

No


If set to 'true', specified receipts that are not found during an update will instead be inserted.

false

ResourceIdentity

PwsResourceRef

On Insert: No

On Update No 

The identity of the resource associated with the cost card

deprecated



** This field has been deprecated **


SaveReceipts

PwsReceiptDetail[]

On Insert: No

On Update: No 


The receipt details to be inserted or updated


UpdateReceiptsIfFoundOnInsertFlag

Boolean

deprecated


** This field has been deprecated **


PreserveCostCardStatusFlag

Boolean

deprecatedeprecated



** This field has been deprecated **


CostCards

PwsCostCardDetail[]

On Insert: Yes

On Update: No


The cost card details of a new cost card


...

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.

2018-03-21T16:29:51.9180181Z

CostCard

PwsCostCardElement

The details of the existing cost card. Applies if FullDetailFlag specified on input. If multiple cost card (less any subordinate entities)cards saved, this is the first cost card. Maintained for backward compatibility.


CostCardIdentity

PwsCostCardRef

The key fields of the updated or inserted cost card. If multiple cost cards saved, this is the first cost card. Maintained for backward compatibility.


CostCardResult

PwsSaveCostCardResult

The error details of a failed cost card save.


ExpenseDocumentTimestamp

String

This is a Base64 encoded timestamp utilized for expense document locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned by a call to PwsSaveExpenseDocument (or a prior call to PwsSaveExpenseDocument). This will cause the request to fail if any change has been made between invocations of PwsGetExpenseDocument and PwsSaveExpenseDocument.See Request Elements above for details.

AAAAAA64T1w=

Location

PwsLocationSummary

The cost card location. If multiple cost cards saved, this is the location of the first cost card. Maintained for backward compatibility.


ReceiptResults

PwsSaveReceiptResult[]

The error details of a failed receipt insert or savefor receipts that failed to be inserted or updated.


SaveSucceededFlag

Boolean

If set to 'true', the save has succeeded.

true

CostCardIdentities

PwsCostCardRef[]

The key fields of the inserted cost cardcards.


CostCards

PwsCostCardElement[]

The details of the new cost card (less any subordinate entities)cards. Applies if FillDetailFlag specified on input.


Response Usage Example(s)

...