Clover integration

Connect Clover and ShelfCount learns what you sell, the same way it does with Square: map each menu item to a recipe once, and every sale gets costed automatically.

What it does

• Catalog sync — pulls your Clover items, modifier groups, and modifiers so you can map them, the same as we do with a Square catalog.
• Sales sync — pulls orders from Clover on a regular cycle (roughly every 15 minutes), plus webhooks that nudge a sync sooner when something changes.
• Costed sales & COGS — once a menu item is mapped to a recipe, every sale of it feeds your food cost reports: theoretical usage and cost, held up against what your counts say you actually used.

Connecting with a dashboard API token

Log in to your Clover dashboard and look under Account & Setup for an API Tokens section (some plans list it under Setup instead). Create a new token there and copy it — Clover only shows it once.

Your merchant ID is on the same Account & Setup page, under your business information. Enter both the token and the merchant ID on the Clover page in ShelfCount, and we’ll verify them against your Clover account before marking the merchant connected.

If you run more than one Clover merchant, each one gets its own token and can be connected separately.

One-click connect (coming soon)

Once Clover approves our app listing, you’ll be able to connect by clicking a button and signing in to Clover directly, without copying a token by hand. We’ll turn this on the moment approval comes through; the API token method above keeps working after that, too.

Choosing your region

Clover merchants are hosted in different regions — US, EU, and Latin America each have their own API host, and there’s a separate sandbox for testing. Pick the region that matches where your Clover account was set up; the wrong region will fail to verify.

Mapping menu items to recipes

Once connected, mapping works just like it does for Square: each Clover item points at a recipe (or directly at an item, for simple retail products). Unmapped items sync but can’t be costed until you map them, and a running to-do keeps track of what’s left. Modifiers can carry their own ingredient effects too, the same as Square modifiers — so an oat milk swap or an extra shot shows up in the cost, not just the price.

Questions

If you’re not sure where to find your API token or merchant ID, or you have questions about switching from another POS, email hello@insidermanagement.net.