Update auto-numbering settings

PUT /api/v1/businesses/auto-numbering

Configure automatic bill and invoice number generation.

Operation ID: update_auto_numbering_settings_api_v1_businesses_auto_numbering_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

Schema: AutoNumberingSettingsUpdateRequest

auto_number_bills boolean

Enable/disable automatic bill numbering

auto_number_invoices boolean

Enable/disable automatic invoice numbering

bill_number_prefix string

Prefix for auto-generated bill numbers (e.g., 'BILL-', '2024-'). Max 20 chars.

invoice_number_prefix string

Prefix for auto-generated invoice numbers (e.g., 'INV-', '2024-'). Max 20 chars.

next_bill_number integer

Set next bill number (minimum 1). Useful when migrating from another system.

next_invoice_number integer

Set next invoice number (minimum 1). Useful when migrating from another system.

Responses

200 Successful Response

Schema: AutoNumberingSettingsResponse

auto_number_bills boolean required

Whether automatic bill numbering is enabled

auto_number_invoices boolean required

Whether automatic invoice numbering is enabled

bill_number_prefix string

Prefix for auto-generated bill numbers (e.g., 'BILL-')

invoice_number_prefix string

Prefix for auto-generated invoice numbers (e.g., 'INV-')

next_bill_number integer required

Next sequential number for bill auto-numbering

next_invoice_number integer required

Next sequential number for invoice auto-numbering

400 Bad Request - Invalid input

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object