The process of label generation in the NEW wholesale flow is determined by two key factors related to the order: its Type and its Origin. Wholesale orders fall into two distinct categories, which dictate how labels are generated and how the items are packed:
- Courier Orders: These involve individual boxes that are shipped via a standard parcel carrier (e.g., UPS, FedEx). Labels are generated per box.
- Freight Orders: These are larger shipments that are processed and shipped together on a pallet. The labeling process is geared toward LTL (Less-Than-Truckload) freight.
Order Origin: Where the order was imported into ShipHero from.
- EDI (Electronic Data Interchange): An order imported via EDI has specific invoice and labeling parameters that must be met. These configurations are typically managed by our integrations team and via the API.
- Non-EDI: Orders classified as Non-EDI are those that are manually created within ShipHero, imported through a native store integration, or created via the API.
We have integrations with SPS & Netsuite, but also our public API was enhanced with the “EDI-agnostic” principle, meaning that it could be used to connect with any EDI. Here are some useful articles:
EDI via SPS: ShipHero & SPS Commerce Integration, Connecting to SPS Commerce, Mapping SPS orders
EDI via Netsuite: NetSuite Integration
EDI via API: ShipHero Developer Portal, Public API Schema, Webhook Documentation (includes examples for ASN and Carrier Label Generation webhooks)
End-to-End Wholesale Flow Example:
https://developer.shiphero.com/docs/flows/wholesale-orders-packed-outside-shiphero/ This guide describes a complete workflow where the Public API is used to handle a Wholesale order entirely outside of ShipHero’s UI, from creation to fulfillment.
Navigate through the following sections for the label generation process required for your wholesale orders:
- Generating Labels for Courier Orders (Non-EDI)
- Generating Labels for Courier Orders (EDI)
- Generating Labels for Freight Orders (Non-EDI)
- Generating Labels for Freight Orders (EDI)
Additional Resources in this article include:
Generating Labels for Courier Orders (Non-EDI)
Once the order is in a Packed status you will be able to generate carrier shipping labels. Generating labels for a Courier wholesale order is simple but there are a few things to consider before clicking the Generate labels button.
Things to Consider
- Each outer box packed for a courier order must have its own shipping label for the carrier to process.
- Supported Carriers: Fedex, UPS, DHL Ecommerce, USPS_MODERN, Purolator, Canada Post, Shippo, Canpar, Endicia, Firstmile and Veho. The carrier account must be connected to your ShipHero account in order to generate labels in the wholesale flow.
- Each label generation request is sent individually to carriers, discounted rates for multi-package shipments will not be returned.
-
The carrier and shipping method assigned in the order details will be used for the label generation.
NOTE: You cannot change the carrier and shipping method with the wholesale flow; if changes need to be made you must change these via the order details page on the app.shiphero.com dashboard.
- Generic labels are supported.
Step-by-Step Process
-
Click the Generate labels button.
The label generation process may take time for various reasons (number of labels, connection, etc.). The order will move to the temporary Generating labels status, with a circular icon indicating the generation process is running. -
When the label generation process is complete, the order status automatically updates to Ready to print.
For each box a label was generated for the following information will be displayed:
- Box ID and Box LPN
- General content
- Package type, box dimensions and weight
- Carrier and tracking number (link provided by the carrier)
- Date and time the label was generated
Hovering over the Carrier name will show the Shipping Method and label cost.
-
Select Print Shipping labels. This generates a PDF with all required labels, each referencing the Box ID of the box it should be placed on, and updates the order status to Warehouse Complete, making the Fulfill order option available.
DO NOT click the Fulfill order button until the Outbound Schedule is complete. Here is more information about how to use the Outbound Schedule for the NEW Wholesale Flow.
Need to reprint the label of a particular box?
-
Select the box from the list and press Re-print labels in the bulk actions menu.
Generating Labels for Courier Orders (EDI)
The main difference when receiving an order through EDI is how the labels are generated and the format they are printed in. For courier order recieved via an EDi integration the labels are UCC128 Labels (also known as the carton labels) are generated on the EDI platform when the Generate labels button is clicked.
The carrier label generation and printing flows are exactly the same for Non-EDI and EDI Courier orders, however for these order the system will request both Carrier + GS1 UCC128 labels for the retailer.
Send ASN
The Advance Shipping Notice (ASN) is a technical document in .xml format in which the shipping details are reported (how it was packed, the dimensions, the weights, etc.). All orders from an EDI will require an ASN. The ASN can be sent at the time of fulfilling the order, or it can be generated and sent in advance in case any shipping information needs to be changed.
Generating Labels for Freight Orders (Non-EDI)
Unlike Courier orders, Freight orders are packed and palletized. Depending on the needs, not only may labels be needed for pallets, but carton labels (labels for the outer boxes that are part of the pallet) may also be needed. Before generating labels for a freight order review the shipping details on the order:
How to Change the Shipping details
Navigate to the Order Details tab of your wholesale order. We will have specific shipping details fields related to Freight orders, they can be changed at any time within the order fulfillment flow.
NOTE: If any of the values are changed after the labels have already been generated, you will receive the following prompt, "Modifying shipping details may require you to regenerate your shipping labels. This is because your changes can update fields on the labels, and accurate labels are needed to proceed with shipment."
Step-by-Step Label Generation Process
-
Click the Generate Labels button to open the label generation module. Check the box if you need to generate Carton Labels as well, then click Generate labels.
- While the labels are generating, the order status will be temporarily updated to Generating labels with a circular icon indicating the generation process is running.
-
When the labels are finished generating, the order will move to the Ready to print status.
-
Select Print shipping labels. This generates a PDF with all required labels, each referencing the Box ID of the box it should be placed on, and updates the order status to Warehouse Complete, making the Fulfill order option available.
Example Pallet Label Example Carton Label
Need to re-print the label for a particular pallet or carton?
-
Select the pallet or box and press Re-print labels in the bulk actions menu.
Generating Labels for Freight Orders (EDI)
The main difference when receiving an order through EDI is how the labels are generated and the format they are printed in. With EDI orders the labels are generated on the EDI platform when the Generate labels button is clicked vs. the native pallet/carton label generation within ShipHero.
Depending on the retailer, there are different shipping details that will be required before labels can be generated. The need to print carton labels or not is also determined from the EDI platform.
The generation/printing flows in the UI are exactly the same, however for EDI orders an SSCC code is generated for each of the required labels.
Send ASN
The Advance Shipping Notice (ASN) is a technical document in .xml format in which the shipping details are reported (how it was packed, the dimensions, the weights, etc.). All orders from an EDI will require an ASN. The ASN can be sent at the time of fulfilling the order, or it can be generated and sent in advance in case any shipping information needs to be changed.
Voiding Labels
Generated labels can be voided if necessary, and can be done individually or in bulk. Check the box next to the labels and then choose the Void label option in the bulk action menu.
IMPORTANT: Labels cannot be voided after the wholesale order has been fulfilled.
Voiding labels can take some time. While the void request is being processed the order status will update to Voiding labels. Once the process is complete the order will return to a Packed status.
| Void in progress | Void complete |
Partial Voids
If a partial void was completed, only the boxes without a valid label will be shown as active in the packing layout. Here you can change the type of box or weight. If a change to the contents of the box/pallet is needed, you must first press Edit packing layout to enable packing operations.
Once the necessary changes have been made, the order can be marked as Packing complete again and the labels can be generated again (only labels will be generated for the boxes that do not contain valid labels).
NOTE: Depending on each carrier, the void may not be possible if the time between label generation and the void attempt was too long and you will receive the prompt "Voiding labels for this shipment is no longer possible. The carriers timeframe for voiding has passed."
Label Errors
The label generation process could fail due to various reasons, such as connection issues or non-compliance with carrier requirements. Each carrier may have different requirements, such as box types, weights, etc. If, at the time of generating the labels, some of the requirements are not met, an error will be shown in the UI indicating the error reported by the carrier.
The order status will be Label Error and depending on the error you will be able to fix the problem or contact customer support in urgent cases.
You can click the View details option to see the full error message received from the Carrier:
Packing Slips
This document indicates and details in PDF format the contents of each of the containers to be shipped in the shipment.
It can be generated and printed after the labels have been generated by pressing the Print packing Slips button. The PDF will be automatically attached to the order.
| Courier example | Freight example |