Unifaun Online / nShift Delivery -  Additional services

Additional services (add-ons) must be configured manually as JSON objects for each service. Unfortunately, Unifaun API does not currently support importing these directly, so the information must first be retrieved from inside Unifaun.

Step 1: Retrieve Codes from Unifaun

To configure an add-on, you first need to identify the correct Service ID and any required value parameters.

1. Log in to Unifaun and navigate to Help -> Code Lists.

   

2. Select the list Service codes - Integration.
   

3. Locate the relevant Carrier and Freight Product (e.g., PostNord Service Point, code P19).
   

4. Click the small "View" button next to the Service open the Service menu

5. Click further to view Additional service information for the additional service you want to add (e.g., NOTSMS  for Notification by sms).
   

6. Note the ID for the additional service as well as any name of Values needed
   
   

Step 2: Configure in BxAdmin

Assuming DeliveryMethods is already set up under Data -> Delivery Methods:

1. Go to the Delivery Services tab.

2. Ensure the Carrier and Product match the delivery method.

3. Add the additional services (e.g., Notification by SMS) and build the JSON object. You can use any available information field, but in this example, we utilize the default Service field. 

   

   The JSON object must include the add-on ID found in the Unifaun Code List and any required values.

   Example syntax:

   {"id": "NOTSMS", "misc": "#delmobile#"}

   Variables surrounded by # will be replaced by values when sending. Set variables corresponding to the information that needs to be replaced
   
   

4. Configure the Delivery Services SQL query to map the the service column (which now contains the JSON object) to the externalserviceid column. Ensure that the deliverymethod value corresponds to the main Delivery Methods query.
   Below is an example where "Notification by sms" and "Notification by e-mail" are configured as optional services for PostNord Service Point. The SQL query extracts the JSON from the service column and aliases it as externalserviceid. with mobile phone and e-mail to be replaced by delmobile and delmail from the order.
   
   SQL:

   select 
       d.deliverymethod,
       d.deliverymethod deliverymethodname,
       s.id service,
       s.servicename,
       s.service externalserviceid
   from 
       system.DeliveryService s
       left join system.DeliveryMethod d on d.carrier = s.carrier and d.product = s.product 
   where
       coalesce(d.deliverymethod,'') <> ''
   order by 
       deliverymethod

   Results:
   

5. Set showdeliveryservices to true to enable visibility on handheld terminals. It is also recommended to enable downloaddeliveryservices to ensure stability and offline support