Carton
TL;DR
This page covers cartons: the box types you pick when setting up products and when packing. It explains what blocks switching a carton off and what blocks removing it, which are different rules. A packing list keeps its own copy of a carton's name and size, so renaming one never reaches work already done.
What this is for
A carton is a box type used for packing. You set up each box type once: its name, its size, and its weight. It can then be picked when setting up products, when packing an invoice, and on a purchase order.
Where to find it
Master → Carton in the top menu.
The list screen
The list shows every carton, newest first, ten rows at a time. You can change that to 25, 50, 100, 500 or All using the selector under the list. A search box at the top filters the list as you type, matching the ID, name, size and weight. It settles about a second after you stop typing. If you can make changes, a button above the list offers Add new carton.
The columns:
- ID: the carton's number in the system
- Carton Name: the name; long names are shortened (hover to see the whole thing)
- Carton Size: the size; long sizes are shortened the same way
- Carton Weight: the weight in kilograms
- Status: a switch you can flip if you can make changes; otherwise it reads Active or Deactive
- The last column holds Edit and Delete icons if you can make changes; otherwise a dash
A name or size longer than 20 characters is shortened with "...". Hover over it to see the whole value.
Fields
| Field | Rules | Notes |
|---|---|---|
| Carton Name | Required. Up to 255 characters. | Two cartons may share a name. It is the size that must be different. |
| Carton Size | Required. Up to 255 characters. Must not match a size that already exists. | The form suggests "Format: Length x Width x Height (e.g., 40 x 30 x 20 cm)." Any wording is accepted. The size is checked as you type and again when you save. A carton that has been removed frees its size for reuse. |
| Carton Weight (Kg) | Required. A number greater than 0, with up to 3 digits after the decimal point. | The box rewrites what you type as you go. See below. |
What the Carton Weight box does as you type. Anything that is not a digit or a decimal point is removed. A second decimal point is dropped. Anything beyond three digits after the point is cut off, as is anything beyond sixteen digits before it. A point typed on its own gains a leading zero. None of this shows a message, so paste a value and check what is left in the box.
Errors you may see
| What happened | What you see |
|---|---|
| You left the name empty | "Please enter carton name." |
| The name is too long | "Carton name must be less than or equal to 255 characters." |
| You left the size empty | "Please enter carton size." |
| The size is too long | "Carton size must be less than or equal to 255 characters." |
| Another carton already has this size | "Carton size already exists." |
| You left the weight empty | "Please enter carton weight." |
| The weight is not a number | "Carton weight must be numeric." |
| The weight is 0 or less | "Carton weight must be greater than 0." |
| You tried to switch off a carton a product is set to use | "This record cannot be deactivated as it is currently in use by other active records in the system!" |
| You tried to switch off a carton used by a row on a packing list that is still a draft | "This record cannot be deactivated as it is currently in use by other active records in the system!" |
| You tried to switch off a carton that a row on a draft packing list used before it joined a carton group | "This record cannot be deactivated as it is currently in use by other active records in the system!" |
| You tried to switch off a carton used by a carton group on a draft packing list | "This record cannot be deactivated as it is currently in use by other active records in the system!" |
| You tried to remove a carton a product is set to use | "This record cannot be deleted as it is associated with existing records in the system!" |
| You tried to remove a carton used by a row on any packing list, finished ones included | "This record cannot be deleted as it is associated with existing records in the system!" |
| You tried to remove a carton that a packing row used before it joined a carton group | "This record cannot be deleted as it is associated with existing records in the system!" |
| You tried to remove a carton used by any carton group | "This record cannot be deleted as it is associated with existing records in the system!" |
Each of those two messages covers four separate conditions, and the message itself never says which one applies. The table above is the way to work it out. The comparison under "Removing a carton" shows where the two sets of conditions differ.
Adding a carton
- Open Master → Carton.
- Select Add new carton. The "Add Carton" page opens.
- Fill in the Carton Name, Carton Size and Carton Weight.
- Select Save. (Cancel returns to the list without saving.)
Reset returns the boxes to how they were when the page opened. On a new carton that means empty. If a save was refused and the page came back with your entries in it, Reset restores those entries.
You return to the list and see "Carton has been created successfully!". The new carton is active straight away and can be picked immediately.
Changing a carton
- In the list, select the Edit (pencil) icon on the carton's row. The "Edit Carton" page opens.
- Change what you need.
- Select Update. You see "Carton has been updated successfully!"
There is no Reset button on this page. Saving without changing anything is fine. The size check ignores the carton you are editing.
Switching a carton on or off is done from the list, not this page:
- Select the switch in the Status column.
- The confirmation asks "Are you sure you want to deactive this Carton?", which is the software's own wording. Switching one back on asks "Are you sure you want to active this Carton?"
- Confirm with Yes, change it!
- You see "Status has been updated successfully!"
A carton cannot be switched off while any product uses it. Nor can it be switched off while it is part of a packing list that is still a draft. That applies whether it sits on a row of its own or inside a carton group. Switching a carton back on is never blocked. The conditions are not the same as the ones that block removal. See the comparison under "Removing a carton".
A carton that has been switched off stops appearing in the lists where cartons are chosen. Nothing is greyed out and no message explains why it is missing.
Removing a carton
- In the list, select the Delete icon on the carton's row.
- The confirmation asks "Are you sure you want to delete this Carton?" and warns "You won't be able to revert this!"
- Confirm with Yes, delete it!
- You see "Carton has been deleted successfully!"
Removing a carton cannot be undone. There is no way to bring one back.
A carton cannot be removed while any product uses it. It also cannot be removed while it appears in any packing list, even a finished one, or while a carton group refers to it. The message does not say which one is blocking it.
This includes packing lists belonging to a shipment that has since been deleted. Deleting a shipment leaves its packing rows in place, and those rows still count as use. The message does not say that either.
Switching off and removing are blocked by different things. Switching off is the lighter of the two. A carton you cannot remove can often still be switched off.
| Blocked while | |
|---|---|
| Switching off | A product is set to use it. A packing list that is still a draft uses it, either on a row directly, or through a carton group on that draft list. |
| Removing | A product is set to use it. Any packing list uses it, finished ones included. Any carton group uses it, whatever state its packing list is in. |
In both cases a product blocks the action whether that product is switched on or off. A product that has been removed does not block either action.
The practical difference: switching off looks only at packing lists still in draft, while removing looks at every packing list ever made. Once a shipment is packed and finished, its cartons can no longer be removed. They can still be switched off, which takes them out of the lists where cartons are chosen without disturbing anything already packed. That is the usual way to retire a carton that has been used.
Exporting the list
The "All" versions cover every matching carton across all pages, not only the rows on screen. If the search box is filled in, the export contains only the cartons that match it. Clear the search first to export everything. The PDF is titled "Carton Report".
What happens behind the scenes
- Only active cartons can be picked for products, packing and purchase orders. Switching a carton off removes it from those choices but changes nothing already saved.
- A packing list keeps its own copy of the carton's name and size, taken when the carton is chosen. Renaming a carton or changing its size never reaches packing lists that already hold a copy, not even ones still in draft. Choosing a different carton on a draft row replaces the copy with that other carton's details.
- The carton weight is stored for reference. It is not used in packing calculations. Gross weights there are typed in by hand.
- Removing a carton frees its size. You can create a new carton with the same size afterwards.
FAQs
Why can't I remove a carton even though I can switch it off?
The two actions are blocked by different things, and switching off is the lighter of the two. Removing is blocked while any packing list ever made uses the carton, finished ones included, while switching off looks only at packing lists still in draft.
Why did the weight I typed change on its own?
The Carton Weight box rewrites what you type as you go: anything that is not a digit or a decimal point is removed, a second decimal point is dropped, and extra digits are cut off. None of this shows a message, so paste a value and check what is left in the box.
Can two cartons have the same name?
Yes. Two cartons may share a name; it is the size that must be different.
I changed a carton's size. Why didn't my draft packing list update?
A packing list keeps its own copy of the carton's name and size, taken when the carton is chosen, so changes never reach packing lists that already hold a copy, not even ones still in draft. Choosing a different carton on a draft row replaces the copy with that other carton's details.
Why is a carton missing from the list where cartons are chosen?
A carton that has been switched off stops appearing in those lists. Nothing is greyed out and no message explains why it is missing.
Can I undo removing a carton?
No. Removing a carton cannot be undone and there is no way to bring one back. The usual way to retire a used carton is to switch it off instead, which takes it out of the pickers without disturbing anything already packed.
Related pages
- Master Data Setup: the other reference lists, including Port of Loading
- Packaging: where cartons are picked when packing an invoice
- Users & Roles: who can see and change each part of the system
Last verified: 3 August 2026
No comments to display
No comments to display