Overview

Voyager is a freight management system (FMS) which supports the booking and shipment planning of Road shipments between the UK and NI/Europe.

Processes

Bookings are sent into the system.
Shipments are created based on the bookings and priced using rate cards.
Bookings are closed once the shipment has been delivered or the booking has been cancelled.
Relevant notifications are sent to inform the different parties of the progress of the booking.

Use Cases

Voyager is only being used by a company called Knauf.

Bookings are sent in XML format from Knauf SAP to Voyager when required.
No UI exists for sending or editing information; everything is done by API calls from Knauf’s SAP system.

System Flow

Organisation Roles

Organisations are a critical and central part of the overall system, defining the various parties involved in freight movement & management activities, and internal SEKO organisations, branches and departments.

They are a critical part of defining user access rights and client coverage. Processing and viewing of bookings and shipments and carrier instructions are largely defined along organisational boundaries.

Each organisation can have one or more ‘role types'. The possible types of role the system needs to be aware of is the following:

Role Type	Concept
EXTERNAL ENTITY	Purely a legal entity, for external parties
INTERNAL ENTITY	Purely a legal entity, for the SEKO organisational parent entities
CARRIER	A basic carrier of goods
HAULIER	Another kind of carrier covering line-haul, the transmission of goods over longer distances
PARTNER AGENT	For example, another freight forwarding agent that SEKO receives goods from, or provide goods to, at a handover point
CLEARING AGENT	A party responsible for carrying out all tasks relating to import or export clearance
CONSIGNOR	The party of record, that is responsible for sending the goods at the beginning of the shipment process
CONSIGNEE	The party of record, that is responsible for receiving the goods at the end of the shipment process
SHIPPER	The party that is requesting the shipment. In many cases this is the same as the consignor
RECEIVER	The party that is receiving the shipment. In many cases this is the same as the consignee, but in the case of Knauf UK the receiver party will be the client of Knauf UK that originally ordered the goods, but the Consignee of record will be the Knauf Sales Office that acts for that receiver.
PORT	The organisation that owns / runs an international port
INTERNAL BRANCH	An internal SEKO business entity or branch
INTERNAL DEPARTMENT	An internal SEKO department e.g. Manchester Road Exports
EXTERNAL DEPARTMENT	An external department, if it is necessary to distinguish at a lower functional level than the external party roles stated above

Locations

Locations exist within Organisations. Each Location can be given one or more ‘capabilities’, which describes what that location is used for within the end-to-end shipment flows.

Capability Type	Concept
COLLECTION POINT	Goods collection point for this location. Typically this is a source factory which produces the goods
DELIVERY POINT	A point where Goods are finally dropped at the end of the shipment. This is typically a warehouse of the Consignee or of the client of the shipper / consignor
OFFICE	The registered office of an organisation. This is typically needed for formal documentation requiring this location to be stated
PORT	The address of a Port. This typically will be associated with an Organisation that has the role of “Port”, perhaps a port authority or port owner
FREIGHT STATION	An interim location that handles preparation of goods, such as loading loose goods into containers ready for international transit, and/or for the consolidation of goods from multiple shipments into single container consolidations
CONTAINER YARD	Another interim location, where containers may be held prior to the international / port-to-port transit

APIs

Inbound: /wiki/spaces/SSTD/pages/2359955994 /wiki/spaces/SSTD/pages/2409988144

Outbound: /wiki/spaces/SSTD/pages/2359955566 /wiki/spaces/SSTD/pages/2359957898

Shipment Instructions

One shipment results in one supplier instruction, which for Road-based shipments is one carrier trucking company responsible for picking up the goods at a Knauf factory in the UK, transporting across to Ireland or mainland Europe and delivering to final destination.