v1

latestOpenAPI 3.1.02026-08-0458234268.6 KB

catalog

Update a catalog allowance

Updates an existing catalog allowance by ID.

patch/catalog/allowances/{id}

Path parameters

idstring required

The unique ID of the catalog allowance

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Request body

allowance_type'allowance' | 'discount' | 'rebate'

Type of allowance

amountnumber double

Allowance amount (default: 0). Mutually exclusive with percent_allowance.

unit_allowancenumber double

Unit allowance amount

percent_allowancenumber double

Percentage-based allowance (0-999.99). Mutually exclusive with amount and unit_allowance. Setting this auto-zeros amount and unit_allowance.

target'company' | 'location_group' | 'location'

Allowance target: company, location_group, or location

ottimate_location_idinteger

Location ID

ottimate_group_idinteger

Restaurant group ID

start_datestring date-time

Start date

end_datestring date-time

End date

Response

Catalog allowance updated successfully

idstring required

Unique identifier

catalog_entry_idstring required

Associated catalog entry ID (prefixed with cte_)

ottimate_company_idinteger required

Company ID

ottimate_location_idinteger

Location ID

allowance_type'allowance' | 'discount' | 'rebate' required

Type of allowance

amountstring

Allowance amount (decimal string)

unit_allowancestring

Unit allowance amount (decimal string)

percent_allowancestring nullable

Percentage-based allowance (decimal string). Non-null when allowance is percent-mode.

targetinteger required

Target code (10=company, 15=location_group, 20=location)

target_type'company' | 'location_group' | 'location'

Human-readable target type

start_datestring date-time required

Start date

start_date_utcstring date-time nullable

UTC equivalent of start_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

end_datestring date-time

End date

end_date_utcstring date-time nullable

UTC equivalent of end_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

reference_idstring

Unique key

created_datestring date-time

Record creation date

created_date_utcstring date-time nullable

UTC equivalent of created_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".

last_modified_datestring date-time

Record last modified date

last_modified_date_utcstring date-time nullable

UTC equivalent of last_modified_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".