Locations

This section contains a detailed technical explanation of all the endpoints necessary to manage the information related to locations through the API.

Considerations

A location represents each of the tasks that can be performed within a service product. In the API, locations contain the following information:

  • color: color configured in Orquest for the task.

  • description: description of the task defined in Orquest.

  • name: name of the task in Orquest.

  • shortName: task abbreviation in Orquest.

  • requiredLevel: skill level required to perform the task. Ranges from 0 (no training needed) to 3 (maximum training level) and must be previously configured in Orquest.

  • priority: priority of task coverage. Ranges from 0 (low) to 5 (high) and must be previously configured in Orquest.

  • maxResources: limit of people for the task.

  • type: type of task, whether it is fixed, variable, or non-plannable (FIXED, VARIABLE, NON_PLANIFIABLE).

  • shouldAvoidOvercover: if this parameter is true, the task will not be overcovered.

  • system: determines if the task was created by the system (true) or by the user (false).

  • category: category of the task previously configured in Orquest.

  • product: external identifier of the product or section.

  • id: external identifier of the task.

  • active: if the task is active in the product (true) or not (false).

  • metadata: any additional data that has been previously configured for the task in Orquest. The metadata structure must be previously configured.

  • zone: physical place in the service (store, restaurant, etc.) where the location is carried out.