Site
Overview
📥 Direction: Sage X3 → Zudello
🔄 Sync Type: Incremental sync
⏱️ Frequency: Based on _updateStamp
Site data flows from Sage X3 to Zudello as locations, providing organizational site information with legal company relationships for multi-site operations.
✅ Multi-Site Support - Enable complex organizational structures
✅ Legal Company Integration - Maintain site and legal entity relationships
✅ Location Mapping - Sites map to Zudello locations
✅ Australian Legal Companies - Filtered by Australian legal company legislation
Field Mappings
| Zudello Field | Sage X3 Field | Data Type | Notes |
|---|---|---|---|
| code | code | String | Site code |
| name | localizedDescription or localizedShortDescription or code | String | Fallback hierarchy |
| status | N/A | String | Always "ACTIVE" |
Target Entity
Maps to Zudello.location entity.
Configuration Requirements
This integration filters sites by Australian legal companies only. Sites must be associated with legal companies that have Australian ('AUS') legislation code.
Processing Logic
Sync Behavior
- Legal Company Filter: Filters by Australian legal companies using nested legislation filter
- Incremental Updates: Uses
_updateStampto fetch only changed records - Location Mapping: All synchronized sites become locations in Zudello
Data Handling
- Name Fallback: Uses localizedDescription, then localizedShortDescription, then code
- Company Relationship: Includes legal company relationships for organizational structure
- Status Assignment: All sites are marked as "ACTIVE"
- Page Limit: 100 records per page for efficient processing
Legal Company Structure
The integration maintains complex organizational relationships:
- Legal Entity Filtering: Only processes sites linked to Australian legal companies
- Organizational Hierarchy: Preserves site-to-company relationships
- Multi-Site Operations: Supports organizations with multiple locations
Site Organization
Sites provide the foundation for location-based operations:
- Location Mapping: Each site becomes a location in Zudello
- Company Association: Sites maintain relationships to their parent legal companies
- Operational Structure: Enables location-based transaction processing
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Site not syncing | Legal company not Australian | Verify legal company legislation in Sage X3 |
| Missing site names | Empty description fields | Check localized descriptions in Sage X3 |
| Company relationship missing | Invalid legal company reference | Verify legal company assignment in Sage X3 |
| Sync delays | _updateStamp not updating | Verify modification tracking in Sage X3 |
Related Documentation
- Company - Legal company and subsidiary structure
- BP Supplier Invoice - Site assignment in transactions
- Cost Centre - Location-based cost allocation
- Supplier - Site-specific vendor relationships