Carrier Packages

What is Carrier Packages?

Carrier Packages is a tool that allows you to manage packages specific to each carrier in your system. From this view you can add new packages for specific carriers, edit existing configurations, and upload multiple packages from CSV files.

Each package includes detailed information such as external and internal dimensions, maximum weight, package type, and API codes needed for integrations with carrier systems.

Packages by Carrier

Each carrier can have its own configured packages. This allows you to use different sizes and types of packages depending on the carrier you use for each shipment.

---

Why Use Carrier Packages?

Carrier-Specific Packages

Configure packages specific to each carrier. Different carriers can have different sizes and types of packages available.

Complete Dimensions

Define external and internal dimensions for each package. This enables accurate packing and shipping cost calculations.

Bulk Upload from CSV

Upload multiple packages at once using CSV files. Save time when you need to configure many packages.

API Codes

Assign specific API codes for each package. This helps integrate with external carrier systems.

Centralized Management

Keep all carrier packages organized in a single view. Easy to search, edit, and maintain.

Package Types

Configure different package types (Box, Envelope, Pallet, etc.) according to each carrier’s needs.

---

How to Access Carrier Packages

1. Navigate to Packaging

   Go to Inventory > Packaging (Packaging List page).

2. Open Add Carrier Packages

   Click the Add Carrier Packages button above the main table.

3. Verify your permissions

   Make sure you have level permissions with list capability. If you don’t have permissions, you’ll be redirected to login.

---

How to Use Carrier Packages

View the Package List

The Packaging page displays all configured packages in a DataTable with the following columns:

• Id: Unique package ID
• Carrier: Name of the associated carrier
• Nick/Code: Short name or package identifier
• Qty Good: Quantity of good packages (hidden column)
• Description: Detailed package description
• Type Pack: Package type name (Box, Envelope, Pallet, etc.)
• Length: External length of the package
• Width: External width of the package
• Height: External height of the package
• Max Weight: Maximum weight the package can contain

Add Carrier Packages Modal

When you click Add Carrier Packages, a modal titled Add Carrier Package opens. This modal lets you select existing packages and add them as carrier packages.

1. Click Add Carrier Packages

   On the Packaging page, click the Add Carrier Packages button.

2. Modal opens

   A modal titled Add Carrier Package appears with a table of packages available to associate with carriers.

3. View the table columns

   The modal table shows: Carrier, Nick / Code, Description, Type Pack, and Dimensions. A second row has search inputs to filter by column. The Type Pack column has a dropdown (All, Box, Envelope, Pallet, No-Box) to filter by package type.

4. Select packages

   Use the checkboxes in the first column to select one or more packages. You can select multiple rows.

5. Click Add

   Click the Add button in the modal footer. If you did not select any package, a warning appears: “Select one or more of the checkboxes”.

6. Confirm result

   On success, a confirmation message appears. The modal closes and the main Packaging table refreshes with the new carrier associations.

Modal Footer

The modal has two buttons: Close (to cancel) and Add (to submit your selection).

Adding New Packages

New packages are created with Add New Package or Upload Package. Use Add Carrier Packages only to associate existing packages with carriers.

Filter and Search Packages

The DataTable includes column-level filtering and sorting:

• Column filters: Use the filter inputs in the second row of the table header to filter by Nick, Description, or package type
• Sorting: Click column headers to sort by that column

---

Functionality Details

Package Types

Available package types include:

• Box: Boxes with internal and external dimensions
• Envelope: Envelopes (uses volume instead of internal dimensions)
• Pallet: Pallets (uses volume instead of internal dimensions)
• No-Box: No box (uses volume instead of internal dimensions)

Package type determines which fields are relevant:

• Box: Requires internal dimensions
• Envelope, Pallet, No-Box: Use volume (volumeCapacity) instead of internal dimensions

Maximum Weight

The MaxWeight field defines the maximum weight the package can contain:

• Used to validate that products don’t exceed package capacity
• Considered along with dimensions to select the correct package
• Must be greater than the weight of products to be packed

Association with Carrier

Each package is associated with a specific carrier:

• Allows having different packages for different carriers
• System can filter available packages based on selected carrier
• Helps manage packages when different carriers have different options

---

💡 Best Practices

Use Descriptive Names

Use clear and descriptive package names (Nick). This helps you quickly identify packages when selecting them for shipments.

Measure Precisely

Make sure dimensions are accurate. Incorrect dimensions can cause problems in packing and cost calculations.

Configure Correct Maximum Weight

Set maximum weight based on actual package specifications. This prevents overloading and shipping problems.

---

Troubleshooting

I can’t add a new package

Problem: The “Add” button doesn’t work or I can’t save the package.

Solutions:

1. Verify that you have level permissions
2. Verify that all required fields are complete
3. Make sure to select valid package type and carrier
4. Verify that numeric values are valid (dimensions and weight)
5. Review error messages in the browser console
6. Reload the page and try again

I can’t select a carrier

Problem: The carrier dropdown is empty or doesn’t load.

Solutions:

1. Verify that you have carriers configured in Carriers List first
2. Reload the page so carriers load
3. Verify that you have permissions to view carriers
4. Review the browser console for JavaScript errors
5. Contact the administrator if the problem persists

I can’t select a package type

Problem: The TypePackID dropdown is empty.

Solutions:

1. Verify that package types are configured in the system
2. Reload the page so types load
3. Review the browser console for JavaScript errors
4. Contact the administrator if the problem persists

Packages don’t appear in the list

Problem: The table is empty or doesn’t show packages I added.

Solutions:

1. Verify that packages were saved correctly (review confirmation messages)
2. Reload the page to refresh the table
3. Verify that you don’t have active filters hiding packages
4. Verify that you have permissions to view packages
5. Review the browser console for data loading errors

Modal doesn’t close after saving

Problem: After saving, the modal remains open.

Solutions:

1. This may be normal if there’s an error - review error messages
2. Try closing the modal manually by clicking outside it or on “Close”
3. Reload the page if the modal doesn’t respond
4. Verify that the operation completed correctly by reviewing the table

---

Related Links

Next Steps:

• Packaging - General overview of packaging and packages
• Shipping Labels - Generate labels using configured packages
• Order Processing - Process orders with carrier packages