Troubleshoot Batch Errors

Explains the two types of batch errors you might see and steps to take if you encounter them.

Review the sections below for possible solutions to errors you encounter when processing orders in a batch.

For a batch to process successfully, all orders in the batch must have their shipping parameters configured correctly. Otherwise, you may encounter errors attempting to create the labels for the batch.

Errors can occur when attempting to process a batch or after the batch has finished processing.

Errors When Processing a Batch

Error message:

The error message will vary depending on the shipment information. Errors when processing a batch prevent the indicated orders from processing successfully.

Why these errors occur:

Typically, these errors have to do with missing, required information like shipping service, package weight, dimensions, or address fields.

Solution:

  1. Review the error message displayed in the Problem column in the Label Batch Status: Errors and Warning pop-up.

    "Problem" column with errors and warnings highlighted in the Label Batch Status window.
  2. Click the order number for the order you wish to update. This will open the Order Details screen for the order.

    "Order Number" column highlighted in Label Batch Status window, with order number link selected.
  3. Correct the issue indicated in the error message for the order.

    For example, for order number NH100, a valid weight needs to be entered for the shipment.

    Weight fields in Configure Shipment widget set to 1 lb and 3 oz.
  4. Repeat steps 2 and 3 above for each order with an error in the batch.

Once all errors have been resolved, the Label Batch Status window will automatically advance to the next step in processing the batch.

Errors After the Batch Has Finished Processing

Error message:

The error message will vary depending upon the issue but typically relates to other shipping options or issues with your carrier account (like insufficient balance to purchase the postage for the entire batch).

When this error occurs:

After a batch is processed, the Label Batch Status screen will display a # Errors message, indicating that one or more labels failed to generate for the batch.

Batch Result screen with the Error Message highlighted.

Solution:

  1. Click the # Errors indicator to view the individual error messages. Each failed order number will be displayed along with a more detailed error message.

    Batch Result screen with error section expanded and highlighted.
  2. Click on the order number to open the Order Details screen to correct any order or shipment related errors.

    Carrier Account Issue

    If the error indicates an issue with the carrier account being used to create the label, you will need to resolve the issue with the carrier account prior to processing the orders in the batch.

    For example, you may need to add postage to your carrier account balance.

    "Order Number" column highlighted in Label Batch Status: Processed window.
  3. Click Retry All Failures to attempt to create the failed labels once all errors have been resolved.

View which of your batches contain errors at any time by going to Shipments > Batches > Processed . Any batch with an alert or error will display a link with the number of issues in the Status column. Click this link to open the Label Batch Status window.

Batch Processed status screen with status section highlighted.

The colors of the status bar indicate whether the orders in the batch processed successfully, processed with warnings, or failed to process:

  • Green: The number of orders that had no issues with label creation.

  • Yellow: The number of orders that received warnings associated with label creation but still received a label.

  • Red: The number of orders for which label creation failed due to an error.

Batch Errors Legacy Layout

To view errors in the Label Batch Status window in ShipStation's Legacy Layout, click the blue # label(s) to see which labels have failed and the error messages.

Label Batch Error Details pop-up, has Individual Order numbers, error details, & links to make adjustments.

See which of your batches contain errors at any time by going to Shipments > Batches. Any batch with an alert or error will display the number under the Errors column. Click the batch number to view the Label Batch Status window, then you can view the failed order and any other details.

Batch-Grid Error Pop-up. 4 Columns: Total, Errors, Progress, & Status. Errors in orange or Red, with count. Progress: Green = OK