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

# Shipping & freight jobs

> How a Pelusium freight job works from post to delivery—and how it ties to EVE Frontier.

# Shipping & freight jobs

A **freight job** is an on-chain agreement: **SUI** is held in escrow, a **courier** (or designated pilot) commits to moving cargo between two **SSUs**, and **Pelusium** moves money according to rules everyone can see.

<Warning>
  In preview deployments, Pelusium may let you inspect the full shipping UI and complete the form, then stop at final submit/sign time. That pause means the deployment is waiting on EVE Frontier world-contract support for reliable cross-SSU delivery. Until then, use the 3D route planner and the community link shown in the app to coordinate and follow status.
</Warning>

## The journey of one job

Typical flow:

1. **Create** — The **shipper** (often the buyer or their agent) fills the job: **courier payment** locked up front, optional **seller payment** for the goods, **pickup SSU**, **drop-off SSU**, cargo type and amount, and a **delivery time window**. A small **protocol fee** may apply when funds are released—see what the app displays for your deployment. If the app is in preview mode, this is where the pause appears before funds are locked.
2. **Accept** — A courier **accepts** the open job.
3. **Pick up** — In-game, cargo is collected from the **pickup** location; on-chain, the courier records **pickup** against that SSU. The SSU must **allow Pelusium** to do this—see **[SSU & Pelusium setup](/ssu-pelusium-setup)**.
4. **Deliver** — Cargo arrives at the **drop-off** SSU; the courier completes **delivery** on-chain on that SSU (again, Pelusium must be **authorized** there).

After **Deliver**, **escrow pays out** per the contract: courier gets their leg (after any fee), seller gets goods payment if you set one, and the protocol treasury takes its configured share.

5. **Consolidate (recipient / SSU owner, optional but often the real “last mile”)** — If the game or explorer shows cargo in **character** storage instead of the SSU **primary** panel, use the Pelusium **SSU consolidate** flow (`/contracts/ssu-consolidate`) to move stacks into **primary** on the **same** SSU so the in-game SSU UI can see them. This is **not** another freight job step: it is a **follow-up** wallet action after delivery. Details: **[After delivery — SSU consolidate](/ssu-consolidate-after-delivery)**.

## Planning the route

Before creating or accepting a job, you can use **More → 3D map showcase** to estimate the path between systems. The planner can use a selected **ship**, **fuel**, **cargo mass**, and optimization mode to draw a route and show the ordered system list.

The route planner is separate from escrow. It helps you decide whether a haul looks reasonable; the **freight job** still controls payment, pickup, delivery, cancellation, and refunds. See **[3D route planner](/route-planner)**.

## Cancellations and edge cases

Depending on job state and rules deployed for your network, you may see options such as:

* **Shipper cancel** while the job is still **open** (no courier locked in yet).
* **Refund** paths if a courier **never delivers** within the agreed time after pickup.
* **Mutual cancel** if both sides agree to unwind while the job is in progress.

The **app** only offers actions your wallet is allowed to take **on that job**. If something looks wrong, check **[Troubleshooting](/troubleshooting)** and your wallet network.

## How this relates to the Shop

**Shop listings** and **Cargo Well** help you **find** a price and a counterparty. They do **not** replace a freight job. When you want Pelusium to **hold payment** until delivery, you **create a job** with the real SSUs and amounts.