Company

Overview

📥 Direction: Sage X3 → Zudello
🔄 Sync Type: Incremental sync
⏱️ Frequency: Based on _updateStamp

Company data flows from Sage X3 to Zudello as subsidiaries, providing organizational structure and legal entity information for multi-company operations.

Key Benefits

✅ Multi-Company Support - Handle complex organizational structures
✅ Legal Entity Tracking - Maintain legal company relationships
✅ Subsidiary Mapping - Companies map to Zudello subsidiaries
✅ Australian Legislation - Filtered for Australian business entities

Field Mappings

Zudello Field	Sage X3 Field	Data Type	Notes
code	code	String	Company code
name	localizedDescription or localizedShortDescription or code	String	Fallback hierarchy
status	N/A	String	Always "ACTIVE"

Target Entity

Maps to Zudello.subsidiary entity for organizational hierarchy.

Configuration Requirements

Legislation Filtering

Only companies with Australian legislation will be synchronized. Companies must be configured with 'AUS' legislation in Sage X3.

Processing Logic

Sync Behavior

• Incremental Updates: Uses _updateStamp to fetch only changed records
• Legal Company Support: Integration includes isLegalCompany flag for entity classification
• Subsidiary Mapping: All synchronized companies become subsidiaries in Zudello

Data Handling

• Name Fallback: Multiple fallback options - localizedDescription, then localizedShortDescription, then code
• Status Assignment: All synchronized companies are marked as "ACTIVE"
• Page Limit: 100 records per page for efficient processing
• Legislation Filter: Only processes companies with Australian legislation

Legal Company Structure

The integration supports complex legal company structures:

• Legal Entity Recognition: Uses isLegalCompany flag to identify legal entities
• Subsidiary Hierarchy: Maintains organizational relationships
• Legislation Compliance: Ensures legal entities comply with Australian legislation

Troubleshooting

Issue	Cause	Solution
Company not syncing	Legislation not set to 'AUS'	Verify legislation configuration in Sage X3
Missing company names	Empty description fields	Check localized descriptions in Sage X3
Legal entity issues	isLegalCompany flag incorrect	Review legal company settings in Sage X3
Sync delays	_updateStamp not updating	Verify modification tracking in Sage X3

Related Documentation

• Site - Location and site management within companies
• Account Group - Company-specific chart of accounts
• Supplier - Vendor relationships by company
• BP Supplier Invoice - Company assignment in transactions