v1

latestOpenAPI 3.0.12026-07-24501176.6 MB

Update Tills in Bulk

Update up to 50 tills in a single request.

put/v2/locations/tills

Request body

identifierName'ID' | 'CODE' | 'EXTERNAL_ID' required

How to identify the target till. One of ID, CODE, EXTERNAL_ID (case-insensitive).

identifierValuestring required

The identifier value matching identifierName.

namestring

Display name for the till. Cannot be null or empty. Max 100 characters. Accepts letters, digits, underscores, and spaces.

descriptionstring nullable

Free-text description. Set to null to clear.

isAdminboolean

Whether the till has admin access.

isActiveboolean

Whether the till is active. Activation fails if the parent store is inactive. Deactivation fails if the till has active child entities.

storeParentCodestring

Code of the parent store. Cannot be set to null. Provide a valid store code to change the parent store.

externalIdsobject nullable

Key-value map of external identifiers. Omit to preserve. Pass null to clear all external identifiers. Pass {} to make no change. Set a key's value to null to remove that specific key. Maximum five entries. Keys and values must not exceed 200 characters each.

customFieldsobject nullable

Key-value map of custom field values. Omit to preserve. Pass null to clear all custom field values. Pass {} to make no change. Set a key's value to null to remove that specific key. Keys must match custom fields configured for the org.

Response

All tills updated successfully.

totalCountinteger

Total number of concept records in the request.

failureCountinteger

Number of concepts that failed to update.