Shipment booking parameters

Navigate to Axdata® > Shipment booking > Setup > Shipment booking parameters in the Modules menu.

General

General (group)

Field
Description

Booking interface type (B)

Set the booking interface to your external shipment system.

  • Not Set: No shipment platform has been selected.
  • nShift DeliveryHub (Consignor): Select this if "nShift DeliveryHub" is your shipment system.
  • nShift Delivery (Unifaun): Select if "nShift Delivery" is your shipment system.

Integration status (C)

Set the status of the integration.

  • In test: The integration is in Test. A test flag is sent together with the Shipment booking to the external shipment system.
  • Active: The integration is active.

Message log level (D)

The settings in Message log Level determines which of the messages sent to and from external shipment system are logged.

Axdata recommend using "All" in the startup phase of the module in UAT and production environments. Use "Error" after the startup phase.
  • All: All messages are logged
  • Changed: Only change-related messages of Shipment bookings are logged
  • Error: Only messages that returns errors are logged
  • None: No messages are logged.

Container

Field
Description

Shipment booking line source (E)

This parameter only applies for Shipment bookings created from Shipment
We recommend to select Containers

Select where the data for the shipment booking lines is retrieved from.

  • Not set: Shipment booking lines are NOT created
  • Load details: Shipmen booking lines and Shipmen booking content lines are created from Load lines. It is possible to edit the number of containers created in the Create shipment booking dialog.
  • Containers: Shipment booking lines and Shipment booking content lines are created from container and container lines.

Enable modifying of packed containers (F)

This parameter only applies for Shipment bookings created from Shipment

Select if it is allowed to modify the container content in the Create shipment booking dialog and the Shipment booking line source (E) is Containers.

Container item quantity allocation policy (G)

This parameter only applies for edit of content in the Create shipment booking dialog

Select if Shipment booking content line should contain a fixed quantity or the shipped quantity.

  • Fixed quantity: Always use quantity per container when creating Shipment booking lines.
  • Shipped quantity: Do not deliver more than the shipped quantity.
Example:

Item number: F00008

Quantity: 3

Number of containers: 3

Quantity per container: 2

Fixed quantity

Fixed quantity ignores the quantity to be shipped and creates three containers with a quantity of 2.

Shipment booking line (Container) 1, Content:

  • Item number: F00008
  • Quantity: 2

Shipment booking line (Container) 2, Content:

  • Item number: F00008
  • Quantity: 2

Shipment booking line (Container) 3, Content:

  • Item number: F00008
  • Quantity: 2

Shipped quantity

Since Quantity is 3 can only two containers be created if Quantity per container is 2.

Shipment booking line (Container) 1, Content:

  • Item number: F00008
  • Quantity: 2

Shipment booking line (Container) 2, Content:

  • Item number: F00008
  • Quantity: 1

Unit of measure for service

All unit of measures are converted from D365 to external shipment service.

nShift DeliveryHub (Consignor)

  • Unit of measure for Mass (H): g (Gram)
  • Unit of measure for Length (I): mm (Millimeter)
  • Unit of measure for Dry volume (J): mm3 (Cubic millimeter)

nShift Delivery (Unifaun)

  • Unit of measure for Mass (H): kg (kilogram)
  • Unit of measure for Length (I): m (Meter)
  • Unit of measure for Dry volume (J): m3 (Cubic meter)
Setup of Unit of measure

Navigate to Organization administration > Setup > Units > Units in the Modules menu

IMPORTANT Read and understand the consequence of setting units of measure.

Setup of System units and Base units must be setup for the conversion of unit of measure to convert values precisely. In most cases are unit of measures which is a System unit also a Base unit.

What is a System unit?

A System unit is a unit used by D365 when no unit is set. An example is weight of an item.

Only on base unit is allowed for each Unit class
What is a Base unit?

A Base unit is a unit used by D365 to convert units to a different unit class (E.G. Convert Meters to Square meters). Axdata Shipment booking use the base units to convert Length to Dry volume.

It is important that all Base units are in the same System of units and at the same level.
Only one base unit is allowed for each Unit class

Example of correct base units per unit class:

  • Length: m (meter)
  • Area: m2 (Square meter)
  • Dry volume: m3 (Cubic meter)

Send options

Field
Description

Enable "Save to external booking system" (L)

Enable to save the shipment booking in the external shipment system. Use this option if you are completing the shipment in the external shipment system.

Enable "Send to external booking system" (M)

Enable to create and ship the shipment booking in the external shipment system. Use this option if the shipment in ready for shipping and do not need any modifications in the external shipment system.

Enable prepared shipment (N)

Enable to ship a prepared shipment booking to the external shipment system. The prepared shipment is typically created by a web shop.

Creation of shipment booking

Field
Description

Enable creation without any source (O)

Enable this parameter to manually create a shipment booking without fetching data from any source.

Enable creation from Sales order (P)

Enable this parameter to be able to create a shipment booking from a Sales order.

nShift Delivery (Unifaun)

Setup of integration to nShift Delivery.

Only visible when nShift Delivery (Unifaun) is selected as the Booking interface type
Field
Description

Online server URL (B)

The URL can be found on nShift Delivery APIConnect.

Api Key (C)

The API Key requires an agreement with nShift and can be created from nShift Delivery.

Secret Key (D)

The Secret Key will be created when Api Key is created.

Tracking URL (E)

This URL is used to track the shipment and is provided by nShift.

Example: https://www.unifaunonline.com/ext.uo.[LANGUAGE CODE].track?apiKey=[API KEY]&order=

For more information go to Track & trace (unifaun.com)

nShift DeliveryHub (Consignor)

Setup of integration to nShift DeliveryHub.

Only visible when nShift DeliveryHub (Consignor) is selected as the Booking interface type
Field
Description

Shipment Server URL (B)

For testing use http://demo.shipmentserver.com/ship/ShipmentServerModule.dll

For production use http://sstest.consignor.com/ship/ShipmentServerModule.dll

Shipment Server ID (C)

The Shipment Server ID requires an agreement with nShift and will be provided by nShift.

Actor ID (D)

The Actor ID will be provided when Shipment Server ID is provided

For more information go to Getting started with Shipment Server integration (nShift DeliveryHub)

Update Shipment booking

Whenever a field (Source field) is changed in Shipment booking it may result into change of other fields (Target fields). How and if this change is handled can be selected on each target fields.

For each Target field listed in can have one of these actions

  • Never
    • This is the default selection. Target field are not updated when the Source field is changed.
  • Always
    • Target field are updated when the Source field is changed.
  • Prompt
    • A prompt enables you to decide whether to update the Target fields.

For each Target field listed in can have one of these actions

  • Never
    • This is the default selection. Target field are not updated when the Source field is changed.
  • Always
    • Target field are updated when the Source field is changed.
  • Prompt
    • A prompt enables you to decide whether to update the Target fields.

Form setup (Preview)

Only visible if feature (Preview) Axdata® Shipment booking, packing slip report is enabled

Setup of reports included in Axdata Shipment booking.

Packing slip report

Field
Description

Combiterm (B)

Enable Combiterm to view Combiterm in the report

External item number (C)

Enable External item number to view External item number in the report

Incoterms (D)

Enable Incoterms to view Incoterms in the report

Tag number (E)

Enable Tag number to view Tag number in the report

Data upgrade

Whenever a new version of Axdata Shipment booking is installed, Axdata recommend to run the Data upgrade.

To run the data upgrade click on the button Upgrade (B).

Number sequences

Setup up the valid Number sequences for Shipment booking ID, Notification contact ID and Container ID.

Use the number sequences wizard to create all number sequences. See Set up number sequences using a wizard - Finance & Operations | Microsoft Docs

For manual setup, see Number sequences overview - Finance & Operations | Microsoft Docs

How did we do?

Document transformations

Contact