Save manual as PDF or print  


Versandmanager


Interface to the shipping manager program from x-it http://www.versandmanager.info/.

Current Version: 1.0.76.0 as of Business Central 22.

Manual


Creation date: 2026/09/05
The current version of this manual can be found at:

https://www.navax.app/help.php?AppID=NVXVM&L=en


☰ Contents



General

  • App Shipping Manager
    Shipping Manager extends Business Central with shipping file export and import processing for external carrier systems...

Setup

  • Shipping Manager Setup
    The VM Setup page is the central configuration of the app...
  • Shipment Method Connection
    This page maps a Business Central shipment method to an external Shipping Manager shipment method...
  • Shipping Agent Service Connection
    This page maps shipping agent + shipping agent service to export-relevant parameters...
  • Field Mapping Table
    The mapping table defines export field order per shipping agent...
  • Debug Mode
    The VM Debug Modus page helps verify field mapping and imported values for carrier-specific export formats...
  • Label Printer Setup
  • WEISS Services
    This page maintains the mapping between internal service identifiers and WEISS service values used during Shipping Manager export...
  • Colli Type Abbreviations
    This page maps shipping-agent-specific colli types to abbreviations used in Shipping Manager export files...
  • PLT Country Setup
    This page controls which PLT document type is used per country...
  • PLT Shipment Method Setup
    This page controls whether PLT is active per shipping agent and shipment method combination...

Tasks

  • Working with the App
    Typical process...
  • Warehouse Activity Parcels
    This page stores parcel and pallet quantities captured during warehouse activities and transfers them to shipping export processing...

Monitoring

  • Export and Import Log
    This page provides traceability for all export and import runs...
  • Error Log
    The error log shows technical and business errors by run...

Page Extensions

  • Sales Order
  • Customer Card
  • Inventory Pick
  • Warehouse Shipment
  • Posted Sales Shipment
    The page shows package count and Force PLT flag...
  • Posted Transfer Shipment
  • Sales Invoice
  • Posted Sales Invoice

Appendix

  • Release Notes

Docs  /  Solution  /  Versandmanager  /  General
 General

Shipping Manager extends Business Central with shipping file export and import processing for external carrier systems. Note: This interface is intended exclusively for the Versandmanager product by x-IT. Manufacturer website: [x-IT Website](https://www.x-it.at/) Main capabilities: - central setup of export/import parameters, - automatic and manual export start, - package and pallet information handling, - tracking number re-import, - export and error logging, - PLT control by country and shipment method. The central entry page is VM Setup.

Docs  /  Solution  /  Versandmanager  /  Setup
 Shipping Manager Setup

The VM Setup page is the central configuration of the app.

General, Fields
ActiveActivates or deactivates Shipping Manager.
Field Separator / List SeparatorDefines separators for export structure.
VersionDefines the export version.
Path VM ExportTarget path for export files.
Path VM ImportSource path for feedback/import files.
Path VM Import ArchiveArchive path for processed import files.
Extension 1 / Extension 2File extensions for processing and classification.
ISO Country CodeFallback country code if the document has no country.
Company No.Company identifier for data exchange.
Min. WeightMinimum shipment weight.
Packaging WeightAdditional weight per shipment.
Sender Location CodeDefault sender location source.
DHL Customer No.Customer number used for DHL-specific processing.
Weight MultiplicatorConversion factor for weight calculation.
Import ModusControls import behavior per file format.

PLT, Fields
PLT ActiveActivates PLT processing.
PLT Export PathPath for PLT flow files.
PLT File PathFile path referenced in PLT output files.

Start VM Export Automatically For, Fields
Sales ShipmentAutomatic export when posting sales shipments.
Transfer ShipmentAutomatic export when posting transfer shipments.
Sales Return OrderAutomatic export when releasing sales return orders.

Actions

  • Export/Import Log

    Opens process run logs.

  • Error Log

    Opens error details.

  • VM Debug Modus

    Opens debug page for mapping and imported values.

  • Manual Package Tracking No. Import

    Starts manual tracking number import.

  • Setups

    Direct access to mapping and PLT setup pages.

Docs  /  Solution  /  Versandmanager  /  Setup
 Shipment Method Connection

This page maps a Business Central shipment method to an external Shipping Manager shipment method.

Fields, Fields
CodeShipment method from Business Central.
VM Shipment MethodShipment method code used in export.

Docs  /  Solution  /  Versandmanager  /  Setup
 Shipping Agent Service Connection

This page maps shipping agent + shipping agent service to export-relevant parameters.

Core Fields, Fields
Shipping Agent Code / CodeCarrier and service combination.
Service IDExternal service identifier for data exchange.
Communication TypeControls predict/notification behavior.
E-Mail / SMSDefines whether contact details are exported.
Shipment Method / Service / Delivery ConditionsCarrier-specific export control values.
Default package and pallet fieldsDefault values for package distribution.
Default Length/WidthDefault shipment dimensions.
VM RelevantDefines whether VM export should be created for this setup.

Docs  /  Solution  /  Versandmanager  /  Setup
 Field Mapping Table

The mapping table defines export field order per shipping agent.

Fields, Fields
Shipping Agent CodeFilter for relevant shipping agent.
PositionField position in export line.
FieldMapped business field from enum.
New records are automatically prefilled with the next position.

Docs  /  Solution  /  Versandmanager  /  Setup
 Debug Mode

The VM Debug Modus page helps verify field mapping and imported values for carrier-specific export formats.

Fields, Fields
Shipping Agent CodeFilters mapping rows for one shipping agent.
PositionTarget position in the VM export structure.
FieldMapped field from the VM specification.
ValueImported or resolved value for the selected mapping row.

Actions

  • Import VM File

    Imports a VM file and fills the debug buffer for mapping analysis.

Docs  /  Solution  /  Versandmanager  /  Setup
 Label Printer Setup

Fields, Fields
User IDBusiness Central user name.
PrinterPrinter name used for label output.

Docs  /  Solution  /  Versandmanager  /  Setup
 WEISS Services

This page maintains the mapping between internal service identifiers and WEISS service values used during Shipping Manager export.

Fields, Fields
ServiceInternal service key used in the app.
WEISS ServiceTarget value written for WEISS export processing.

Docs  /  Solution  /  Versandmanager  /  Setup
 Colli Type Abbreviations

This page maps shipping-agent-specific colli types to abbreviations used in Shipping Manager export files.

Fields, Fields
Shipping Agent CodeShipping agent the abbreviation applies to.
Colli TypePackage type to be exported.
AbbreviationShort code written to the export file for the selected colli type.

Docs  /  Solution  /  Versandmanager  /  Setup
 PLT Country Setup

This page controls which PLT document type is used per country.

Fields, Fields
CountryCountry/region code.
PLT Document TypePLT document type used for that country.
If no matching setup exists, the app can show a notification about missing PLT setup.

Docs  /  Solution  /  Versandmanager  /  Setup
 PLT Shipment Method Setup

This page controls whether PLT is active per shipping agent and shipment method combination.

Fields, Fields
Shipping Agent CodeCarrier code.
Shipment Method CodeShipment method code.
PLT ActiveEnables PLT processing for this combination.

Docs  /  Solution  /  Versandmanager  /  Tasks
 Working with the App

Typical process: 1. Configure export paths, separators, weight rules, and automatic start options in VM Setup. 2. Maintain shipment method and shipping agent service mappings. 3. Optionally maintain PLT setup by country and shipment method. 4. Maintain order-level delivery details in sales orders. 5. Enter package/pallet counts and dimensions in inventory picks. 6. Start export automatically on posting (if enabled) or manually via actions in posted documents. 7. Monitor logs in Export/Import Log and resolve issues from Error Log. 8. Import feedback files to update package tracking numbers in posted shipments and related invoices.

Operations and Monitoring

- Review Export/Import Log daily for failed runs. - Use Error Log for root-cause details. - Use VM Debug Modus for mapping checks when onboarding new carrier services.

Docs  /  Solution  /  Versandmanager  /  Tasks
 Warehouse Activity Parcels

This page stores parcel and pallet quantities captured during warehouse activities and transfers them to shipping export processing.

Fields, Fields
Document No.Warehouse activity document number.
No. of ParcelsNumber of parcels for the activity.
No. of EURO PalletsNumber of EURO pallets.
No. of Half PalletsNumber of half pallets.
No. of Exchange PalletsNumber of exchange pallets.
No. of Disposable PalletsNumber of disposable pallets.

Docs  /  Solution  /  Versandmanager  /  Monitoring
 Export and Import Log

This page provides traceability for all export and import runs.

Fields, Fields
TypeExport or import run.
FilenameProcessed file name.
Service IDCarrier service reference.
User IDUser who started processing.
Error OccuredMarks failed runs.
Document No.Document number reference.
Document TypeType of the referenced document.

Actions

  • Error Log

    Opens filtered error details for the selected run.

Docs  /  Solution  /  Versandmanager  /  Monitoring
 Error Log

The error log shows technical and business errors by run.

Fields, Fields
Entry No.Unique error entry.
VM Log Entry No.Reference to export/import run.
Error TextError message text.

Actions

  • Export/Import Log

    Opens the related run record.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Sales Order (Page Extension)

Extended Fields, Fields
VM No. of ParcelsSummed package count from linked warehouse records.
Appointment / Arrival InfoDelivery communication options.
Delivery CommentComment used for shipping communication/export.
WEISS Warranty TimeService indicator for Weiss processing.
Service DateService date used in shipment context.
Force PLT DocumentForces PLT document creation.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Customer Card (Page Extension)

Extended Fields, Fields
Delivery CommentDefault delivery comment on customer level.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Inventory Pick (Page Extension)

Extended Fields, Fields
No. of ParcelsNumber of packages.
No. of EURO PalletsNumber of EURO pallets.
No. of Half PalletsNumber of half pallets.
No. of Disposable PalletsNumber of disposable pallets.
No. of Exchange PalletsNumber of exchange pallets.
Length (cm)Shipment length.
Width (cm)Shipment width.
Height (cm)Shipment height.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Warehouse Shipment (Page Extension)

Extended Fields, Fields
VM Service IDExternal service ID from shipping agent service mapping.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Posted Sales Shipment (Page Extension)

The page shows package count and Force PLT flag.

Extended Fields, Fields
VM No. of ParcelsDisplays the number of captured parcels.
Force PLTDisplays whether PLT document creation is forced.

Actions

  • Manual VM Export

    Starts manual Shipping Manager export for the current shipment.
Useful when automatic export is disabled or a rerun is needed.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Posted Transfer Shipment (Page Extension)

Actions

  • Manual VM Export

    Starts manual Shipping Manager export for the current transfer shipment.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Sales Invoice


Not Found


The requested topic was not found on this server.

Docs  /  Solution  /  Versandmanager  /  Page Extensions
 Posted Sales Invoice (Page Extension)

Extended Fields, Fields
Force PLT DocumentDisplays whether PLT document creation was forced.
Together with tracking import, this helps document shipment and invoice context consistently.

Docs  /  Solution  /  Versandmanager  /  Appendix
 Release Notes

Would you like to know what has changed in the extension?
Below you'll find an overview of the new features and changes made in the updates.

Shipping Manager 1.0.74.0

  • Improvements

    • Changes for the online help. .

Shipping Manager 1.0.73.0

  • Improvements

    • Initial structured online help for Shipping Manager added.
  Save manual as PDF or print  
DE|EN Imprint