Assign user to jobs

Users can be assigned to different fulfillmenttools jobs to mark which user should do which job. With this function, the workload can be distributed in advance among different employees. This user must be available in the system to assign users to a job.

fulfillmenttools does not validate who interacts with jobs. Every user, not only assigned, can interact with it.

The assign user to jobs function is available for pick jobs, pack jobs, handover jobs, and service jobs.

Assign users to job creation

To assign one or more users to a job, they could be added at job creation.

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

The body of the job must include the assignedUsers array like in the following examples:

Assign with userId

Assign one or more users by userId to a job.

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

Assign with userName

Assign one or more users by userName to a job.

{
  // Any job object
  ...
  "assignedUsers": [
    {
      "userName": "{USER_NAME}"
    }
  ]
}

Update assigned users

An action is available to update a job's users. All users in this action, that are sent to the backend, will be replaced in the job.

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

The body of the action must look like in the following examples:

Update with userId

Update one or more users by userId of a job.

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

Update with userName

Update one or more users by userName of a job.

{
  "name": "REPLACE_ASSIGNED_USERS",
  "assignedUsers": [
    {
      "userName": "{USER_NAME}"
    }
  ],
  "version": 2
}