Create tax code value

post

https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/taxcodes/{taxCodeId}/values

Creates a new value for the given tax code. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code does not exist, has already been deleted, or has no value list configured yet. Returns 409 when a value with the same id already exists for this tax code.

Path Params

organizationId

string

required

String. The organization's internal ID (32-character hex string) or its externalSourceId. When the value matches the format of an internal ID, the internal ID takes precedence.

taxCodeId

string

required

String. The ID of the tax code to add a value to (32-character hex string), as returned in the id field of the list or GET response.

Body Params

string

required

length ≤ 255

Caller-supplied identifier for this value. Must be unique within the tax code.

value

string

required

length ≤ 255

Display text of the tax code value. Must be non-empty and not whitespace-only.

sortOrder

integer | null

Sort position of the value within the list.

startDate

date-time | null

Date from which this value is active. ISO 8601 format.

endDate

date-time | null

Date until which this value is active. ISO 8601 format.

Responses

201Created — returns the newly created tax code value

400Bad request

403Forbidden — organization not found or access denied

404Not found — tax code does not exist, has been deleted, or has no value list configured yet

409Conflict — a value with the same id already exists for this tax code