UpdateContactRequest
Replaces a contact's editable fields, roles included. The code, external id, last SDC date and verification
are not editable here and are kept as they are. Changing the roles is a PUT with different flags; removing the
customer or supplier role while invoices exist in that direction is refused with 409. The role-specific parts
are required for the roles the contact holds after the update: cisDetails for a CIS subcontractor,
supplierSettings for a supplier. Removing the subcontractor role keeps its CIS identity and verification on
record; adding the role back restores them.
Properties
| Name | Type | Description |
|---|---|---|
| isCustomer* | boolean | Whether the tenant invoices this contact |
Whether the tenant invoices this contact | ||
| isSupplier* | boolean | Whether this contact invoices the tenant. Required for a CIS subcontractor. |
Whether this contact invoices the tenant. Required for a CIS subcontractor. | ||
| isCisSubcontractor* | boolean | Whether the tenant pays this contact under the Construction Industry Scheme |
Whether the tenant pays this contact under the Construction Industry Scheme | ||
| displayName* | string | Display name of the contact |
Display name of the contact | ||
| title | string | Title (e.g. Mr, Mrs, Ms) |
Title (e.g. Mr, Mrs, Ms) | ||
| firstName | string | First name |
First name | ||
| secondName | string | Second (middle) name |
Second (middle) name | ||
| lastName | string | Last name |
Last name | ||
| emailAddress | string | Email address |
Email address | ||
| telephone | string | Telephone number |
Telephone number | ||
| address | AddressDto | Postal address |
Postal address | ||
| isVatRegistered* | boolean | Whether the contact is VAT registered |
Whether the contact is VAT registered | ||
| vatRegistrationNumber | string | VAT registration number |
VAT registration number | ||
| defaultRate | number | Default rate for the contact |
Default rate for the contact | ||
| cisDetails | CisDetailsDto | CIS identity details. Only for a CIS subcontractor. |
CIS identity details. Only for a CIS subcontractor. | ||
| supplierSettings | SupplierSettingsDto | Defaults for the invoices received from the contact. Only for a supplier. |
Defaults for the invoices received from the contact. Only for a supplier. | ||
JSON Example
{
"isCustomer": false,
"isSupplier": false,
"isCisSubcontractor": false,
"displayName": "string",
"title": "string",
"isVatRegistered": false
}