---
title: Managing Omniva shipments
description: Generate parcel labels and track physical product deliveries
order: 37
---

# Managing Omniva shipments

After participants buy physical products with Omniva delivery, manage shipments from the competition **Shipping** view.

**Path:** Manager console → open competition → **Shipping**

Requires [Omniva shipping integration](../integrations/omniva-shipping.md) with valid API credentials.

## Shipment list

The table lists `ShippingData` rows for this event:

| Column | Meaning |
|--------|---------|
| **ID** | Internal shipment record |
| **Cart** | Link to order detail (`#cart-id`) — billing name, phone, and `shipping_data` |
| **Product class** | Delivery provider (Omniva) |
| **Tracking code** | Omniva barcode after labels are generated |
| **Status** | Latest Omniva tracking event (updated automatically) |

Filter and sort like other manager tables. Click the cart link to open [Managing orders and carts](managing-orders-and-carts.md) for the full order.

Shipments are created from paid registrations that selected an Omniva parcel terminal — including orders completed via [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md).

## Generate labels

From the **Shipping** view or the Omniva integration panel, run **Generate shipments**:

1. DistantRace finds registered racers whose carts have `SHIPPING_OMNIVA` and no shipment row yet.
2. Orders with the same phone + parcel terminal are grouped into one parcel.
3. A background task calls the Omniva business API and saves tracking barcodes on each shipment row.

You see a success message when generation starts (`m_omniva_generation_started`). Refresh the table after the task completes.

::: tip Import CSV
Use **Import/export CSV** on the integration panel if you process labels outside DistantRace or need a file for the Omniva business portal.
:::

## Tracking and notifications

- Omniva tracking events sync periodically; **Status** updates on each row.
- When Omniva reports **picked up by courier**, participants receive a **shipped** email with tracking details (if not already sent).
- Bib or finisher numbers linked to the order can move to **Shipped** status automatically.

## Fulfillment workflow

1. Connect [Omniva shipping](../integrations/omniva-shipping.md) and add Omniva shop products.
2. Participants choose a terminal at checkout or via the post-checkout link.
3. Open **Shipping** after registration closes (or as orders arrive).
4. **Generate shipments** → print labels → hand parcels to Omniva.
5. Monitor status until delivery; participants can contact you from the shipping email.

## Related

- [Upsell products in checkout](upsell-products-in-checkout.md)
- [Shop bought products list](shop-bought-products-list.md)
- [Omniva shipping](../integrations/omniva-shipping.md)
- [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md) (participant view)