Skip to main content

Unit of Measure Mappings

How to map Axiom unit labels to your stores unit of measure.

Introduction

Unit of measure mappings are an essential feature that allows you to connect standardized measurement units from the Axiom system with your store's specific measurement units. This mapping system ensures that product measurements are consistently translated between different systems, maintaining accuracy across your inventory and purchasing processes.

What Are Unit of Measure Mappings?

A unit of measure mapping creates a relationship between:

  1. Axiom Unit Labels - These are standardized measurement units used by the Axiom platform
  2. Store Unit of Measures - These are the measurement units specific to your business

For example, you might map the Axiom unit label "KGM" (kilogram) to your store's unit of measure "KG" or "KILO".

Why Are Unit of Measure Mappings Important?

Unit of measure mappings provide several benefits:

  • Consistency: Ensures that measurements are interpreted correctly across different systems
  • Accuracy: Prevents errors when converting between different measurement units
  • Flexibility: Allows your store to use familiar measurement units while still communicating with the central system
  • Data Quality: Improves overall data quality by standardizing how measurements are handled

Types of Units of Measure

Your store can define units of measure in four main categories:

  1. Weight - For measuring how heavy items are (e.g., kilograms, pounds)
  2. Volume - For measuring the space items occupy (e.g., liters, gallons)
  3. Length - For measuring how long items are (e.g., meters, inches)
  4. Dimensionless - For counting items without a specific measurement (e.g., each, piece)

How to Use Unit of Measure Mappings

Viewing Existing Mappings

You can view all your current unit of measure mappings in the system. Each mapping shows:

  • The Axiom unit label (what the central system uses)
  • Your store's unit of measure (what your store uses)
  • A description explaining the mapping (optional)

Creating a New Mapping

To create a new unit of measure mapping:

  1. Select the Axiom unit label you want to map from
  2. Select your store's unit of measure you want to map to
  3. Add an optional description to help others understand the mapping
  4. Save the mapping

Updating an Existing Mapping

If you need to change a mapping:

  1. Find the mapping you want to update
  2. Change the store unit of measure as needed
  3. Update the description if necessary
  4. Save your changes

Deleting a Mapping

If a mapping is no longer needed, you can delete it from the system. Deleted mappings can be restored if needed.

Bulk Import via CSV

For efficiency, you can import multiple unit of measure mappings at once using a CSV file with these columns:

  • mapped_from: The Axiom unit label code
  • mapped_to: Your store's unit of measure code
  • description: Optional explanation of the mapping

How Mappings Work Behind the Scenes

When your purchasing system receives product data from Axiom, Axiom has already automatically translated the Axiom unit labels to your store's units of measure using these mappings. If no mapping exists for a particular unit label, the system will use the Axiom unit label code as a fallback.

Best Practices

  1. Create mappings for all commonly used units: Ensure all frequently used measurement units have proper mappings
  2. Use clear descriptions: Add helpful descriptions to make mappings easier to understand
  3. Maintain consistency: Try to use consistent naming conventions for your store's units of measure
  4. Review periodically: Regularly check your mappings to ensure they remain accurate and up-to-date
Last updated on Mar 28, 2025 by omelbs