---
title: Omniva shipping
description: Generate Omniva parcel labels for physical products sold at registration
order: 8
---

# Omniva shipping

Connect **Omniva** to generate parcel shipments when participants buy physical products (medals, t-shirts, etc.) with Omniva delivery at checkout or afterward.

## Connect Omniva

1. Get Omniva **API username** and **password** from your Omniva business account.
2. Club settings → **Integrations** → **Shipping – Omniva** → **Connect**.
3. Enter credentials and save.

DistantRace validates the integration before label generation runs.

## Shop products

Create products in the shop module with the **Omniva** product class (`SHIPPING_OMNIVA`). Participants select a parcel terminal at checkout; phone and terminal ZIP are stored on the cart as `shipping_data`.

See [Upsell products in checkout](../running-events/upsell-products-in-checkout.md).

At checkout the terminal list comes from Omniva's public location API. The same picker is used on the post-checkout page.

## Post-checkout quick add

If a participant paid without choosing delivery, send them:

`/shop/quick/add_omniva/?c=<cart-code>`

The page lists order participants, then collects phone + parcel machine. See [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md).

Organizers can include this URL in manual emails or campaigns when fulfillment happens after the event.

## Integration actions

After connecting, the Omniva integration panel offers:

| Action | Purpose |
|--------|---------|
| **Generate shipments** | Create Omniva API shipments for paid orders missing labels (per event) |
| **Import/export CSV** | Export or import shipment data for bulk Omniva portal workflows |

Generation runs as a background task — see [Managing Omniva shipments](../running-events/managing-omniva-shipments.md).

## Manage shipments

After orders are placed:

1. Open the competition → **Shipping**
2. Review carts, tracking codes, and status
3. Generate labels or export shipment data
4. Mark progress as Omniva tracking events arrive (shipped emails send automatically)

## Related

- [Create an in-person race](../running-events/create-an-in-person-race.md)
- [Checkout add-ons](../joining-events/checkout-add-ons-and-shipping.md) (participant view)
- [Managing Omniva shipments](../running-events/managing-omniva-shipments.md)