Getting started

Xaldro posts your Webflow Ecommerce orders to Xero or QuickBooks Online as invoices, with a line per product, shipping, discount and the tax the customer paid.

Before an invoice counts as done, Xaldro reads it back from your ledger. If its total or tax differs from what the customer paid by more than 1 cent, Xaldro voids the invoice it just created and holds the order with the reason.

1. Connect Webflow

Open https://app.xaldro.com/auth/webflow/install, or press Get started on xaldro.com. Webflow asks you to approve read access and to choose the sites Xaldro may see. Then pick the sites to connect in Xaldro.

For each site you connect, Xaldro adds its two order webhooks and imports the orders from the last 90 days. See What Xaldro changes in your Webflow site below.

2. Connect Xero or QuickBooks

The account owner connects the ledger orders should post to. You can connect both Xero and QuickBooks on Growth and up; every order then posts to each.

• Starter plan: one accounting system (Xero or QuickBooks).
• Growth and up: both.

See Connecting Xero & QuickBooks.

3. Map your accounts

Tell Xaldro which accounts orders post against: a revenue account (required), and optionally a shipping account, a clearing / bank account and a tax rate. You do this in Settings. See Mapping your accounts and Tax & VAT.

The first time you save a mapping for a ledger, Xaldro imports the last 90 days again, so orders that arrived before the mapping reach that ledger too.

4. Orders post

From now on each new order and refund posts when Webflow's webhook reaches Xaldro. Watch them on the Overview and Orders screens; each posted order links to its invoice in Xero or QuickBooks.

If an order cannot be posted as Webflow recorded it, Xaldro does not guess. The order is held with a message that says what to change. See Hold reasons.

What Xaldro changes in your Webflow site, and what you do yourself

What Xaldro writes to Webflow

• Only its own two order webhooks per connected site: ecomm_new_order and ecomm_order_changed. They tell Xaldro when an order is placed or changes.
• Nothing else: no products, SKUs, CMS items, collections, fields, pages or scripts, so nothing Xaldro adds counts toward your Webflow plan's limits on items, products or pages.
• A check every hour adds either webhook back on a connected site if it is missing, then imports the orders placed meanwhile. It never adds anything else.
• A shop with no orders yet connects normally and shows No orders yet. If Webflow does not accept the order webhooks yet (it can answer "Ecommerce is not yet initialized" for a shop without orders), Xaldro tries again every hour and, once they are added, imports the orders placed meanwhile.
• Pausing or removing a site, or deleting your Xaldro account, removes that site's webhooks. If Webflow does not confirm a removal, Xaldro tells you; for a removed site it retries every hour for 7 days.
• An account without an active plan for 14 days has its webhooks removed until it subscribes again. See Billing & plans.
• Webflow accepts the same webhook twice, so the hourly check also deletes extra copies, and connecting, resuming, Re-sync or approving Xaldro again in Webflow deletes Xaldro's webhooks on the site and creates them anew.
• Xaldro never changes your store, products, orders, customers, pages, CMS, assets, settings or custom code, and it publishes nothing. It asks Webflow for read permissions only: authorized_user:read, sites:read and ecommerce:read.
• There is nothing to paste into your site.

What you do yourself

• Connect a ledger: Xero or QuickBooks Online.
• Map the accounts and tax codes orders post against.
• Choose which Webflow sites to connect.
• Fix the cause of a held order and press Retry (see Hold reasons).

What is not covered

• Currencies without two decimal places (zero-decimal ones such as JPY, three-decimal ones such as KWD) are held, not posted. See Currencies.
• Orders edited in Webflow after posting are flagged for review only when their total changes. The posted invoice is never changed.
• Orders without a customer email post to one shared contact, no-email@xaldro.invalid. See Customers & contacts.
• Refunds are whole-order, as Webflow refunds them. Disputes and chargebacks are not posted. See Refunds & edited orders.
• Xaldro does not file tax returns or record payment processor fees.

Plan limits

Plan	Orders / month	Sites	Accounting systems	Seats
Starter	100	1	1	1
Growth	500	2	2	3
Pro	Unlimited	5	2	10
Agency	Unlimited	Unlimited	2	25

An order over your monthly limit is held until you upgrade or the month ends. Your Webflow site plan and its Ecommerce limits are Webflow's and still apply; Xaldro does not change them. See Billing & plans.

What stays after you uninstall

Xaldro's only objects in your Webflow site are its two order webhooks per site. Before you uninstall, remove your sites or delete your account in Xaldro: Xaldro then removes its two order webhooks from each site while it still has access. If you uninstalled first, the webhooks may stay listed, marked disabled: delete them in Webflow under Site settings → Apps & Integrations → Webhooks. A leftover webhook only sends order notices that Xaldro ignores. The invoices, credit notes, contacts, items and payments Xaldro posted stay in Xero or QuickBooks, because they are your records; you remove them in your ledger if you want them gone. Xaldro deletes its own copy of your data 30 days after Webflow access ends, or at once if you use Account → Delete account. Uninstalling does not cancel your subscription. See Uninstalling & your data.

Next steps

• How syncing works: the read-back check and what happens on a mismatch.
• Refunds & edited orders.
• Sync rules: control which orders post.
• Importing past orders: pull more history.