Skip to main content
Xero Invoicing is an alternative invoicing flow in which Alguna still computes every invoice — subscriptions, usage, credits, tax — but the invoice document is created and sent from Xero, and payment is collected there. Use it when your customers already receive and pay Xero invoices and you want to keep that while moving pricing, subscriptions and metering to Alguna. If Alguna should send the invoices and Xero should only record them in the ledger, use the accounting sync instead — see Xero. Which flow applies is set in Invoicing configuration; invoice statuses and the objects involved are in How Alguna works.

​
Connecting Xero

To connect your Xero account to Alguna, follow these steps:
  1. Go to Settings → Connections → Integrations in Alguna.
  2. Click Connect on the tile with Xero.
  3. Choose the Xero organization you wish to connect to Alguna.
    • If you’re testing in the sandbox environment, we recommend connecting to a Xero Demo Company.
      • Tip: The Xero Demo Company automatically disconnects every 30 days.
  4. Authorize the connection between Xero and Alguna.
  5. Set Alguna as your source of truth for customer and invoice creation.
  6. Optionally, import existing customers from Xero into Alguna (this can be done at a later date as well).
  7. Set up your accounting ledger and payment accounts for proper ledger entry mapping.

​
Sending Invoices

When the default invoicing flow for customers is set to Xero, all invoices approved for customer issuing are created in Xero. Then, depending on your settings, they will be sent for payment collection. You can set this process up in Alguna if you want invoices to be automatically released or if you want to review them manually first.
You can find how to set these preferences here.

​
Automatic Payment Reconciliation

If payments are collected through Xero, the reconciliation is automatically synced to Alguna. This means that the original payment source and the payment record are matched in both systems, keeping your invoicing reconciliation accurate in both systems. The Alguna invoice moves to paid, and the invoice.paid webhook fires as it would for an Alguna-collected payment.