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

# Shipments

> Track the vessels, containers and trucks carrying your cargo.

A shipment is one cargo movement: a vessel, container, truck, ITT (inland transfer) or bulk parcel. One shipment can carry cargo for several trades, and one trade can move on several shipments. This page shows you how to link shipments to trades and follow them.

On the sugar trade VCS-S-2026-0714, one container shipment on the vessel KITI BHUM carries all 27 MT from Laem Chabang to Singapore.

> [!NOTE]
>
> The **Shipments** tab on a trade needs the **Shipments (trade tab)** module. The **Shipments** page in the sidebar needs the **Shipments** module. Vessel tracking needs the **Vessel Tracking** module and the trade tab. The trade tab and tracking are on by default. Ask your workspace admin.

Shipments usually come from a reviewed B/L: approving one in the Inbox creates and links the shipment. See [Matching documents to trades](https://docs.mercora.io/documents/matching.md).

## A trade's shipments

Open a trade and choose the **Shipments** tab. Each row is a vessel, truck or other movement, with its B/L number, type, status, route, quantity, documents and discrepancies. Containers sit under their vessel, on that shipment's **Cargo** tab.

Click a row to open the shipment. Its menu also offers **Unlink from trade**, which for a vessel unlinks its containers too.

### Add a shipment to a trade

1. On the trade's **Shipments** tab, click **Add shipment**.
2. To use an existing shipment, pick it under **Link an existing shipment** (search by B/L, reference or vessel). It keeps its other trades. To start a new one, click **Create a new shipment** and fill in the form.
3. Click **Attach**.

## All shipments

**Shipments** in the sidebar lists every cargo movement across your trades.

![The Shipments page in List view with the Active and Completed tabs, the Type, Needs review and Display controls, and the Map / List toggle](https://mintcdn.com/placeholder-f4ffdeec/22McaegbdDRSI41b/images/trades/shipments-list.png?fit=max\&auto=format\&n=22McaegbdDRSI41b\&q=85\&s=bc0aa782b40653da1bf97b9ea9e734eb)

The Shipments page in List view, grouped by vessel: B/L RCLLCH2607841 on KITI BHUM, loading at Laem Chabang for Singapore.

**Active** and **Completed** split in-flight movements from finished ones; on Active, **Map** shows live vessel positions. Search by vessel, reference, port or deal, filter by **Type**, or turn on **Needs review** to see only shipments with something to check.

To add a shipment, click **New shipment** and fill in the form, or click **Upload B/L** and review it in the Inbox. The shipment is created even before it matches a trade.

### A shipment's page

A shipment has four tabs: **Overview** (route map and tracking), **Documents**, **Discrepancies** (choose **Keep doc value** or **Keep shipment value** for each) and **Cargo** (one row per container, with whether it's **On packing list**).

In the right-hand panel, add or remove linked trades in the **Trades** card. Click the status pill to move the shipment along Planned, Loading, In transit, Arrived and Delivered, or click **Mark delivered** and enter the delivered date.

### Needs review

A shipment is flagged when:

* its quantity is above 150,000 MT, or differs from the contract by more than 10%;
* another shipment has the same B/L number;
* a late B/L isn't confirmed by the vessel's position history;
* the vessel's route doesn't match the ports on the B/L;
* the vessel couldn't be identified for tracking.

Dismiss a flag once you've checked it.

## Vessel tracking

Mercora follows each vessel's AIS position, the signal ships broadcast with their position, speed and heading. Positions refresh on a schedule; **Refresh** checks now. The tracking line shows the last report, speed, heading, next port and ETA, or one of these states:

* **No AIS fix**: no position yet.
* **Fix not matched to this B/L**: the vessel seems to be on another voyage, so it isn't plotted.
* **Not tracked · container B/L**: containers, and vessels carrying containers, aren't tracked individually.
* **Tracking stopped · assumed delivered**: see below.

Only trusted positions are drawn on the map. From port calls, Mercora can move a vessel's status forward to Loading, In transit, Arrived or Delivered, never backward. A long-overdue voyage with no sign of either port can be marked **Assumed delivered** until real arrival evidence promotes it to Delivered. You can always set the status yourself.

## Next steps

* [Trade financials](https://docs.mercora.io/trades/financials.md): record the invoices and payments that settle the cargo.
* [Discrepancies](https://docs.mercora.io/documents/discrepancies.md): resolve differences between shipping documents.


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