AP Credit Note
Overview
Direction: Zudello → Xero
Sync Type: Real-time
Purpose: Purchase credit note creation with comprehensive structure matching AP invoices
AP credit notes flow from Zudello to Xero with the same comprehensive structure as AP invoices but for credit processing.
Header Field Mappings
| Xero Field | Zudello Field | Data Type | Notes |
|---|---|---|---|
| Type | N/A | String | Always "ACCPAYCREDIT" |
| Contact | supplier | Relation | Supplier reference |
| Date | date_issued | Date | Credit note date |
| LineAmountTypes | tax_included | String | "Inclusive" or "Exclusive" |
| CreditNoteNumber | document_number | String | Credit note number |
| Reference | reference | String | Credit note reference |
| CurrencyCode | currency | Relation | Currency code |
| Status | N/A | String | Always "SUBMITTED" |
| SentToContact | N/A | Boolean | Always false |
Line Item Field Mappings
| Xero Field | Zudello Field | Data Type | Notes |
|---|---|---|---|
| ItemCode | item | Relation | Item SKU |
| Description | description | String | Line description |
| Quantity | quantity | Decimal | Line quantity |
| UnitAmount | unit_price | Decimal | Unit price |
| AccountCode | account | Relation | Account code |
| TaxType | tax_rate | Relation | Tax type |
Processing Logic
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.
Status Management
Credit notes are always created in Xero with a SUBMITTED status, making them ready for immediate processing.
Key Differences from AP Invoices
- Type: Credit notes are created with the
ACCPAYCREDITtype. - Status: The status is always
SUBMITTED, unlike the configurable status for AP invoices. - No Attachments: File attachments are not included with credit notes.
- Unit Price: The
unit_priceis used directly, not calculated from the total and quantity.
Related Documentation
- AP Invoice - Invoice processing with similar structure
- Contact - Supplier master data for credit note 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 credits
- Tracking Category - Location and subsidiary tracking setup
- Credit Note - Historical credit note data (Xero → Zudello)
- Overview - Integration architecture overview