Supplier

Overview

Direction: Business Central → Zudello
Sync Type: Incremental sync
Frequency: Based on lastModifiedDateTime

Supplier data flows from Business Central to Zudello to maintain an up-to-date vendor master file. This integration supports multi-currency vendors and includes contact information, payment terms, and geographic restrictions.

Key Benefits

• Automated Vendor Management - Keep supplier information synchronized
• Multi-Currency Support - Handle international suppliers seamlessly
• Geographic Filtering - Only sync suppliers from supported countries
• Contact Integration - Maintain phone and email information

Field Mappings

Zudello Field	Business Central Field	Data Type	Notes
code	number	String	Vendor number/code
legal_name	displayName	String	Legal entity name (unescaped HTML)
trading_name	displayName	String	Trading name (same as legal name)
currency.code	currencyCode	String	ISO currency code
country.code	country	String	ISO country code (restricted list)
payment_term.external_id	paymentTermsId	GUID	Reference to payment terms
payment_method.external_id	paymentMethodId	GUID	Reference to payment method
tax_number	abn	String	Tax identification number
status	blocked	String	ACTIVE if not blocked, INACTIVE if blocked
phones	phoneNumber	String	Primary phone number
emails	email	String	Primary email address

Configuration Requirements

Supported Countries

Only suppliers from these countries will be synchronized:

• Australia (AU)
• Canada (CA)
• France (FR)
• Ireland (IE)
• New Zealand (NZ)
• South Africa (ZA)
• United Kingdom (GB)
• United States (US)

Processing Logic

Sync Behavior

• Incremental Updates: The integration efficiently syncs only suppliers that have been added or changed since the last synchronization.
• Currency Matching: The integration establishes relationships with currencies by matching their standard ISO codes.
• Status Mapping: A supplier's status in Zudello is determined by the blocked field in Business Central. If a supplier is blocked, its status will be INACTIVE.

Data Handling

• Contact Replacement: When supplier data is synchronized, any existing phone and email information in Zudello is completely replaced with the data from Business Central.
• Name Formatting: The legal name of the supplier is processed to remove any web-based formatting (HTML entities) for clean display.

Troubleshooting

Issue	Cause	Solution
Supplier not syncing	Country not in supported list	Verify supplier country code
Currency mismatch	Invalid currency code	Check currency exists in both systems
Contact info missing	Empty phone/email fields	Verify contact data in Business Central
Status incorrect	Blocked field misconfigured	Review supplier blocking status in BC

Related Documentation

• Payment Methods - Configure supplier payment options
• Payment Terms - Set up supplier payment terms
• Currency - Multi-currency supplier setup
• Purchase Invoice - Process supplier invoices
• Purchase Order - Track supplier orders