Loyverse sync overview

Swann Retail can keep a two-way sync with your Loyverse account. It’s built for a smooth move: you keep selling in Loyverse while your catalog and customers come across, and changes flow both ways until you’re ready to switch over fully.

Three ways to run

Swann Retail runs with Loyverse in one of three modes:

• Two-way sync — changes flow both ways: Loyverse activity comes in, and your Swann Retail edits go back.
• Inbound only — the mode new connections start on. Loyverse activity keeps flowing in (live sales, receipts, catalog changes), but your Swann Retail edits no longer go back to Loyverse.
• Import only — Swann Retail is your main system; the ongoing sync stops entirely, but you can still import from Loyverse on demand. Switch to this when you’re ready to go fully live.

See Sync mode — two-way, inbound only & import only for how to switch and exactly what changes.

What stays in sync

These records sync both ways — a change on either side is carried to the other:

• Items and their variants (name, price, SKU, category)
• Categories
• Customers
• Stock levels (inventory)

Your sales go both ways

While you’re on two-way sync, every sale you ring in Loyverse flows into Swann Retail on its own — usually within a couple of minutes. Each Loyverse receipt lands as a completed order dated when it was actually rung (a refund comes across as a return), so your Swann Retail reports and customer history show all your sales, from both tills, on the right day.

And it goes the other way too. On two-way sync, a sale you ring in Swann Retail is sent to Loyverse as a receipt once it’s settled — carrying the money you actually took, dated the day you took it. In inbound only and import only, your Swann Retail sales stay in Swann Retail. For exactly when a sale is sent, how deposits and split payments land, and why refunds are not sent back, see Your Swann Retail sales going to Loyverse.

⚠️ So each sale still belongs in exactly one till. Don’t re-enter a Loyverse sale in Swann Retail, and don’t re-key a Swann Retail sale into Loyverse — in two-way sync the sync does that for you, and a hand-entered copy is counted twice. Your older Loyverse sales, from before you connected, come across separately as a one-time load — see Importing past sales.

What doesn’t sync

• Refunds and returns back to Loyverse. A settled sale is sent (above), but a refund you give in Swann Retail isn’t — it’s recorded here and reduces your Swann Retail figures, while the original Loyverse receipt is left as it was.
• Employees aren’t synced — Swann Retail checks your Loyverse account and store when you connect, but never brings across or pushes back employees.
• Tax rates back to Loyverse. Your rates come across at the first import (each item keeps its Loyverse rate), and Loyverse’s own later changes still flow one way into Swann Retail — a new rate you add in Loyverse is adopted automatically, and a changed rate is flagged for you to review rather than applied silently (see Conflicts & errors). What doesn’t go back is the other direction: rate edits you make in Swann Retail are never pushed to Loyverse — you manage your rates here from then on.

In inbound only, even more stays put: on top of the above, your own catalog edits and deletions — and your settled sales — also stay in Swann Retail and aren’t sent to Loyverse; only incoming Loyverse activity keeps flowing.

What to expect

• Changes you make in Loyverse appear in Swann Retail within a couple of minutes; changes you make in Swann Retail are sent to Loyverse within seconds. See What syncs, and how often for the detail.
• Swann Retail never silently overwrites your data. If a record can’t be synced cleanly — because it was edited on both sides, or it uses a Loyverse feature Swann Retail doesn’t model — it’s recorded for you to review. See Conflicts & errors.
• Connecting and managing the sync is owner-only.

Next steps

1. Connect your Loyverse account.
2. Map your stores to locations so synced data lands in the right place — nothing syncs until at least one store is mapped.
3. Let the one-time import bring your catalog across.
4. Keep an eye on conflicts and resolve anything that needs you.
5. When Swann Retail is your main system, switch to import-only.