Skip to the content.

Dynamic VAT Management (DVM)

Dynamic VAT Management (DVM) enables automated VAT handling for sales performed on vessels, routes and legs that cross multiple VAT jurisdictions. The app adjusts VAT on POS transactions based on the currently active leg, so that sales are posted with the correct VAT posting groups in Business Central and LS Central.

DVM can change legs relying on the Timetable, manually on POS by user who runs the command or by getting information about position from the External system.

This document describes the setup, daily usage and integration options for the DVM app.

Feature overview

Feature Description
Prerequisites, installation and setup Describes how to install the DVM extension and perform the initial configuration.
Route and Leg definitions Describes how to define vessels, routes and legs that are used as a basis for VAT calculation.
Timetable import and handling Describes how to import timetables manually or via API and how they influence VAT changes.
Manual leg change on POS Describes how to switch the active leg directly from POS by using a POS command/button.
External integration / API Describes how DVM can receive leg and timetable information from external systems.
Monitoring and troubleshooting Describes how to verify that VAT changes are processed correctly and how to handle errors.

1. Installation and basic setup

1.1 Installation

In Business Central, open Extension Management.

1.2 DVM Setup

Open the DVM Setup page.

Populate the following fields:

DVM Enable on Vessel Setup

1.3 Vessel, Route and Leg Definitions

Before VAT can be calculated, you must define the hierarchy that DVM uses:

Steps:

  1. Open the Vessels list and create a record for each vessel.
  2. Open Routes and create a route for every line on which the vessel sails.
  3. Open Legs and create legs for each route.
  4. For each leg, assign the route and set the sequence/order that reflects the real sailing order.

Route setup

Route legs

1.4 VAT Store Groups per Leg

For every leg you must define which VAT Business Posting Group should be used when sales are performed on that leg.

For each leg you can:

VAT Store Groups per leg

Store VAT groups

Store VAT groups2

1.5 POS / Store Setup

DVM uses the store (LS Central store/location) and the active leg to calculate VAT.

Make sure that:

2. Timetable Import and Handling

This option is filled out only if DVM should use timetable for leg changes.

On the DVM Setup page, the Timetable in Use option should be enabled.

Timetable in Use on Vessel Setup

2.1 Timetable Structure

A timetable defines when a vessel is expected to be on a specific route and leg.

A timetable line usually contains:

Shift date and time calculation

2.2 Manual Timetable Import

To import timetables manually:

  1. Open the DVM Timetable Import page.
  2. Choose Import.
  3. Select the file.
  4. Confirm the import.

Import timetable on Vessel Setup

All referenced vessels, routes and legs must already exist. Lines referring to non-existing codes are rejected during import.

2.3 Automatic Timetable Import (API / Job Queue)

In environments where the timetable is updated frequently, it is recommended to import it automatically via API.

Contact your partner or system integrator for the technical details of the API integration.

3. Route and Leg Handling During Operation

3.1 Determining the Active Leg

The active leg is the leg that DVM uses to calculate VAT at any given moment.

The active leg can be determined in one of the following ways:

3.2 Automatic VAT Switching from Timetable

If timetables are used, DVM periodically checks the timetable for each vessel and activates the leg that matches the current date and time.

When the active leg changes, DVM:

3.3 Example

Example:

Vessel FERRY01 sails from Port A to Port B with the following legs:

When the timetable indicates that the vessel entered Leg 20, DVM automatically changes the active leg to 20 and all subsequent POS sales are posted with the VAT Business Posting Group configured for Leg 20.

4. External Integration (API)

4.1 Overview

DVM can be integrated with external systems (for example traffic or planning systems) that control the current route and leg.

The external system can push leg changes into DVM instead of relying solely on timetables.

External management enable on Vessel Setup

4.2 Typical Integration Flow

  1. External system determines that a vessel has changed leg.
  2. It calls a DVM API/web service with the vessel, route and leg.
  3. DVM validates the data and writes a leg-change request.
  4. The Job Queue processes the request and updates the active leg.
  5. POS terminals receive the new VAT setup.

4.3 Error Handling

If the external system sends an unknown vessel, route or leg, the request is rejected and logged.

Integration monitoring should check for failed leg-change requests and correct the master data or payload.

5. POS Commands

5.1 Manual Leg Change (DVM_CHNGLEG)

Users can manually change the active leg directly from POS.

Setup in LS Central POS:

  1. Open the POS Functions / Commands page.
  2. Create or locate the command DVM_CHNGLEG.
  3. Add a POS button and assign the command.
  4. Deploy the layout to the relevant POS terminals.

DVM POS command setup

Usage:

DVM POS command confirmation dialog

DVM POS command leg selection

5.2 Other Commands (Optional)

Depending on the configuration, additional commands can be made available:

These commands are optional and may vary by implementation.

6. Monitoring and Troubleshooting

6.1 Job Queue Monitoring

DVM relies on the Business Central Job Queue to process timetable imports, leg changes and VAT updates.

If VAT does not change as expected:

6.2 Typical Issues

VAT did not change when vessel entered a new leg

POS shows the wrong VAT rate

Manual leg change from POS has no effect

6.3 Support Information

If the problem cannot be resolved, provide the following information when creating a support ticket: