Omniva shipping
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 #
- Get Omniva API username and password from your Omniva business account.
- Club settings → Integrations → Shipping – Omniva → Connect.
- 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.
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.
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.
Manage shipments #
After orders are placed:
- Open the competition → Shipping
- Review carts, tracking codes, and status
- Generate labels or export shipment data
- Mark progress as Omniva tracking events arrive (shipped emails send automatically)
Related #
- Create an in-person race
- Checkout add-ons (participant view)
- Managing Omniva shipments