Journal
Overview
Direction: Xero → Zudello
Sync Type: Incremental sync with chunked processing
Purpose: Complete general ledger integration with sophisticated processing for large journal entries
Journal data flows from Xero to Zudello to provide complete general ledger integration with sophisticated processing for large journal entries.
Header Field Mappings
| Zudello Field | Xero Field | Data Type | Notes |
|---|---|---|---|
| document_number | JournalNumber | String | Journal number |
| reference | Reference | String | Journal reference |
| date_issued | JournalDate | Date | Parsed from timestamp |
| status | N/A | String | Always "PROCESSED" |
| module | N/A | String | Always "LEDGER" |
| submodule | N/A | String | Always "JOURNAL" |
| document_type | N/A | String | Always "JOURNAL" |
Line Item Field Mappings
| Zudello Field | Xero Field | Data Type | Notes |
|---|---|---|---|
| description | Description | String | Line description |
| quantity | N/A | Decimal | Always 1 |
| unit_price | NetAmount | Decimal | Net amount |
| tax_amount | TaxAmount | Decimal | Tax amount |
| account | AccountCode | Relation | Account reference |
| tax_rate | TaxType | Relation | Tax rate code |
Processing Logic
Performance Optimization
To handle potentially large journal entries without performance issues, the integration processes journals one at a time.
Date Formatting
Dates are parsed from Xero's timestamp format and converted to a standard YYYY-MM-DD format.
Source Tracking
For auditing purposes, the integration creates a note from the SourceID field in Xero to track the origin of the journal entry.
Incremental Synchronization
To save time, the integration only syncs journals that are new or have been updated since the last check.
Related Documentation
- Account - Chart of accounts for journal line references
- Tax Rate - Tax rate references for journal lines
- Invoice - Related transaction processing
- Credit Note - Related transaction processing
- Overview - Integration architecture overview