Overview
This web service can be used to create a web invoice. You specify the attributes to use for invoice creation by providing a InvoiceSpec, an instance of PwsCandidateInvoiceSpec. This structure allows you to specify the name, scope and content of the invoice, the approval statuses and other invoice attributes. See below for full details. The caller can optionally request that the full invoice detail PwsInvoiceElement be included in the response.
...
Element | Data Type | Required? | Default | Description | |
|---|---|---|---|---|---|
| RequestId | Int32 | No | Click here for more information | ||
| SessionTicket | String | Yes | Click here for more information | ||
| AddCommentsToInvoiceMessagesFlag | Boolean | No | False | True to prepend comments (NewInvoiceMessages) to invoice message | |
| ExcludeZeroAmountCostCardsFlag | Boolean | No | False | True to exclude time cards with no value from invoice | |
| ExcludeZeroAmountTimeCardsFlag | Boolean | No | False | True to exclude cost cards with no value from invoice | |
| FullDetailFlag | Boolean | No | False | True to include the full details of the invoice in the response | |
| IncludeAdjustmentHistoryFlag | Boolean | No | False | If FullDetailsFlag is set, true to include adjustment history in invoice detail | |
| IncludeFullAdjustmentHistoryFlag | Boolean | No | False | If FullDetailsFlag is set and IncludeAdjustmentHistoryFlag is set, true to include full card breakdown with each | |
| InvoiceSpec | PwsCandidateInvoiceSpec | Yes | Attributes of the new invoice to be created | ||
| NewInvoiceMessages | String (1000) | No | Invoice message to include workflow email. May also be added to invoice messages for the new invoice | ||
| NotifyFinanceTeamFlag | Boolean | No | False | True to send an e-mail to the finance team response for finance approval of invoice upon creation | |
| NotifyManagementTeamFlag | Boolean | No | False | True to send an e-mail to the management team response for management approval of invoice upon creation | |
| NotifyPmTeamFlag | Boolean | No | False | True to send an e-mail to the PM team response for project manager approval of invoice upon creation |
Request Usage Example(s)
Response Format
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
| 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:bil="http://projectorpsa.com/DataContracts/Shared/Billing/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsCreateInvoice>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AcDDhcCta4Wna3CCTQ5Fng==</req:SessionTicket>
<bil:AddCommentsToInvoiceMessagesFlag>true</bil:AddCommentsToInvoiceMessagesFlag>
<bil:ExcludeZeroAmountCostCardsFlag>false</bil:ExcludeZeroAmountCostCardsFlag>
<bil:ExcludeZeroAmountTimeCardsFlag>false</bil:ExcludeZeroAmountTimeCardsFlag>
<bil:FullDetailFlag>true</bil:FullDetailFlag>
<bil:IncludeAdjustmentHistoryFlag>true</bil:IncludeAdjustmentHistoryFlag>
<bil:IncludeFullAdjustmentHistoryFlag>true</bil:IncludeFullAdjustmentHistoryFlag>
<bil:InvoiceSpec>
<bil:ApprovedByFinanceFlag>false</bil:ApprovedByFinanceFlag>
<bil:ApprovedByManagementFlag>false</bil:ApprovedByManagementFlag>
<bil:ApprovedByProjectManagerFlag>false</bil:ApprovedByProjectManagerFlag>
<bil:BillingCultureIdentity>
<com:CultureName>en-US</com:CultureName>
</bil:BillingCultureIdentity>
<bil:CardBeginDate>2022-07-01T00:00:00.000Z</bil:CardBeginDate>
<bil:CardEndDate>2022-07-05T00:00:00.000Z</bil:CardEndDate>
<bil:ClientIdentity>
<com:ClientNumber>Amazon</com:ClientNumber>
</bil:ClientIdentity>
<bil:CostCenterIdentity>
<com:CostCenterName>Executive Team (USA)</com:CostCenterName>
</bil:CostCenterIdentity>
<bil:EngagementCurrencyIdentity>
<com:CurrencyCode>USD</com:CurrencyCode>
</bil:EngagementCurrencyIdentity>
<bil:EngagementIdentity>
<com:EngagementCode>P001666</com:EngagementCode>
</bil:EngagementIdentity>
<bil:EngagementInvoiceContent>B</bil:EngagementInvoiceContent>
<bil:InvoiceContent>B</bil:InvoiceContent>
<bil:InvoiceName>Invoice - WS</bil:InvoiceName>
<bil:InvoiceScope>P</bil:InvoiceScope>
<bil:ProjectIdentity>
<com:ProjectCode>P001666-001</com:ProjectCode>
</bil:ProjectIdentity>
<bil:PurchaseOrderNumber>Invoice - WS</bil:PurchaseOrderNumber>
</bil:InvoiceSpec>
<bil:NewInvoiceMessages>Invoice - WS</bil:NewInvoiceMessages>
<bil:NotifyFinanceTeamFlag>true</bil:NotifyFinanceTeamFlag>
<bil:NotifyManagementTeamFlag>true</bil:NotifyManagementTeamFlag>
<bil:NotifyPmTeamFlag>true</bil:NotifyPmTeamFlag>
</pws:serviceRequest>
</pws:PwsCreateInvoice>
</soapenv:Body>
</soapenv:Envelope> |
Response Format
| Code Block | ||||
|---|---|---|---|---|
| ||||
{panel:title=PwsCreateInvoice Response}
* PwsCreateInvoiceResponse
** PwsCreateInvoiceResult: [PwsCreateInvoiceRs]
*** Messages: [PwsMessage][]
*** [ResponseId]: Int32
*** [Status]: RequestStatus
*** [ServerTimestampUtc]: DateTime
*** Invoice: [PwsInvoiceElement]
*** InvoiceIdentity: [PwsInvoiceRef]
*** InvoiceTimestamp: String
{panel} |
Response Elements
Element | Data Type | Description | Sample Data |
|---|---|---|---|
Messages | The web service response status and message. Click here for more information. | ||
ResponseId | Int32 | Click here for more information | 1 |
Status | Click here for more information. | Ok | |
ServerTimestampUtc | DateTime | Click here for more information | 2018-01-29T21:55:08.7579802Z |
EngagementLockStolenFromUserIdentity | **deprecated** | ||
EngagementTimestamp | String | **deprecated** | AAAAAA62DGw= |
ProjectCostBaseline | The complete set of information about the project cost baseline. Specify FullDetailFlag = true in request to get this value returned in the response. | ||
ProjectCostBaselineIdentity | The unique keys used to identify the project cost baseline | ||
| ProjectTimestamp | String | This is an optimistic locking timestamp that, if provided on update request, will cause the request to fail when the timestamp stored in the database does not match the provided value. | AAAAABFFCOw= |
| StolenLocks | PwsEntityLockSummary[1..100] | This structure contains information about the locks that were stolen in order to complete this request, Will be included only when LocksToSteal is specified in the request. |
...