PluginsShipment

nShift Delivery

Integration with nShift Delivery (Unifaun) for shipment booking in Omnium.

nShift Delivery api


Configuration Steps

  1. Navigate to: Configuration > Settings > Orders > Shipping providers > Add New

Required Settings

FieldValue
NameCustomizable
Display nameCustomizable
Shipping providerUnifaun
Merchant IDYour merchant id / user id
Merchant SecretYour merchant secret
Base URLhttps://api.unifaun.com
Vue Template'unifaun-provider' if nShift widget should be displayed in Omnium cart/checkout
Properties'UseWidget' with value true to get nShift widget to load

Shipment Options

Adding shipment options for each market

Under each market, define the shipping options available in your webshop.

You have two options: either book shipments using the nShift prepareId, or create new bookings based on the selected shipping method.

Book based on prepareId

If your webshop uses the nShift widget at checkout, you should retrieve a prepareId from the user session. Store this value on the Omnium cart or order, specifically in the propertyList on the orderForm. It's important to use the correct key: "UnifaunPrepareId".

"properties": [
                {
                    "key": "UnifaunPrepareId",
                    "value": "6f977858-35b8-4d5f-8fa6-5d46456543"
                }
              ]

Only one shipping option needs to be configured in Omnium when using prepareId. The shipping method should be set to "Unifaun_deliveryCheckout"

Include the following details:

  • Shipping Provider: Set as Unifaun.
  • Template:
    • Standard: For home delivery
    • PickUp Point: For delivery to pickUp points
  • Delivery Type:
    • Use Delivery if the package is sent to the customer (e.g., home delivery, pickup points).
    • Use Pickup if the customer collects the package at a store or warehouse.
  • Display Name: Enter a user-friendly name for the option.
  • Shipping Method: Internal name, used to map order shipments to the correct shipping option. "Unifaun_deliveryCheckout" if using prepareId.
  • Shipment Product: Service id from nShift.
  • Shipment Return Product Name: Service id for return booking.

Automatic print

Not documentet yet. contact support

On this page