Articles in this section

Testing Carrier Connections in ShipHero

Testing a carrier connection in ShipHero checks whether an order uses the right warehouse, profile, and shipping method, returns a quote when the connection supports quoting, and generates a label when needed. Use a controlled test order to review the carrier response before escalating a connection issue.

Before You Begin

  • Test order: If your workflow supports it, use a customer order status such as label tests. Check the automation and fulfillment rules tied to that status so the test order does not enter warehouse flows unexpectedly. Manual orders run the same automation rules, address validation, and allocation as imported orders.
  • Connect carriers to warehouse and profiles: Carrier connections belong to a warehouse. Confirm the carrier is connected for the warehouse and profile you plan to test. For setup guidance, see Overview: Optimizing Carrier Connections in ShipHero.
  • Shipment details: Use a valid ship-to address and accurate package weight and dimensions. Carriers use these details to return quotes and labels.

Important

Generating a label sends shipment details to the carrier's live system and creates a real carrier label. The carrier may charge for it. Confirm the carrier's void process before generating a test label. For a Generate Label Webhook carrier, voiding the label in ShipHero does not void it with the carrier. Void it through the carrier's portal or contact the carrier directly.

Table of Contents

Prepare an Order to Test a Carrier Connection in ShipHero

Create one test order at a time from Orders > Create an Order. For the full manual-order steps, see How to Create a Manual Order in ShipHero. To prepare multiple test orders, see How to Upload Orders via CSV in ShipHero.

  1. Go to Orders > Create an Order.
  2. Select Customer Order as the order type.
  3. If your account has multiple warehouses, confirm the Multi-Warehouse Allocation (MWA) rules are configured for the test, then select the warehouse.
  4. Enter a valid shipping address.
  5. Select the profile and shipping options for the test.
  6. Add a product to the order.
  7. Select Save Order. ShipHero opens the order's Order Details page.

After saving, confirm the order still uses the intended warehouse and profile. MWA rules can change the selected warehouse, and manual orders run the same automation, address validation, and allocation processes as imported orders. For profile guidance, see How to Use Warehouse Profiles in ShipHero.

Test Quotes and Rate Shopping for a Carrier Connection in ShipHero

Before requesting rates, complete the packing steps for the test order, including selecting a package and confirming its weight and dimensions. See How to Pack Orders - Standard Flow. For an overview of quoting and label generation, see Overview: Label Generation and Rate Shopping.

Native carrier connections and supported Shippo or Sendcloud connections can return quotes for rate shopping. Generate Label Webhook carriers do not return quotes and do not appear in rate shopping or RateShop+.

  1. On the packed test order, confirm the warehouse, profile, shipping method, destination, weight, and dimensions.
  2. Select Get Quote and review the eligible carrier quotes and services. The selected RateShop+ profile does not limit which carriers or services appear for the shipment.
  3. RateShop+ does not change the prices or methods displayed by Get Quote. Its method and rating factors are applied in the background during label generation. You can see the carrier and service RateShop+ selected only after generating the label.
  4. To compare two accounts from the same carrier, change the order's profile and request quotes again. ShipHero does not compare two accounts from the same carrier on one order at the same time.

A quoted rate is an estimate. It includes accessorial charges only when the carrier returns them with the quote, and the carrier may add charges later.

Test Label Generation for a Carrier Connection in ShipHero

Complete the packing steps for the test order before generating a label. The standard packing workflow uses the order's shipment details to request the label; see How to Pack Orders - Standard Flow.

Test a Native or Rate-Enabled Carrier Connection in ShipHero

  1. Confirm the order has the intended carrier method and accurate package details.
  2. Follow How to Pack Orders - Standard Flow to generate the label.
  3. Confirm ShipHero returns the label and tracking details and updates the order. The generated label shows the carrier and service selected by RateShop+.

Test a Generate Label Webhook Carrier Connection in ShipHero

A Generate Label Webhook carrier is assigned to an order instead of being selected from rate quotes. Select the configured method on the Order Details page, map it to the store's shipping method, or assign it through an Automation Rule. Then use the standard packing workflow to request the label.

Confirm the label and tracking details return to ShipHero. Do not expect this carrier to return a quote or appear in rate shopping. For webhook setup requirements and limitations, see How to Set Up a Generate Label Webhook.

Troubleshoot a Carrier Connection Test in ShipHero

When a carrier test fails, check the order details, connection scope, and carrier response to identify the issue.

For more information about quote errors, see Understanding Quoting Errors in ShipHero.

Check Carrier Quotes and Rate Shopping in ShipHero

  • If a carrier quote is missing, confirm the carrier is connected to the order's warehouse and profile. Check the address, weight, and dimensions.
  • If label generation selects an unexpected service with RateShop+, review the profile's rating factor, maximum delivery time, and defined methods. The Get Quote list does not confirm which service RateShop+ will select. A Generate Label Webhook carrier will not return quotes.
  • If ShipHero shows a carrier error, select View error details for the carrier's message. Select View service response to inspect the raw response. Some errors include technical codes; contact ShipHero Support if the response is unclear.

Check Carrier Label Generation in ShipHero

  • If a label fails, check the order's address, weight, and dimensions, then confirm the carrier connection is active for the order's warehouse and profile.
  • For a Generate Label Webhook error, review the webhook setup and confirm the configured method is assigned to the order.
  • If the label response is still unclear, contact ShipHero Support and include the carrier name, warehouse, profile, order, and error details.

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.