For the complete documentation index, see llms.txt. This page is also available as Markdown.

Set the expected turnaround for a service type at a store

Set this store's own expected turnaround for a service type, in business days. It wins over the figure the service type carries for the tenant, for this store alone and for no other. Send null to clear the override, after which the service type's figure applies to this store again. Clearing is the only way back to the tenant figure; there is no delete. The resolved turnaround is returned, exactly as the read returns it, so what now applies and the level it resolves at are known without asking again.

Required permissions: SERVICE_STORE_CONFIG, SERVICE_CONFIG

put
/tenants/{tenantUid}/stores/{storeUid}/serviceorders/types/{serviceTypeUid}/turnaround
Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
serviceTypeUidstringRequired

Reference to a service type

Pattern: ^[A-Za-z0-9-_]+
Body

The store's own expected turnaround for a service type, in business days. It wins over the figure the service type carries for the tenant, the same precedence intake forms follow. Send null to clear the override, after which the service type's own figure applies to this store again. Clearing the override is the only way back to the tenant figure — there is no separate delete.

estimatedBusinessDaysinteger · max: 365 · nullableRequired

How long work of this type is expected to take at this store, in business days: 0 to 365, anything outside that range is refused with a 400. null clears the store's override and leaves the service type's figure to apply.

Responses
200

Example response

application/json

The expected turnaround that applies to one service type at one store, together with the level it was found at. A figure set for the store wins over the tenant's figure on the service type, so this is what intake reads rather than either one on its own. estimatedBusinessDays is the effective figure: the store's own where the store has one, and the service type's otherwise. readyAtEstimate is the date core computes from it for a service order registered now, so the client never does the business-day arithmetic itself. Both are null when neither level carries a figure, and nothing is prefilled. readyAtEstimate is also null, and nothing is prefilled, when no day of the week can be one of the store's working days (its openDays hold only Saturday and Sunday and serviceCountWeekendsAsWorkingDays is false).

tenantUidstringRequiredPattern: ^[A-Za-z0-9-_]+
storeUidstringRequiredPattern: ^[A-Za-z0-9-_]+
serviceTypeUidstringRequiredPattern: ^[A-Za-z0-9-_]+
estimatedBusinessDaysinteger · nullableRequired

The expected turnaround that applies here, in business days. null when neither the store nor the service type carries a figure. The date it yields is readyAtEstimate on this response: the client reads the prefilled date off the response rather than computing it, and staff adjust that date case by case.

readyAtEstimatestring · date-time · nullableRequired

The date intake prefills the service order's readyAtEstimate with: the day of this request in the tenant's timezone plus estimatedBusinessDays of the store's working days (serviceCountWeekendsAsWorkingDays), at 23:59:59 on that day in the tenant's timezone, which reads as the end of the day with no time picked, as readyAtEstimate on the service order response states. Counting starts on the day of the request, or on the next working day when the request falls on a non-working day, so 0 business days answers that starting day. Core does the arithmetic; the client never counts days itself. null when estimatedBusinessDays is null, or when no day of the week can be one of the store's working days (its openDays hold only Saturday and Sunday and serviceCountWeekendsAsWorkingDays is false), and nothing is prefilled. The client shows the day and time on the intake form and sends the day and time the staff kept, adjusted or cleared as readyAtEstimate on the service order create; the create never prefills a date on its own.

resolutionstring · enumRequired

The level the expected turnaround was found at. STORE: the store has an override of its own for this service type — a store figure always wins. TENANT: the store has no override, so the service type's own figure applies, which may itself be none.

Possible values:
put/tenants/{tenantUid}/stores/{storeUid}/serviceorders/types/{serviceTypeUid}/turnaround
PUT /v2/tenants/{tenantUid}/stores/{storeUid}/serviceorders/types/{serviceTypeUid}/turnaround HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "estimatedBusinessDays": 1
}
200

Example response

{
  "tenantUid": "text",
  "storeUid": "text",
  "serviceTypeUid": "text",
  "estimatedBusinessDays": 1,
  "readyAtEstimate": "2026-01-01T00:00:00.000Z",
  "resolution": "STORE"
}

Last updated

Was this helpful?