Assign user to jobs

Users can be assigned to fulfillmenttools jobs to designate responsibility for the work. This function helps distribute the workload in advance among different employees. The user must exist in the system before they can be assigned to a job.

Assigning a user to a job is for informational purposes only. fulfillmenttools doesn't restrict job interactions to the assigned user; any user with the appropriate permissions can interact with the job.

User assignment is available for the following job types:

• Pick jobs

• Pack jobs

• Handover jobs

• Service jobs

• Stow jobs

Assignment during job creation

To assign one or more users when a job is created, include the assignedUsers array in the request body.

POST https://{projectId}.api.fulfillmenttools.com/api/{JOB_ENTITY}

The {JOB_ENTITY} placeholder represents the specific job endpoint, such as pickjobs or packjobs. The body must include the assignedUsers array as shown in the following examples.

By `userId`

This example assigns a user by their userId.

{
  // Any job object
  ...
  "assignedUsers": [
    {
      "userId": "{USER_ID}"
    }
  ]
}

By `userName`

Updating assigned users

The REPLACE_ASSIGNED_USERS action updates the users assigned to a job. This action fully replaces the existing list of assigned users with the new list provided in the request body. If an empty array is provided, all current assignments are removed.

POST https://{projectId}.api.fulfillmenttools.com/api/{JOB_ENTITY}/actions

The action body must conform to one of the following examples.

By `userId`

This example replaces the assigned user list using a userId.

{
  "name": "REPLACE_ASSIGNED_USERS",
  "assignedUsers": [
    {
      "userId": "{USER_ID}"
    }
  ],
  "version": 2
}

By `userName`