Overview
This web service inserts or updates a single contract line item based on a detailed contract line item structure (PwsContractLineItemDetail). The service returns the identity (PwsContractLineItemRef) of the contract line item that has been inserted or updated.
...
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
Int32 | No | Click here for more information. | 1 | ||
String | Yes | Click here for more information. | AdDMw48w49OxnEUPGUuMSw== | ||
ContractLineItem | Yes | The detailed contract line item information to be inserted or updated. | |||
EngagementCurrencyIdentity | Yes | The currency of the engagement this contract line item resides under. | |||
EngagementTimestamp | String | No | This is a Base64 encoded timestamp utilized for engagement locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned by a call to PwsGetContractLineItem (or a prior call to PwsSaveContractLineItem). This will cause the request to fail if any change has been made between invocations of PwsGetContractLineItem and PwsSaveContractLineItem. | ||
StealLockFlag | Boolean | deprecated | |||
ContractTypeClearFlag | Boolean | No | false | If set to 'true', the contract type associated with the contract line item will be set to null. This is equivalent to using a 'custom' contract type. | false |
OverageProjectClearFlag | Boolean | No | false | If set to 'true', the overage project associated with the contract line item will be set to null. | false |
| NewContractLineItemCode | String (27) | No | The new contract item code after update or create/insert. | ||
| LocksToSteal | PwsEntityLockSummary[1.100] | No | The detailed information of the locks that are to be stolen. If not specified, the request will fail if any requested locks are already held. If specified, the information supplied must exactly match the current state of existing locks or the attempt to steal the existing locks will fail. Typically, this service is invoked with LocksToSteal empty or null. If there are existing locks, they will be returned in the LockHolders member of PwsFault. This data can then be sent, as is, back to the server in a second invocation of this service, as LocksToSteal, if the caller desires to steal the locks. | ||
| ProjectorLockSetId | Int32 | No | A projector lock set id is an identifier for a group of one or more locks held as a unit. |
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:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsSaveContractLineItem>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AdDMw48w49OxnEUPGUuMSw==</req:SessionTicket>
<sch:ContractLineItem>
<com:ContractLineItemName>Phase 2</com:ContractLineItemName>
<com:EngagementIdentity>
<com:EngagementCode>P001320</com:EngagementCode>
</com:EngagementIdentity>
<com:HoldbackAmount>5000</com:HoldbackAmount>
<com:HoldbackType>A</com:HoldbackType>
<com:MaxTimeContractAmount>50000</com:MaxTimeContractAmount>
<com:MinTimeContractAmount>50000</com:MinTimeContractAmount>
<com:RevenueEarnedByDate>2017-06-30T00:00:00.000Z</com:RevenueEarnedByDate>
<com:RevenueRecognitionMethod>P</com:RevenueRecognitionMethod>
<com:ContractTypeIdentity>
<com:ContractTypeName>Fixed Price Plus Expenses</com:ContractTypeName>
</com:ContractTypeIdentity>
<com:InheritPurchaseOrderNumberFlag>false</com:InheritPurchaseOrderNumberFlag>
<com:ModelContractedHoursAndOveragesFlag>false</com:ModelContractedHoursAndOveragesFlag>
<com:PurchaseOrderNumber>WS1320-P1</com:PurchaseOrderNumber>
</sch:ContractLineItem>
<sch:EngagementCurrencyIdentity>
<com:CurrencyCode>USD</com:CurrencyCode>
</sch:EngagementCurrencyIdentity>
<sch:StealLockFlag>false</sch:StealLockFlag>
<sch:ContractTypeClearFlag>false</sch:ContractTypeClearFlag>
<sch:OverageProjectClearFlag>false</sch:OverageProjectClearFlag>
</pws:serviceRequest>
</pws:PwsSaveContractLineItem>
</soapenv:Body>
</soapenv:Envelope> |
...