UpdateUnissuedInvoice
- Bettina Borces
- Luke Wright
Updates the various details associated with an unissued invoice. Unissued invoices can be uniquely identified with an invoice number.
Request
The service request contains:
Name | Data Type | Required? | Default Value | Description |
|---|---|---|---|---|
InvoiceNumber | String(20) | yes | The invoice number is a unique identifier for an Invoice. | |
InvoiceName | String (100) | no | The name of the invoice. This is not a unique identifier for an invoice. | |
InvoiceDate | DateTime | no | This date is used to determine the accounting period that the invoice issue transaction will be placed in when it is queued for transmission to the accounting system. This date is also used as the start date for payment terms, such as net 30. | |
PurchaseOrderNumber | string | no | The optional purchase order number associated with this invoice | |
BillingInstructions | String (1000) | no | Optional workflow Instructions to people within your organization regarding this invoice. These instructions will not appear on the invoice. | |
TaxTypeCode1 | Int32 | no | The code of the first tax type to be applied to the invoice | |
TaxableAmount1 | Double | no | 0 | The tax amount to be applied to the invoice in association with the first tax type code (see above) |
TaxTypeCode2 | Int32 | no | The code of the second tax type to be applied to the invoice | |
TaxableAmount2 | Double | no | 0 | The tax amount to be applied to the invoice in association with the second tax type code (see above) |
TaxTypeCode3 | Int32 | no | The code of the third tax type to be applied to the invoice | |
| TaxableAmount3 | Double | no | 0 | The tax amount to be applied to the invoice in association with the third tax type code (see above) |
| InvoiceTimestamp | String | no | This is a Base64 encoded timestamp optionally utilized for time card locking. If specified, it must match the existing timestamp on the invoice or the save operation will fail | |
| ApprovedByFinanceFlag | Boolean | no | false | If set to 'true', the invoice will be considered to be approved by finance |
| ApprovedByPMFlag | Boolean | no | false | If set to 'true', the invoice will be considered to be approved by project management |
| ApprovedByMgmtFlag | Boolean | no | false | If set to 'true', the invoice will be considered to be approved by management |
| InvoiceDateClearFlag | Boolean | no | false | If set to 'true', the invoice date will be set to null |
| PurchaseOrderNumberClearFlag | Boolean | no | false | If set to 'true,' the purchase order number will be set to null |
| BillingInstructionsClearFlag | Boolean | no | false | If set to 'true, the billing instructions will be set to null |
| Tax1ClearFlag | Boolean | no | false | If set to 'true', the tax type code for the first tax type will be set to null |
| Tax2ClearFlag | Boolean | no | false | If set to 'true', the tax type code for the second tax type will be set to null |
| Tax3ClearFlag | Boolean | no | false | If set to 'true', the tax type code for the third tax type will be set to null |
| StealLockFlag | Boolean | no | false | If set to 'true', any locks on the invoice will be stolen if it is currently locked, otherwise, if it is set to 'false' and a lock is in place the service will fail |
| addressAttention | String (50) | no | The intended recipient / department of the invoice | |
| addressCompanyName | String (50) | no | The company name in the address | |
| addressLine1 | String (50) | no | The primary address information (i.e. Street Address) | |
| addressLine2 | String (50) | no | The secondary address information (i.e. Apartment Number or Floor) | |
| addressCity | String (50) | no | The city name | |
| addressStateOrProvince | String (20) | no | The state or province name | |
| addressZipOrPostalCode | String (20) | no | The zip or postal code | |
| addressCountry | String (20) | no | The country name | |
| addressClearFlag | Boolean | no | false | If set to 'true', the fields associated with invoice address will be set to null |
Response
The following data is returned (in addition to what is documented in Responses describing the common elements of each web service response):
Name | Data Type | Description | Example Data |
|---|---|---|---|
InvoiceTimestamp | String | The current timestamp (row version) of the invoice, in Base64 format. This can be used for optimistic locking. | |
LockOwnerDisplayName | String (90) | The display name of the user that is currently holding lock on the invoice | John Doe |