Unit of Measure

Overview

Direction: Business Central → Zudello
Sync Type: Incremental sync
Entity: Units of measure and quantities

Units of measure data synchronizes from Business Central to Zudello to support consistent quantity tracking and inventory management across purchase transactions.

Measurement Features

• Standard Compliance - International standard code support
• Symbol Storage - Unit symbols for display purposes
• JSON Metadata - Flexible custom field storage
• Global Standards - Support for worldwide inventory standards

Field Mappings

Zudello Field	Business Central Field	Data Type	Notes
code	code	String	Unit of measure code
name	displayName	String	Unit of measure description
status	N/A	String	Always set to ACTIVE
custom	internationalStandardCode, symbol	JSON	Additional UOM metadata

Custom Field Structure

The custom field in Zudello stores additional metadata from Business Central, including:

• internationalStandardCode: The internationally recognized standard code for the unit (e.g., "KGM" for Kilograms).
• symbol: The symbol used to represent the unit (e.g., "kg").

Processing Logic

Custom Field Population

The integration combines the internationalStandardCode and symbol from Business Central into a single custom field in Zudello. This provides additional context for each unit of measure, supporting both international standards and user-friendly display symbols.

Data Management

• Always Active: All units of measure synchronized from Business Central are automatically set to ACTIVE in Zudello.
• Incremental Sync: The integration efficiently syncs only units that have been added or changed since the last synchronization.
• Global Support: By storing international standard codes, the integration supports global inventory and measurement standards.

Common Units of Measure

Code	Name	Standard Code	Symbol	Usage
PCS	Pieces	PCE	pcs	Individual items
KG	Kilograms	KGM	kg	Weight/mass
LTR	Liters	LTR	L	Volume/liquid
MTR	Meters	MTR	m	Length/distance
BOX	Box	BX	box	Packaging unit
HR	Hours	HUR	hr	Time/service
SQM	Square Meters	MTK	m²	Area measurement

Configuration Examples

Standard Unit Setup

A standard unit like Kilograms would be configured in Business Central with a code, name, international standard code, and symbol.

• Code: KG
• Name: Kilograms
• International Standard Code: KGM
• Symbol: kg

Service Unit Setup

A service-based unit like Hours would be configured similarly.

• Code: HR
• Name: Hours
• International Standard Code: HUR
• Symbol: hr

Troubleshooting

Issue	Cause	Solution
Missing units	Not defined in BC	Add units of measure in Business Central
Symbol not showing	Empty symbol field	Add symbol in BC UOM setup
Standard code missing	Empty standard code	Configure international standard codes
JSON format errors	Custom field issues	Verify JSON structure in custom field