Managing Omniva shipments
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 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 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.
Generate labels #
From the Shipping view or the Omniva integration panel, run Generate shipments:
- DistantRace finds registered racers whose carts have
SHIPPING_OMNIVAand no shipment row yet. - Orders with the same phone + parcel terminal are grouped into one parcel.
- 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.
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 #
- Connect Omniva shipping and add Omniva shop products.
- Participants choose a terminal at checkout or via the post-checkout link.
- Open Shipping after registration closes (or as orders arrive).
- Generate shipments → print labels → hand parcels to Omniva.
- Monitor status until delivery; participants can contact you from the shipping email.