AP Invoice
Overview
Direction: Zudello → Xero
Sync Type: Real-time
Purpose: Purchase invoice creation with comprehensive line item detail, tracking category support, and automatic file attachment
AP invoices flow from Zudello to Xero with comprehensive line item detail, tracking category support, and automatic file attachment capabilities.
Header Field Mappings
| Xero Field | Zudello Field | Data Type | Notes |
|---|---|---|---|
| Type | N/A | String | Always "ACCPAY" |
| Contact | supplier | Relation | Supplier reference |
| Date | date_issued | Date | Invoice date |
| DueDate | date_due | Date | Due date |
| LineAmountTypes | tax_included | String | "Inclusive" or "Exclusive" |
| InvoiceNumber | document_number | String | Invoice number |
| Reference | reference | String | Invoice reference |
| CurrencyCode | currency | Relation | Currency code |
| Status | Metadata configuration | String | Configurable posting status |
| PlannedPaymentDate | date_due | Date | Planned payment date |
Line Item Field Mappings
| Xero Field | Zudello Field | Data Type | Notes |
|---|---|---|---|
| Description | description | String | Line description |
| Quantity | quantity | Decimal | Line quantity |
| UnitAmount | total / quantity | Decimal | Calculated unit amount |
| ItemCode | item | Relation | Item SKU (optional) |
| AccountCode | account | Relation | Account code |
| TaxType | tax_rate | Relation | Tax type |
| LineAmount | total | Decimal | Line total amount |
Processing Logic
Unit Amount Calculation
To ensure accuracy, the UnitAmount is calculated by dividing the total by the quantity for each line item.
Tracking Categories
The integration supports tracking categories for detailed financial analysis. The first tracking category in Xero is mapped to Location in Zudello, and the second is mapped to Subsidiary.
File Attachments
The original invoice file from Zudello is automatically attached to the corresponding invoice in Xero. If the attachment fails, the invoice creation will still proceed.
Configurable Status
The status of the created invoice in Xero can be configured. By default, invoices are created as DRAFT, but this can be changed to other statuses like SUBMITTED or AUTHORISED to fit your workflow.
Related Documentation
- Contact - Supplier master data for invoice relationships
- Account - Chart of accounts for line item coding
- Tax Rate - Tax rate references for line items
- Item - Item master data for line item references
- Currency - Currency references for multi-currency invoices
- Tracking Category - Location and subsidiary tracking setup
- Supplier - Supplier creation workflow
- Invoice - Historical invoice data (Xero → Zudello)
- Overview - Integration architecture overview