Update Order-to-Cash settings

PUT/api/v1/contracts/settings

Persist the business's O2C configuration defaults (invoice cadence, default net days, tax treatment, hours/invoice approver roles) and return the stored settings.

Operation ID: update_o2c_settings_api_v1_contracts_settings_put·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

invoice_cadenceInvoiceCadenceEnumInvoiceCadenceEnum

Default recurring invoice cadence: calendar_month or four_week.

default_net_daysinteger

Default payment terms as net days (e.g. 30 for Net 30).

default_tax_treatmentstring

Default tax treatment applied to new invoices (e.g. 'exempt').

hours_approver_rolestring

Role permitted to approve hours/drawdowns (e.g. 'admin').

invoice_approver_rolestring

Role permitted to approve/send invoices (e.g. 'admin').

Responses

200Successful Response

invoice_cadenceInvoiceCadenceEnumInvoiceCadenceEnum

Default recurring invoice cadence: calendar_month or four_week.

default_net_daysinteger

Default payment terms as net days (e.g. 30 for Net 30).

default_tax_treatmentstring

Default tax treatment applied to new invoices (e.g. 'exempt').

hours_approver_rolestring

Role permitted to approve hours/drawdowns (e.g. 'admin').

invoice_approver_rolestring

Role permitted to approve/send invoices (e.g. 'admin').

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject