Skip to main content
Ready to Invoice

Assign Group to Invoice Lines

This popup window lets you organize the lines of a Halo recurring invoice into named groups. A group visually groups several related lines together (for example, all licenses for the same service) within the invoice, using a numeric iden...

Last updated 24 days ago

This popup window lets you organize the lines of a Halo recurring invoice into named groups. A group visually groups several related lines together (for example, all licenses for the same service) within the invoice, using a numeric identifier and a descriptive name. It opens from the invoice detail screen (Display Invoice Halo) after you select one or more lines.

When to use this screen

  • When you want to group several selected lines under a group heading that already exists on the invoice.
  • When you need to create a new group to classify lines that do not yet belong to any group.
  • When you want to correct or rename the name of an existing group already used on the invoice.

To open this window you must first select at least one line in the invoice grid. If you don't select any line, the system will warn you with the message "No records selected" and will not open the dialog.

What it shows

ItemDescription
Select Existing GroupDrop-down list with the available groups: it includes the group already assigned to the selected lines (if they have one), the groups used on other already-processed lines of the invoice, and the groups that exist on the Halo recurring invoice.
Selected Group IDInformational text shown below the list, displaying the numeric identifier of the selected group.
Edit Group NameText field that appears only when you select an already existing group (not a new one). It shows the current name of the group and its ID, and lets you correct it.
Create New GroupText field for typing the name of a new group.
New group will be assigned IDInformational text that appears when you type a new group name, indicating which ID number will be automatically assigned (the next one available).
Open dialog showing the drop-down list of existing groups with a group selected
Open dialog showing the drop-down list of existing groups with a group selected

Available actions

  • Check icon (✔) next to Edit Group Name: saves the new name you typed for the selected existing group. If the name matches that of another already created group, you will see the error "A group with this name already exists" and the change will not be applied. This name change remains pending until you click "Assign Group".
  • Plus icon (+) next to Create New Group: enables the text field to type the name of the new group. Clicking it again (now shown as a check icon ✔) confirms the creation of the group in the list and leaves it selected. If the name already exists, you will see the error "A group with this name already exists".
  • "Cancel": closes the window without applying any changes to the invoice lines.
  • "Assign Group": applies the selected group (existing, edited, or newly created) to the lines you had selected in the grid, and also updates the name on all other queued lines that already belong to that same group, to keep the name consistent. ⚠️ This action saves the changes to the database immediately (it is not a preview); once confirmed, the lines are left with the new group assigned. Only lines that are still queued change: lines already sent to HaloPSA keep their group, and the message tells you how many were left as they were. It is refused while a send to HaloPSA is running.

Step-by-step flow

  1. On the invoice detail screen, select one or more lines in the grid that you want to group.
  2. Open the "Assign Line Group" window.
  3. Choose one of these three options:
    • Select an existing group from the "Select Existing Group" drop-down list.
    • If you choose an existing one and want to correct its name, edit it in the "Edit Group Name" field and confirm with the check icon.
    • To create a new group, click the (+) icon in "Create New Group", type the name, and confirm with the check icon.
  4. Verify the group name and ID shown in the informational texts.
  5. Click "Assign Group" to save the group on the selected lines and on all related lines that share that same group.
  6. Wait for the confirmation message indicating how many lines were updated.

Common errors and how to resolve them

MessageCauseHow to resolve it
No records selectedYou tried to open the dialog without checking any line in the invoice grid.Close the dialog, select at least one line in the grid, and open "Assign Line Group" again.
A group with this name already existsThe name you typed (when creating a new group or editing an existing one) is already used by another group in the list.Type a different name or check the drop-down list to reuse the group that already has that name.
Please enter a valid group nameYou tried to confirm the name edit while leaving the field empty or containing only spaces.Type a valid name before confirming with the check icon.
Please select or create a group before savingYou clicked "Assign Group" without having any group selected (for example, you were midway through creating a new one without confirming it).Select a group from the list or complete the creation of the new group before clicking "Assign Group".
Group name cannot be emptyThe group you are trying to save ended up without an assigned name.Verify that the chosen or created group has a visible name before saving.
No lines selected (when confirming)The lines you had selected became unselected in the grid before completing the assignment.Close the dialog, select the lines in the grid again, and repeat the process.
Generic error message when saving (variable text)A problem occurred while saving the group to the database.Check your connection and try again. If the problem persists, contact support with the affected invoice.

Was this helpful?

Still need help? Ask the team