What syncs, and how often
What syncs
Section titled “What syncs”| Record | Direction |
|---|---|
| Items | Both ways |
| Item variants | Both ways |
| Categories | Both ways |
| Customers | Both ways |
| Stock levels (inventory) | Both ways |
| Sales & receipts | Loyverse → Swann Retail |
Sales and receipts sync one way — Loyverse into Swann Retail. Every sale rung in Loyverse comes across as a completed order (a refund as a return), dated when it was rung; sales you ring in Swann Retail are not sent back to Loyverse. Employees aren’t synced. Your tax rates are brought across at the first import (so each item keeps its Loyverse rate) and keep syncing one way after that — a rate you add in Loyverse is adopted automatically, a rate you change there is flagged for you to review — but they aren’t part of the two-way sync: rate edits you make in Swann Retail aren’t pushed back.
How often
Section titled “How often”These timings apply while the ongoing sync is running. Incoming activity — Loyverse → Swann Retail — flows in both two-way sync and inbound only (the mode new connections start on). The Swann Retail → Loyverse direction below happens only in two-way sync: in inbound only your Swann Retail edits and deletions stay in Swann Retail and are never pushed back. If you’ve switched to import-only mode, the ongoing sync is off — see In import-only mode below.
Which directions are live depends on your sync mode:
| Sync mode | Incoming (Loyverse → Swann Retail) | Outgoing edits (Swann Retail → Loyverse) | Outgoing deletes (Swann Retail → Loyverse) |
|---|---|---|---|
| Two-way sync | Flows automatically | Pushed back to Loyverse | Pushed back to Loyverse |
| Inbound only | Flows automatically | Stays in Swann Retail | Stays in Swann Retail |
| Import only | On-demand import only | Stays in Swann Retail | Stays in Swann Retail |
- Changes from Loyverse → Swann Retail: picked up about every 2 minutes.
- Sales rung in Loyverse: carried into Swann Retail on that same ~2-minute pass — a Loyverse sale shows up here within a couple of minutes, as a completed order dated when it was rung. (One-way — sales you ring in Swann Retail aren’t sent back.)
- Changes from Swann Retail → Loyverse (two-way sync only): sent within seconds of you saving.
- A full check runs hourly. This catches deletions and category changes that the quick updates can miss, and reconciles anything else that drifted.
Deletions and category changes are handled by the hourly check, and the timing depends on the direction:
- A deletion made in Loyverse disappears from Swann Retail within about an hour — on the next hourly check.
- A deletion made in Swann Retail (two-way sync only) takes up to about three hours to disappear from Loyverse. This is a safety delay: Swann Retail waits for the item to stay gone across three hourly checks before removing it from Loyverse, so a brief glitch can’t wipe out your Loyverse catalog. In inbound only, a deletion you make in Swann Retail is never pushed to Loyverse — it stays in Swann Retail, like your other edits.
- Creating or renaming a category in Loyverse also takes up to an hour to appear here — Loyverse doesn’t timestamp category edits, so they ride the hourly check. The same change made in Swann Retail is pushed to Loyverse within seconds, like other catalog edits (two-way sync only).
Everyday item edits — prices, names, stock — flow through on the faster schedule above.
Deleted customers are the exception. In two-way sync, a customer you delete in Swann Retail is removed from Loyverse, but a customer deleted in Loyverse stays in Swann Retail — Loyverse doesn’t report when a customer is deleted, so Swann Retail can’t detect it on its own; remove the customer in Swann Retail yourself to match. In inbound only, a customer you delete in Swann Retail also stays in Swann Retail and isn’t pushed back.
In import-only mode
Section titled “In import-only mode”In import-only mode, Swann Retail is your main system and the ongoing sync is off: changes don’t flow either way on their own — including new Loyverse sales — and the hourly check doesn’t run. The everyday and hourly timings above don’t apply. What’s left is the on-demand import — you pull your catalog, customers and past sales across from Loyverse when you choose (see Importing your data). The speed note below still applies to that import.
Stock levels
Section titled “Stock levels”When stock moves in Loyverse, only that change is applied in Swann Retail — your count isn’t overwritten with a fixed number. So counts stay aligned even as sales happen in both places during a side-by-side run.
A note on speed
Section titled “A note on speed”Loyverse limits how fast any app can talk to it, so Swann Retail paces its requests (roughly one per second). During the first import or a very large change, updates are processed steadily rather than all at once — this is normal and nothing is lost.