Versions Compared

Key

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

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

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.

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


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 (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.


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


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

deprecate



** This field has been deprecated **


CostCards

PwsCostCardDetail[???]

On Insert: Yes

On Update: No


The cost card details of a new cost card


...

Panel
titlePwsSaveExpenseDocumentCostCard Response

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

2018-03-21T16:29:51.9180181Z

CostCard

PwsCostCardElement

The details of the existing cost card (less any subordinate entities)


CostCardIdentity

PwsCostCardRef

The key fields of the updated cost card


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.

AAAAAA64T1w=

Location

PwsLocationSummary

The cost card location


ReceiptResults

PwsSaveReceiptResult[???]

The error details of a failed receipt insert or save


SaveSucceededFlag

Boolean

If set to 'true', the save has succeeded

true

CostCardIdentities

PwsCostCardRef[???]

The key fields of the inserted cost card


CostCards

PwsCostCardElement[???]

The details of the new cost card (less any subordinate entities)


...

ErrorNumber

ErrorCode

ErrorText

137

CostCardDescriptionTruncated

The specified cost card description exceeded the maximum length of 4000 characters and was truncated.

19001CostCardErrorsOne or more cost cards could not be saved. The expense document was not created. Check CostCardResults for specific errors.
19012NewCostCardProjectIdentityRequiredNew project identity is required for the cost card transfer.
19020ExpenseDocumentNotSpecifiedForSaveCostCardNo expense document was specified.
19033InvalidValueForCostCardIncurredDateThe value specified for the cost card incurred date is invalid. Dates must be specified in UTC, with no time component (e.g. midnight UTC).
19038CostCardIdentityRequiredForReceiptCostCardCost card identity is required.
19045CostCardIdentitiesRequiredOne or more cost card identities must be specified.
19059CostCardIdentityRequiredA cost card identity must be specified.
65152UnexpectedCostCardUdfValueUnexpected UDF value provided (UDF metadata may have changed)
65153CostCardIncurredDateRangeNotValidSpecified incurred date outside the supported date range.
65196ReceiptsMayNotBeAssociatedWithIndividualCostCardsAccount is configured not to allow receipts to be attached to individual cost cards.
65200CostCardHasBeenChangedCost card has been changed by another user.
65336CannotChangeSubmittedCostCardsApClosedCannot save changes to submitted cost card because the accounting period is closed for expenses.
65374CostCardHasBeenDeletedOne or more referenced cost card(s) have been deleted.
65379SaveCardCostCardHasBeenDeletedReferenced cost card has been deleted.
65385SaveReceiptCostCardHasBeenDeletedReferenced cost card has been deleted.
65393SelectCardCostCardHasBeenDeletedReferenced cost card has been deleted.
65470SpecifiedCostCardDoesNotBelongToSpecifiedExpenseDocumentCost card/expense document mismatch
65487LocationInactiveOrNotEnabledForCostCardsSpecified location is inactive or not enabled for cost cards.
65489CostCardRefInvalidCostCardRef is required
65491CostCardNotFoundCostCard not found
65492ExpenseDocumentRefInvalidExpenseDocumentRef is required
65494ExpenseDocumentNotFoundExpense document not found
65495ExpenseDocumentHasBeenUpdatedByAnotherUserExpense document has been changed.
65502ReceiptRefInvalidReceiptRef is required
65504ReceiptNotFoundReceipt not found
65510ReceivedFlagIsRequiredReceived flag must not be null
65519CostCardAlreadyApprovedThis cost card cannot be saved because it is already approved
65520IncurredDateIsRequiredForNewCostCardsIncurred date is required for new cost cards
65521TotalAmountDisbursedCurrencyIsRequiredForNewCostCardsTotal amount in disbursed currency is required for new cost cards
65522IncurredAmountIsRequiredForNewFxCostCardsIncurred amount is required for new cost cards with differing incurred and disbursed currencies
65523IncurredAndDisbursedAmountMismatchIncurred/disbursed total amount mismatch
65525UserDefinedFieldValueUnavailableSpecified user defined field value is unavailable on at least one selected cost card.
65529ExpenseReportResourceMustMatchCostCardResourceExpense report resource must match cost card resource