Table of Contents

LOADING METER FMS - Loading Meters FMS Calculation

Overview

The Loading Meter FMS calculation method provides a simplified loading meter calculation specifically for FMS (Freight Management System) integration. This method uses the existing Handling Unit Quantity field on the document line and multiplies it by the loading meter factor.

Purpose

This method calculates the Expected Shipment Handling Unit Qty. as loading meters by:

  1. Using the Handling Unit Quantity field from the document line
  2. Retrieving the handling unit type and handling unit type group
  3. Applying the loading meter factor from the handling unit type group
  4. Providing a simple, direct loading meter calculation for FMS systems

Parameters

This method has no configurable parameters.

Algorithm

Step 1: Validate Document Line

If document line type is not Item or Customer Item:

  • Exit with result = 0
  • Go to End

If DocumentLine."Handling Unit Quantity" = 0:

  • Exit with result = 0
  • Go to End

If DocumentLine."Handling Unit Type Code" is empty:

  • Exit with result = 0
  • Go to End

Go to Step 2

Step 2: Get Handling Unit Type

Retrieve the handling unit type:

  • Get CarrierType using DocumentLine."Handling Unit Type Code"
  • Handling Unit type must exist

Go to Step 3

Step 3: Get Handling Unit Type Group

Retrieve the Handling Unit Type Group:

  • Handling Unit type must have Handling Unit Type Group Code set
  • Handling Unit Type Group must have Loading Meter Factor set

Go to Step 4

Step 4: Calculate Loading Meters

Result = DocumentLine."Handling Unit Quantity" × CarrierTypeGroup."Loading Meter Factor"

Calculation Steps

Variable Definitions

  • A = Handling Unit quantity (from document line)
  • B = Loading meter factor (from handling unit type group)
  • C = Final result (loading meters)

Step-by-Step Formula

  1. Get handling unit quantity:

    A = DocumentLine."Handling Unit Quantity"

  2. Get loading meter factor:

    B = CarrierTypeGroup."Loading Meter Factor"

  3. Calculate result:

    C = A × B

Examples

Example 1: Basic FMS Loading Meter Calculation

Scenario:

  • DocumentLine."Handling Unit Quantity" = 5 handling units
  • CarrierTypeGroup."Loading Meter Factor" = 0.8 loading meters per handling unit

Calculation:

  1. Handling Unit quantity: A = 5 handling units
  2. Loading meter factor: B = 0.8 loading meters per handling unit
  3. Result: C = 5 × 0.8 = 4.0 loading meters

Result: 4.0 loading meters

Example 2: Different Loading Meter Factor

Scenario:

  • DocumentLine."Handling Unit Quantity" = 3 handling units
  • CarrierTypeGroup."Loading Meter Factor" = 1.2 loading meters per handling unit

Calculation:

  1. Handling Unit quantity: A = 3 handling units
  2. Loading meter factor: B = 1.2 loading meters per handling unit
  3. Result: C = 3 × 1.2 = 3.6 loading meters

Result: 3.6 loading meters

Example 3: Zero Handling Unit Quantity

Scenario:

  • DocumentLine."Handling Unit Quantity" = 0 handling units

Result: 0 loading meters (exits early)

Important Notes

  • This method is specifically designed for FMS integration
  • It requires the Handling Unit Quantity field to be populated on the document line
  • The handling unit type must be set on the document line
  • No calculation is performed - it simply converts existing handling unit quantity to loading meters
  • Suitable when handling unit quantity is already determined by another system or method

Differences from LOADING METER Method

Aspect LOADING METER LOADING METER FMS
Input Quantity (calculates handling units) Handling Unit Quantity (uses existing)
Calculation Complex with stacking factors, interleave, weight/volume Simple multiplication
Use Case When handling units need to be calculated When handling units are already known
Parameters Multiple parameters available No parameters
Edit this page