Add-on: Xero - Automatically reconcile credit notes

Use the Credit Note Offset feature in the Xero Add-on to automatically reconcile credit notes with the original invoice in Xero. This removes the need for manual matching and ensures accurate financial records.

What this feature does

When you enable this feature, Storeganise:

• Links the credit note to the original invoice
• Marks the invoice as "Paid via Credit Note" in Xero
• Skips payment syncing to avoid duplication

This gives you clean, automated financial records—without the manual work.

When to use it

Use this feature when:

• A customer cancels after you’ve already sent the invoice
• You want to offset the invoice using a credit note instead of issuing a refund

Before you start

To use this feature, make sure:

• The Xero Add-on is installed and active
• The invoice is in Sent status (not Paid)
• The credit note and invoice amounts match exactly (partial offsets are not supported)

Custom field setup

• If you installed the Xero Add-on before August 2025, you must either:

  • Uninstall and reinstall the Add-on, or

    Manually create the following invoice custom fields:

    1. Credit Note Type

    • Title: Credit Note Type
    • Code: creditNotetype
    • Type: Dropdown (Text)
    • Choices: Refund , Offset/Write-off
  • 2. Linked Invoice / Credit Note ID
    • Title: Linked Invoice / Credit Note ID
    • Code: linkedInvoiceCreditNoteId
    • Type: Text
    • Help Text: If the credit note is created to offset an invoice, enter the corresponding invoice or credit note ID here.
• If you installed the Xero Add-on after August 2025, these custom fields are created for you automatically.

Manual payment method

All users must create the following manual payment method in Storeganise:

• Name: Credit Note Offset
• Code: credit_note_offset

This method exists only to trigger the Xero allocation workflow—it does not represent an actual bank transaction.

Getting Started

Step 1: Set up the credit note

If a "Credit note type" is not set, the Add-on will automatically assign the Credit note as a "Refund". This will not be shown on the invoice in Storeganise, but will be considered a refund in Xero.

1. Create a credit note in Storeganise with a negative amount (e.g. -$100)
2. Make sure the line items and account codes exactly match the original invoice
3. Set Credit Note Type to Offset/Write-off
4. In Linked Invoice/Credit Note ID, enter the original invoice ID
5. Mark the payment using the Credit Note Offset method
6. This action triggers the sync to Xero

Step 2: Update the original invoice

1. Open the original invoice in Storeganise
2. Set Credit Note Type to Offset/Write-off
3. In Linked Invoice/Credit Note ID, enter the credit note ID

What happens in Xero

• The Add-on uses Xero’s Allocation API to apply the credit note directly to the invoice
• The invoice status updates to Paid
• The credit note is applied automatically, so no open balance remains

Validations and error handling

If there’s an issue, Storeganise creates a task on the invoice with instructions to fix it. Examples include:

• Missing Credit Note Type
• Missing linked invoice or credit note ID
• Mismatched amounts

These are blocking issues.

Limitations

• Partial credit notes are not supported
• Automatic payments (e.g. Stripe, Cybersource) are not compatible
• Works only on invoices in Sent status
• Feature is available for Xero integrations only

Need help?

Contact support@storeganise.com if you need assistance setting up or using this feature.