Skip to content
P4 Software P4 Software / logisticaHQ-en

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Users

Users
โ† Back to System

Everyone who works in LogisticaHQ, in the office or on the Warehouse floor, signs in with their own user. A user decides what a person can see and do (their permission level and module), which client's stock they work with, which Zones they may handle, which Printers print their labels, how their Handheld scans, and their language, time zone and first screen. This page covers the user list, creating users, and every field, tab and rule on a user's screen.

Kinds of users

Permission levelWho it is for
AdministratorPeople who run the System. They see the full menu and every screen, whatever module they have, and can change settings, users and permissions. An administrator cannot be tied to a client and cannot be deactivated while still an administrator.
UserOffice and floor staff. What they see and may use is set by their module. See Modules and permission profiles.
PortalUserPeople from a 3PL client who use the client portal to see their own stock, orders and Invoices. They are tied to one client. See Clients.
FieldUserPeople who use the LogisticaHQ Field phone app for surgical Trays. They take no license seat and can only use the Field app.

Your license sets how many users can be signed in at the same time. See Tenant. Each person can be signed in on one device at a time: signing in somewhere else ends their other session. See User sessions.

The user list

Open Setup > System > Users. The list shows every user with their module, group, client, name, role and time zone.

The Users list with each user's status, module, client, name, role and time zone

  • The green tick in the first column marks an active user. A crossed circle marks an inactive one.
  • The link icon beside it is Impersonate: it opens a new tab signed in as that user, so an administrator can see exactly what the user sees, for example to help with a problem. Use it with care: anything you do there is done as that user.
  • Click a username to open the user's screen.

Create a user

  1. Click New.
  2. Enter a Username, which is what the person types to sign in, and their First name and Last name. For people who sign in on a Handheld, keep the username short: they type it on a small keyboard.
  3. Choose the Role: User for most people, Administrator for those who run the System.
  4. Click Submit. LogisticaHQ creates the user and opens their screen.
  5. On the Account tab, set a password (see The password, in its three forms below), the Email, the default Warehouse and language, and click Save.
  6. On the Access tab, click the module card that fits the person's job, and, for a client user, pick the client.
  7. On the Printers tab, switch on the Printers they print to and pick a default.

The New user dialog with Username, First name, Last name and Role

The user screen

The user screen has a header at the top and, for an administrator, five tabs below it: Account, Access, Printers, Handheld and Integration. The screen opens on the Account tab.

The user screen as an administrator sees it: the header with photo, name and sign-in, the Active and permission pills, the Save, Changes, Deactivate and Refresh buttons, and the five tabs with Account open.

The user screen as an administrator sees it: the header with photo, name and sign-in, the Active and permission pills, the Save, Changes, Deactivate and Refresh buttons, and the five tabs with Account open.

What saves when

The user screen saves in two ways. It is worth knowing which, so nothing you type is lost:

  • Saved only by Save: the fields typed or picked in a form: Email, First name, Last name, Group name, Time zone, Permissions, Default menu, Default Warehouse, Language, Auto ship Small Parcel, Scan type, Track Geo Location and User Info 1 to 10. Click Save after changing any of them. Nothing is saved as you type, and the screen does not warn you if you leave it with unsaved changes.
  • Saved at once, by the click itself: the password (with Apply), the photo, the module cards, the client, the portal capabilities, each printer's Allowed switch and Default, the printer-by-document Setup, each zone switch, and the API key buttons. A switch spins briefly while it is saved. If the save is refused, a message says why and the switch stays where it was.

The header

ItemWhat it shows or does
PhotoThe person's photo. When no photo has been uploaded, their initials (first letter of the first name and of the last name) show in a circle instead. Upload a photo on the Account tab.
NameFirst name and last name. A user with neither shows as Empty User.
Sign-in and EmailThe line under the name: the username the person signs in with and, when one is set, their Email, separated by a dot.
Active / Inactive pillGreen Active when the person can sign in; red Inactive when the user has been deactivated.
Permission pillThe permission level: Administrator, User, PortalUser or FieldUser.
SaveSaves the form fields listed above. Beside it a short note shows Saving..., then Saved, or Not saved when the save failed. When a save fails, a message says why and what you typed stays on screen, so you can correct it and click Save again.
ChangesOpens the history of changes made to this user: who changed what, and when.
Deactivate / ActivateSee Deactivate or activate a user below.
RefreshReloads the user from the server. Anything not yet saved is replaced by what is stored.

If someone else changes this user while you have the screen open, the changed values appear on your screen straight away.

Deactivate or activate a user

When someone leaves, deactivate their user instead of deleting it: their history, such as receipts, picks and counts, stays linked to their name, and they can no longer sign in.

  1. Open the user and click Deactivate in the header.
  2. A dialog titled Deactivate user asks: This user will no longer be able to sign in. Deactivate them? Click Deactivate to go ahead, or Cancel to leave the user as they are.
  3. The pill turns red and reads Inactive, and the button becomes Activate.

To let the person sign in again, click Activate. It does not ask first, because it locks nobody out.

Rules:

  • Deactivate and Activate save straight away, and they save the whole form with them. Any field you have changed but not yet saved is saved at the same time. If you do not want those edits kept, click Refresh first.
  • You cannot deactivate yourself: the save is refused with Cannot deactive self.
  • An administrator cannot be deactivated: the save is refused with Administrator cannot be deactivated, demote to User first. Change their Permissions to User, click Save, then deactivate.

Account tab

The Account tab has three groups of fields on the left, Sign-in, Personal and Where they start, and a side panel on the right with the photo and, for an administrator, a summary.

The Account tab: Sign-in, Personal and Where they start, with the photo panel and the Module, Client, Printers and Zones summary on the right.

The Account tab: Sign-in, Personal and Where they start, with the photo panel and the Module, Client, Printers and Zones summary on the right.

Sign-in

FieldWhat it does
UsernameThe name the person signs in with. It is shown but cannot be changed once the user exists. To use a different username, create a new user.
EmailWhere password resets and LogisticaHQ notifications for this person are sent. Saved with Save.
PasswordShown in one of the forms described below. A password is never shown, only set.
PermissionsThe permission level: Administrator, User, PortalUser or FieldUser. Shown to administrators only. Saved with Save. You cannot take away your own administrator level: the save is refused with Cannot demote self to non Administrator.

The password, in its three forms

What the Password row looks like depends on whose user it is and on your company's password policy:

  1. A password box with an Apply button. Shown on your own user, and on someone else's user when you are an administrator and the company allows administrators to change passwords directly (the password policy setting Whether direct passwords change by administrators in Setup > System > Configuration). Type the new password and click Apply. It is set at once, a Password changed notification appears, and the box empties. The Save button does not set the password; only Apply does. If the password does not meet the policy, a message says why (for example Password is too short, Password is too long, Passwords cannot be reused, Password must contains numbers, Password must contains special characters or Password must contains at least one upper case) and what you typed stays in the box so you can change it. The policy applies to a User when their module enforces it, and to an Administrator when the company enforces it for administrators. See Modules and permission profiles.
  2. A Send password reset Email link. Shown to an administrator on someone else's user when the company does not allow administrators to change passwords directly. Click it; a dialog titled Reset password asks This will reset user's password. Are you sure? Click Confirm to reset the password and Email it to the person, or Cancel. A Password reset notification confirms it. The person's old password stops working, so make sure their Email is correct first.
  3. No password row at all. When neither of the above applies, the row is not shown.

Personal

FieldWhat it does
First name, Last nameThe person's name as shown throughout the System and in the header. Saved with Save.
Group nameA label that groups users, for example a shift or a team. It appears in the user list, where you can filter by it. Saved with Save.
Time zoneThe person's own time zone. Dates and times they see are shown in it. Type in the list to search it. Saved with Save.

Where they start

FieldWhat it does
Default menuThe screen this user sees after signing in. Administrators only. Choose one of: A user saved before this list existed may have an older start screen that was typed by hand, such as an address. It is kept and shown as one more entry in the list, labelled with the address itself, so opening and saving the user never wipes it. It stays until someone picks one of the four entries. Saved with Save.
Default WarehouseThe Warehouse the person works in by default. Administrators only. Type to search by Warehouse code. Saved with Save.
LanguageThe language the person works in, on the web and on the Handheld. <Inherit> uses the company language, and follows it if it changes. Saved with Save.

Photo and summary

  • Upload photo: choose a PNG or JPG picture of the person (the system also accepts WebP pictures). It is stored at once and appears in the header, beside their name in lists and in chat.
  • Summary (administrators only): a quick view of what the other tabs hold, so you can check a user without opening each tab: Module (the module's name, or None), Client (the client's name, or None), Printers (how many Printers are allowed and which one is the default, for example 3 ยท Default: Office laser, or None) and Zones (how many Zones are assigned, or None).

Access tab

The Access tab decides what the person sees and where they may work. Administrators only.

The Access tab: the module cards with Handheld selected, Client and shipping, and the Assigned Zones list.

The Access tab: the module cards with Handheld selected, Client and shipping, and the Assigned Zones list.

Module

The menus this user sees. One module per user. Each module set up in your company shows as a card with its name and description. The user's module is the highlighted card.

  • Click a card to give the user that module. It is saved at once and replaces the module they had.
  • Click the highlighted card again to take the module away. The user is then left with no module.
  • Open this module, under the cards, opens the module itself, to see or change its menus and permissions. See Modules and permission profiles.
  • When no modules exist yet, the tab says No modules have been set up.

Client and shipping

FieldWhat it does
ClientTie the user to one client to give them client portal access. Leave it on None: sees every client for Warehouse staff, who work for all Clients. Pick a client to make this a client user: they then see and handle only that client's Products, orders and stock. The choice is saved at once. Only a User or a PortalUser can have a client: for an Administrator the change is refused with a message that suggests changing the user type to Portal user. If the change is refused, the list goes back to the client the user still has.
Auto ship Small ParcelWhen Yes, small-parcel orders this person finishes packing are shipped automatically, without a separate ship step. Saved with Save.

Portal access

Shown only when the user has a client. It lists the capabilities this client user has in the self-service client portal. Each is a switch, saved at once:

CapabilityLets the client user
View dashboardSee the portal's dashboard.
View inventorySee their stock.
View orders & shipmentsSee their orders and shipments.
Place outbound ordersCreate outbound orders.
View Purchase ordersSee their Purchase orders.
Create Purchase ordersCreate Purchase orders.
View InvoicesSee their Invoices.
View reportsRun reports.
View ProductsSee their Products.
Manage ProductsCreate and change Products.
View CustomersSee their Customers.
Manage CustomersCreate and change Customers.
View VendorsSee their Vendors.
Manage VendorsCreate and change Vendors.

See Clients for the client portal.

Assigned Zones

Turn on the Zones this user works in. The list shows every zone with its switch (#), Name, Warehouse and Description, sorted by name, 50 to a page. Each switch is saved at once.

A person with Zones assigned can move, pick and count stock only in those Zones, and is refused anywhere else with a message naming the zone. A person with no Zones assigned can work in every zone. See Zones.

Printers tab

Turn on the Printers this user may print to. The default is used when nothing else picks one. The tab's label shows how many Printers the user is allowed to use. Administrators only.

The Printers tab: each printer with its Machine and Allowed switch, and Make default next to the allowed ones.

The Printers tab: each printer with its Machine and Allowed switch, and Make default next to the allowed ones.

ColumnWhat it shows or does
NameThe printer's name.
MachineThe computer whose Print agent reported the printer. Printers in different buildings often have the same name; the machine tells them apart.
AllowedSwitch on the Printers this person prints to. Saved at once. A printer that has been hidden is not offered, unless the user already has it, so it can still be switched off.
DefaultShown only for allowed Printers. Click Make default to make that printer the one used when nothing more specific applies. A user has one default: making a printer the default clears the previous one. The default printer shows a Default pill; click the pill (Clear the default) to leave the user with no default.

Printer by document (advanced)

Click Printer by document (advanced) below the list to decide which allowed printer prints which kind of label or document, such as bin labels, carrier labels or bills of lading.

  1. The Printer Setup dialog opens with the heading User Printer Role Setup. It has one row per printer the user is allowed to use, and one tick-box column per kind of document.
  2. Tick, for each printer, the documents it should print for this person.
  3. Click Submit. The Setup is saved and the user reloads. Close leaves without saving.

When the user has no allowed Printers, the dialog shows No records and Submit is greyed out: allow Printers first. If the save is refused, the dialog stays open with your ticks and shows why in a red box.

The Printer setup dialog: each allowed printer with the document kinds it prints ticked.

The Printer Setup dialog: each allowed printer with the document kinds it prints ticked.

The Packslip Pdf, Bill Of Lading Pdf and Master Bill Of Lading Pdf columns also decide where packing slips and BOLs that print by themselves go when this person ships, ahead of the Warehouse's printer. Do not give these to people who ship in more than one building. See Automatic printing of pack slips and BOLs.

Handheld tab

Settings for the person's Handheld. Administrators only. Saved with Save.

The Handheld tab for a user, with the Track Geo Location box.

The Handheld tab for a user, with the Track Geo Location box.

FieldWhat it does
Scan typeHow this person's Handheld reads barcodes: Zebra Data Wedge (the built-in Zebra scanner), Camera (the device camera), or Line Feed (a scanner that sends the code as typed text, ending with a new line). Shown only when your company scans user by user, that is when the company's Handheld scan type setting in Setup > System > Configuration is set to UserSpecific. Otherwise everyone uses the company's scan type and the field is hidden.
Track Geo LocationWhen Yes, records where the person's Handheld is, for Delivery and field work.
Location - Last updatedShown only when Track Geo Location is on and the Handheld has reported a position. The heading shows the date and time of the last report, and below it the Latitude and Longitude. These are read-only.

Integration tab

Administrators only.

The Integration tab for a user with no API key yet: Generate new key and Clear API key, and User Info 1 to 4 with Show User Info 5 to 10.

The Integration tab for a user with no API key yet: Generate new key and Clear API key, and User Info 1 to 4 with Show User Info 5 to 10.

API Key

A program using this key acts as this user. Generate one only for an integration, that is when another System connects to LogisticaHQ through the REST API. The program can do whatever this user's permissions allow. See REST API.

  • Generate new key: asks Are you sure?, then creates a new key and shows it. A key the user already had is replaced, so any program using the old key must be given the new one.
  • Click the key to copy it. A Copied notification confirms it. If your browser does not allow copying, select the key and copy it by hand.
  • Clear API key: asks Are you sure?, then removes the key. Any program still using it can no longer connect.

Keep the key private, like a password.

User info

Free fields, User Info 1 to User Info 10, for anything your company wants to record about a user, such as an employee number. Saved with Save.

User Info 1 to 4 are shown. Click Show User Info 5 to 10 to show the rest. When any of User Info 5 to 10 already holds something, all ten are shown straight away, so nothing is ever hidden.

Your own profile (non-administrators)

Everyone can open their own user, from Profile in the user menu, opened by clicking their name in the top bar. A person who is not an administrator sees:

  • The same header: photo, name, sign-in and Email, the pills, and Save, Changes and Refresh. Deactivate is refused on your own user (Cannot deactive self).
  • No tabs. The Account tab is the whole screen.
  • Sign-in: Username (read-only), Email, and the password box with Apply, to change their own password. No Permissions field.
  • Personal: First name, Last name, Group name and Time zone.
  • Where they start: Language only. The Default menu and Default Warehouse are set by an administrator.
  • The photo panel, to upload their own photo. No summary.

[SCREENSHOT 8: A non-administrator's own profile: the header and the Account fields, with no tab strip and no summary panel.]

A non-administrator cannot change anyone else's user: a save is refused with Only Administrator can change other users, and a change of permission level with Permissions can only be changed by Administrator.

Troubleshooting

SymptomLikely causeWhat to do
A change to a name, Email or time zone is gone after leaving the screen.It was not saved: form fields save only with Save, and leaving does not warn.Type it again and click Save. Wait for Saved.
The header shows Not saved.The save was refused; the message said why.Correct the field and click Save again. Your typing is still on screen.
There is no password box on someone else's user, only Send password reset Email.The company does not allow administrators to change passwords directly.Use the reset Email, or ask whoever manages the Configuration to allow direct changes.
Administrator cannot be deactivated, demote to User first.The user is an administrator.Set Permissions to User, click Save, then Deactivate.
A client cannot be picked for a user.The user is an Administrator or FieldUser.Set Permissions to PortalUser (or User), click Save, then pick the client.
Portal access is not shown.The user has no client.Pick a client under Client and shipping.
Scan type is not shown on the Handheld tab.The company uses one scan type for everyone.Expected. Change the company's Handheld scan type to UserSpecific only if people need different scan types.
Printer by document shows No records.No printer is allowed for the user.Switch on Printers under Allowed first.
The Default menu shows an address instead of a screen name.The user has an older start screen typed by hand.It still works. Pick one of the four entries and click Save to replace it.

Related pages

Was this page helpful?