Skip to main content
All CollectionsTransaction ManagerLabelsIssues & Errors
Transaction Manager: Troubleshooting UCC-128 Label Errors and Issues
Transaction Manager: Troubleshooting UCC-128 Label Errors and Issues

Check out some of these solutions to common label printing errors and issues, along with some tips and tricks!

Support avatar
Written by Support
Updated over 9 months ago

Product: Transaction Manager

Common Issues and Solutions

Click on the topic link for guidance:

Note: If you have an issue or error not mentioned in this article, refer to the list of Related Topics or contact Support for assistance.


ASN Not Set Up Properly

To ensure your ASN is set up properly:

  • On the Main tab of your ASN, make sure the Use TrueCommerce Label Solution dropdown is set to Yes.


    Note: Some ASN templates don’t have this dropdown, so don’t worry if you don’t see it!

  • On the Main tab, make sure the Ship To Type field is set to either Store or Distribution Center.

  • On the Main tab, make sure the Label Type field is set to either Standard or Pick and Pack. Choose Standard if you are shipping one type of item and want the specific item details to print on the label. Choose Pick and Pack if you're shipping a mixture of items. If you select Pick and Pack, the label will say Mixed.

    Note: These are the most common choices. If there are other choices and you need assistance, contact your assigned Implementation Specialist or our Support Team!

  • Under the Shipment Detail tab, make sure all of the UCC-128 fields are filled in. The ASN sample below is a Standard ASN. Where the UCC-128 #'s are located will depend on the ASN type.

Want these fields to fill in automatically when you create the ASN? Check out the article on Setting the UCC-128 to Autocreate.


Check Label Setup

These options are found in the Transaction Manager Business System workspace. For cloud-based labeling, choose Web-Based labeling. If you're using the installed version of the labeling solution, choose On-Premise labeling. Check out Transaction Manager User Guide > Labeling Setups and Controls for more details.


Ship To Address not Printing

For assistance, check out this article for help with your Ship To address!


Ship From Address Missing

Need a Ship From address? Select a trading partner from the Trading Partners workspace. Select Labels > Ship From Locations via the action bar.


When the Ship From Locations grid displays, click +Add on the action bar and then enter your new location details. Be sure to check the Default box, especially if you have more than one Ship From address and one is used more than the others.

For step-by-step guidance in Transaction Manager, select Guided Tutorials from the Foundry ? (Help) menu and then launch the tutorial 'Basic Label Setup'. See Transaction Manager User Guide > Defining the Default Ship-From Address for more details.


PDF not Showing Up

When using the online Labeling Utility, labels will appear in a new window/tab. If your browser's popup blocker is activated, it will prevent that window from opening. Turn off your popup blocker.


Templates not Found

If you receive an error saying the label templates aren't found, contact your assigned Implementation Specialist or our Support Team, and ask them to deploy the label templates for you!


Trouble Printing Correct Number of Labels

There are a few things to check here:

If you're shipping cartons containing one type of item (aka Pure cartons), make sure the Max # is set in the Item Catalog. The value in the Max # field indicates the maximum amount of each item that fits into a single container. Check out this article for more details!

Make sure you’re using the correct ASN. If you need only carton labels, you’ll want to use either Standard (shipping one type of item) or Pick and Pack (shipping a mixture of items). If you need pallet labels, you’ll need to be using a Pallet or Pallet Pick and Pack type ASN.

Your ASN may need to be manually packed. This would be the case if you’re shipping multiple cartons and one or more of the cartons in the shipment is mixed.

Note: If there are duplicate UCC-128 label numbers, then only one label will print for all that have the same UCC-128 #.

The Labeling Utility requires unique UCC-128 #'s to generate different labels. This normally occurs when an ASN is manually packed. To generate a new UCC-128 #, highlight the value in the field, and click UCC-128 in the Action Bar.


To see a demonstration, check out the Max # video in the ASN Training Series of TrueCommerce University There is also a tutorial on how to manually pack your ASNs.


UCC-128 Number Missing on ASN

To prevent this from happening, you have the option to automatically generate the UCC-128 number when creating the ASN. Check out the article on Setting the UCC-128 to Autocreate.


Barcode Doesn't Match ASN

Have you printed labels from the wrong type of ASN and the shipment left your facility? Did you send the ASN after already printing the labels and realize the ASN needs to be adjusted?

Whatever the case ... you can create your new ASN, copy the UCC-128 #'s from the incorrect ASN and then paste those UCC-128 #'s to that field on the correct ASN.

The UCC-128 # is what generates the barcode on the labels, so this must be correct on the ASN.


"Ship To Type Was Not Selected" Error

To correct this error, open the ASN. On the Main tab, locate the Ship To Type dropdown. Select either Store or Distribution Center.

Note: The Ship To Type needs to match the Type column in your Address List.


"Label Type is Not Selected" Error

To correct this error, open the ASN. On the Main tab, locate the Label Type dropdown. Select either Standard (sending one type of item) or Pick and Pack (sending a mixture of items).


"Label List Failed to be Retrieved" Error

This error may mean that the UCC-128 # is invalid. Make sure that the UCC-128 Autocreate option is selected. Make sure that Company # field is correct. This value is typically the first 5 - 9 digits of your item UPCs.

Note: This could also be an issue with the Trading Partner map. Contact TrueCommerce Support for assistance if you get this error, and adjusting the UCC-128 # doesn't help.


Related Topics

  • Check out the 'Labeling Utility' video in the Added Functionality section of TrueCommerce University Creating a Mark For label? Check out the Mark For Label video in the same section.

rev: 12/04/23

Did this answer your question?