Integration
Can Xero connect to South Africa's proposed Digital VAT Model?
A readiness pattern for connecting Xero invoice data to South Africa's proposed Digital VAT Model without claiming a current certified connector.
Direct answer
Xero exposes invoices and credit notes through its Accounting API, including a separate allocation step when a credit is applied to an invoice. That gives an integrator business records to assess, not a finished SARS route. Check which Xero organisation owns the tax invoice, how it treats adjustments, and how a future provider status would reach the accounting team.
Source: VAT Modernisation (South African Revenue Service).
What matters in practice
- Start with the real source data and invoice lifecycle.
- Separate country rules from the core application.
- Preserve stable transaction identity, status, retries, and evidence.
- Confirm product-version and official SARS requirements before implementation.
Map the source system
Document invoice headers, lines, tax codes, customer and supplier identifiers, credit notes, branches, legal entities, currencies, and posting events. Record gaps explicitly instead of hiding them in custom code.
Use a readiness adapter
Translate the source model into a stable internal invoice contract. Keep proposed South African schema, validation, transport, and service-provider details in a versioned adapter that can change as SARS completes consultation and design.
Confirm the accounting workflow
Xero e-Invoicing South Africa begins with the organisation, invoice and credit-note workflow, tax settings, and integration permissions. Xero documents credit-note allocation to an invoice as a separate API operation. Accounting software SARS integration should preserve that relationship, even if the future SARS message format changes.
Test an allocated credit
Export an authorised credit note, its allocation and the referenced invoice. Reconcile the tax totals with Xero before adding any exchange adapter. A status returned by a future provider should be stored alongside the source document, not inferred from the presence of a PDF.
Readiness questions
- Which product and version is in scope?
- Can invoice data be extracted before PDF rendering?
- How are tax codes mapped?
- How are credit notes linked?
- Who owns rejected or incomplete records?
Questions teams ask
What should a Xero readiness review include?
Review the organisation's tax setup, invoice and credit-note records, API permissions and how allocated credits are reconciled. Check which system would own the eventual delivery status.
Sources: VAT ModernisationFrequently Asked Questions on VAT ModernisationConsultation Paper on VAT ModernisationAccounting API: Credit Notes. Used for factual background only.