Sage X3

This documentation describes the technical integration between Zudello and Sage X3 (Sage Enterprise Management). The integration provides master data synchronization inbound and transaction processing outbound through GraphQL API connectivity with Australian legislation filtering.

Integration Capabilities

• Unidirectional Data Sync - Master data inbound, transactions outbound only
• GraphQL API Integration - Modern GraphQL queries and mutations with cursor pagination
• Australian Legislation Filter - All queries filtered by Australian legislation ('AUS')
• Transaction Integrity - Atomic operations with rollback on API failures

Integration Directions

Inbound (Sage X3 → Zudello)

Synchronizes master data from Sage X3 to Zudello via GraphQL API calls.

Outbound (Zudello → Sage X3)

Creates transactions in Sage X3 from processed data in Zudello via GraphQL API calls.

Integration Points

Inbound Data Flow (Sage X3 → Zudello)

• Financials: Account Groups, Accounts, Currencies, Invoice Types, Payment Terms, Tax Codes, Tax Solutions
• Parties: Suppliers
• Operational: Companies, Cost Centres, Items, Sites

Outbound Data Flow (Zudello → Sage X3)

• Accounts Payable: BP Supplier Invoices

Data Flow Summary

Data Entity	Sage X3 Entity	Sage X3 → Zudello	Zudello → Sage X3
Financials
Account Group	Account Group	✅
Account	Account	✅
Currency	Currency	✅
Invoice Type	Invoice Type	✅
Payment Term	Payment Term	✅
Tax Code	Tax Code	✅
Tax Solution	Tax Solution	✅
Parties
Supplier	Supplier	✅
Operational
Company (Subsidiary)	Company	✅
Cost Centre	Dimension	✅
Item	Product	✅
Site (Location)	Site	✅
Transactions
BP Supplier Invoice	BP Supplier Invoice		✅

Technical Details

API Type: GraphQL API
Authentication: GraphQL endpoint authentication
Data Format: JSON
Pagination: Cursor-based pagination
Legislation Filter: Australian ('AUS') legislation applied
Sync Method: Incremental synchronization using _updateStamp timestamps

Detail Pages

Inbound Integration Details (Sage X3 → Zudello)

• Account Group
• Account
• Company
• Cost Centre
• Currency
• Invoice Type
• Item
• Payment Term
• Site
• Supplier
• Tax Code
• Tax Solution

Outbound Integration Details (Zudello → Sage X3)

• BP Supplier Invoice