CoworkerContracts
Update CoworkerContract
Update an existing CoworkerContract record.
PUT
Update CoworkerContract
Updates an existing CoworkerContract record. You must include the
Id of the record to update along with all required fields.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the
Authorization header.
The authenticated user must be a full unrestricted administrator or have the CoworkerContract-Edit role.Enums
eCancellationReason
eCancellationReason
| Value | Name |
|---|---|
| 1 | PriceTooHigh |
| 2 | NewJobRelocation |
| 3 | MovedToOtherSpace |
| 4 | ChangeWorkEnvironment |
| 5 | LackCommunityInterations |
| 6 | PoorSpaceCondition |
| 7 | OtherMembers |
| 8 | Rellocated |
| 9 | BusinessExpansion |
| 10 | Pause |
| 11 | Renewed |
| 12 | Upgraded |
| 13 | Downgraded |
| 19 | Covid19 |
| 99 | Other |
eDeliveryHandlingPreference
eDeliveryHandlingPreference
| Value | Name |
|---|---|
| 1 | StoreForCollection |
| 2 | Forward |
| 3 | OpenScanForward |
| 4 | OpenScanRecycle |
| 5 | OpenScanShred |
| 6 | OpenScanStoreForCollection |
| 7 | Recycle |
| 8 | ReturnToSender |
| 9 | Shred |
| 10 | DepositCheck |
| 11 | Unknown |
Request Body
Required Fields
The Id of the CoworkerContract record to update.
ID of the issued by linked to this record.
ID of the coworker linked to this record.
ID of the tariff linked to this record.
Day of month on which billing occurs.
Number of units.
Optional Fields
ID of the next tariff linked to this record.
Free-text notes for this contract.
Contract start date.
Date on which the contract will next be automatically invoiced. Updated automatically every time the contract is invoiced, advancing by the plan’s renewal period.
Period the next invoice will cover. For new contracts this equals RenewalDate. If Tariff.AdvanceInvoiceCycles > 1, Nexudus invoices several periods at once on the first invoice, pushing InvoicedPeriod ahead of RenewalDate. Nexudus stops invoicing when InvoicedPeriod reaches the cancellation date.
Minimum contract length end date. Defines the earliest date at which the contract can be cancelled without penalty.
Fixed price override for this contract. If null, the contract uses the plan’s default price (TariffPrice).
Contract value used in reporting to compare against the actual invoiced price.
List of desks linked to this record.
The added desks value for this coworker contract.
The removed desks value for this coworker contract.
List of variants linked to this record.
The added variants value for this coworker contract.
The removed variants value for this coworker contract.
Purchase order.
Whether to include the plan’s signup fee when creating this contract.
Whether to invoice multiple billing cycles in advance on the first invoice, as configured by Tariff.AdvanceInvoiceCycles.
Whether to pro-rate the first invoice based on the contract start date relative to the billing cycle.
Date of the next automatic invoice generation for this contract.
Whether the customer has accepted the plan’s terms and conditions.
Date on which the contract will be cancelled. Nexudus stops invoicing when InvoicedPeriod reaches this date.
Minimum number of days’ notice required before cancellation takes effect.
Whether to pro-rate the final invoice when the contract is cancelled mid-cycle.
Whether to cascade cancellation to contracts of team members under this customer.
Reason for cancellation. See
eCancellationReason? enum above.Free-text notes about the cancellation.
Delivery handling preference for checks. See
eDeliveryHandlingPreference? enum above.Delivery handling preference for mail. See
eDeliveryHandlingPreference? enum above.Delivery handling preference for parcels. See
eDeliveryHandlingPreference? enum above.Delivery handling preference for publicity. See
eDeliveryHandlingPreference? enum above.Free-text delivery instructions for this contract’s mail handling.
Date by which identity verification checks must be completed for this contract.
Date by which address verification checks must be completed for this contract.
Date/time value for start date local.
Date/time value for renewal date local.
Date/time value for next auto invoice local.
Date/time value for price plan terms accepted on local.
Date/time value for cancellation date local.
Date/time value for contract term local.
Date/time value for invoiced period local.
PO box number.
Children
Scheduled future price changes for this contract. Each entry sets a new Price to apply on a given date
Code Examples
Response
200
HTTP status code.
200 on success.A human-readable message confirming the update.
Contains the
Id of the updated record.true if the coworkercontract was updated successfully.null on success.Example Response
400
A summary of the validation error(s), in the format
PropertyName: error message.null on validation failure.Array of validation errors.
false when the request fails validation.Example Response
Update CoworkerContract