> ## Documentation Index
> Fetch the complete documentation index at: https://help.eaglecart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot Failed Shipments in Eaglecart

> Fix shipments that fail in Eaglecart: missing addresses, already shipped orders, no tracking returned, courier setup errors, missing webhooks and partial batches.

[Help Center](https://help.eaglecart.com/introduction.md)

[Orders](https://help.eaglecart.com/orders.md)

Troubleshoot failed shipments

# Troubleshoot failed shipments

When Eaglecart can't create a shipment, the order stays in **Awaiting Shipment** so you can fix it and try again, and its result shows the reason. In a bulk batch, each order gets its own result, so one problem doesn't stop the rest.

## Quick reference

| Problem | Likely cause | What to do |
| - | - | - |
| No shipping address | The order has no street and city. | Get the address from the customer before shipping. |
| Already shipped | The order already has a shipment. | Nothing. It was skipped to avoid a duplicate. |
| No tracking returned | The courier didn't send back a tracking number. | Check the courier account, then retry. |
| Courier module error | The courier integration isn't set up correctly. | Check the courier's settings in **Settings → Couriers**. |
| No connected courier | No courier is active. | Connect one, or use custom tracking. |
| Tracking doesn't update | Jeebly's webhook isn't set up, or the courier has no webhook (GetGive). | For Jeebly, set up the webhook. For GetGive, update the status yourself. |

## No shipping address

A connected-courier shipment needs at least a street and a city. Orders without an address are blocked before booking. On the Shipments page they show a red **No address** badge with "Shipping address is required for shipment creation.", and their checkbox is disabled.

Get the address from the customer, then create the shipment. See [Contact a customer from an order](https://help.eaglecart.com/orders/contact-a-customer.md).

## Already shipped

An order that already has a shipment is skipped rather than shipped twice. This protects you from a duplicate parcel and a double charge. If the existing shipment is wrong, cancel it first. See [Cancel a shipment or remove tracking](https://help.eaglecart.com/orders/cancel-shipment-or-remove-tracking.md).

## No tracking returned

The courier accepted the request but didn't send back a tracking number. The order stays in **Awaiting Shipment**. Check your account with the courier, for example your credentials, pickup details and account status, then retry the order.

## Courier module error

The courier integration isn't set up correctly, for example missing or wrong credentials. Open **Settings → Couriers**, open the courier and check:

* The page shows **Courier is active.**
* The credentials are correct. GetGive needs a **Token**. Jeebly needs its keys, **Delivery Type**, **Load Type** and **Pickup Address**.

See [Connect GetGive](https://help.eaglecart.com/shipping-delivery/connect-getgive.md) and [Connect Jeebly](https://help.eaglecart.com/shipping-delivery/connect-jeebly.md).

## No active connected courier

The Shipments page shows "No courier is active yet" with **Set up a courier**, and the **Connected Courier** method in **Create Shipment** suggests connecting one or using custom tracking.

You can still ship. Use **Add Custom Tracking** with any carrier, one order at a time. See [Add custom tracking](https://help.eaglecart.com/orders/add-custom-tracking.md).

## Tracking updates aren't arriving

Booking and tracking updates are separate. A courier can book shipments correctly while no delivery updates arrive, because updates need the courier's webhook to be set up.

For Jeebly, open **Settings → Couriers → Jeebly** and look at **Webhook Configuration**. **Not receiving yet** means updates aren't arriving. Send the **Webhook URL** and **X-API-KEY / Security Key** to your Jeebly account manager and ask them to set it up. **Receiving updates** with a recent "Last update received" date means it's working. See [Connect Jeebly](https://help.eaglecart.com/shipping-delivery/connect-jeebly.md).

Custom tracking never receives automatic updates.

## A batch only partly succeeded

That's normal. Each order is booked separately:

* Successful orders move to **Ready to Dispatch** with a tracking number.
* Failed orders stay in **Awaiting Shipment**. Each one's result shows the reason.

> [!WARNING]
>
> Don't repeat the whole batch. The successful orders already have a booking with the courier. Fix and retry only the orders left in **Awaiting Shipment**.

## An order isn't in the queue at all

If an order isn't in **Awaiting Shipment**, there's nothing to fail yet. Check that it's an Online store order, isn't Completed or Cancelled, isn't **On Hold** or **Scheduled**, and doesn't already have a shipment. See [Understanding the fulfillment queue](https://help.eaglecart.com/orders/fulfillment-queue.md).

## Why is my courier integration not returning tracking?

The courier's response didn't include a tracking number, and Eaglecart can only show what the courier returns. Check the courier's settings in Eaglecart, then check your account with the courier's account manager.

## Related guides

* [Create a shipment](https://help.eaglecart.com/orders/create-a-shipment.md): the two shipping methods.
* [Create shipments for multiple orders](https://help.eaglecart.com/orders/bulk-shipments.md): batches and per-order results.
* [Track shipments and delivery status](https://help.eaglecart.com/orders/track-shipments.md): automatic and manual updates.
* [Connect and manage couriers](https://help.eaglecart.com/shipping-delivery/couriers.md): courier settings.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.