Xero Integration

Overview

The Xero integration pushes every sale, tax, service charge, loyalty movement, store-credit movement, and payment from Rewardly into your Xero accounting books — keeping your point-of-sale and ledger in sync without manual entry.

You map Rewardly's account categories and payment methods to your Xero accounts per outlet. Once connected, each outlet's sales flow into the right Xero accounts automatically.

How it works

The mapping is done in Outlets → Edit outlet → XERO tab. Two groups of mappings are required:

• Base Accounts — the income / liability buckets used for the sale itself (sales, tax, service charge, cash float, loyalty liability, store-credit liability, etc.).
• Payment Methods — one Xero account per payment method enabled on this outlet, so that each payment hits the matching bank/clearing account.

Each Rewardly value picks an account from a dropdown of the Xero accounts on your connected Xero organisation.

Default setup

Bean & Brew example: connect the Main outlet to Xero and map the required accounts.

1. Outlets → click the Edit icon on your outlet.

2. Open the XERO tab.

3. Pick the Tax Type that matches how your Xero file is configured.

4. Map every Base Account to the right Xero account:

   Type	Typical Xero account
   Sales Account	Your main sales income account.
   Tax Account	Tax payable / GST collected.
   Service Charge Account	Service-charge revenue.
   Cash Account	Cash on hand / till.
   Loyalty Account	Loyalty liability (unredeemed points).
   Store Credit Account	Store-credit liability (unredeemed credit).
   Grab Account	Grab/Foodpanda receivable (if used).

5. Map every Payment Method to the right Xero account — one row per active payment method (Cash, PayNow, Credit Card, Fiuu, etc.).

6. Click UPDATE XERO SETTINGS to push the mapping.

7. Save the outlet record.

Set Tax Type first

The Tax Type at the top of the panel determines which Xero tax rates show up on each sale line — set it before mapping the Sales / Tax accounts.

Advanced

Disconnecting

The DISCONNECT button at the bottom of the Xero panel unlinks the integration for that outlet. Sales stop pushing to Xero until you reconnect.

Per-outlet mapping

Each outlet has its own Xero mapping. If you operate multiple outlets, repeat the mapping for each — for example, every outlet's cash might point to a different Xero account per location.

Loyalty & store-credit accounting

The Loyalty Account and Store Credit Account are intentionally liability accounts: each issuance increases the liability, and each redemption decreases it. That keeps your books honest about how much unredeemed value your customers are holding.

Related

• Outlet Settings — the outlet edit screen that holds the Xero tab.
• Payment Methods — every method here must be mapped on the Xero tab.
• Payment Reports — the same totals Xero is reconciling against.