Skip to main content

​
Integrations

Connect Mathership with external systems to reduce manual work and keep inventory data up to date. Integrations are mainly used to:
  • Connect POS systems
  • Sync locations, stores, products, or items
  • Map POS sales to ingredients or recipes
  • Transfer sales into inventory movements
  • Import POS sales data by CSV when no direct integration is available

Connect POS systems

Connect supported POS systems such as Lightspeed K-Series and Sides POS.

Map sales to inventory

Link POS items or products to Mathership ingredients and recipes.

Create ledger movements

Turn mapped POS sales into inventory deductions in the ledger.

​
Available integrations

Lightspeed K-Series

Connect Lightspeed, sync locations and items, and transfer POS sales into inventory.

Sides POS

Connect Sides, sync stores and products, and process daily sales reports.

CSV Upload

Upload POS sales data manually from a configured CSV file.

POS Mapping

Map POS items to ingredients or recipes so sales can update inventory.

Storage Units

Manage the storage units used for POS sales transfers and inventory movements.

Ledger

Review inventory movements created by orders, transfers, waste, counts, and POS integrations.

​
Access integrations

To manage integrations:
1

Open Manage

Go to Manage in the Mathership dashboard.
2

Open Integrations

Select Integrations.
3

Choose an integration

Select the integration you want to configure, such as Lightspeed K-Series, Sides POS, or CSV Upload.
4

Connect or update the system

Connect the external system, update credentials, or configure CSV import settings.
5

Sync external data

Sync locations, stores, products, or items depending on the integration.
6

Set up mappings

Link POS items or products to Mathership ingredients or recipes.
7

Activate when ready

Activate the integration, location, or store only after storage units and mappings are ready.

​
How integrations work

Most POS integrations follow the same basic structure.
1

Connect the system

Lightspeed uses OAuth. Sides uses username and password credentials. CSV Upload uses a configured CSV import.
2

Sync external data

Sync locations, stores, POS items, products, or other data needed for mapping.
3

Link storage units

Each active POS location or store needs a Mathership storage unit. This defines where inventory should be deducted from.
4

Map POS items

POS items and products can be mapped to ingredients or recipes. Recipe mappings are expanded into ingredient movements.
5

Transfer sales

Sales data creates inventory issue movements. Historical migrations can process past sales, and manual transfers can be triggered for specific dates.

​
Direct POS integrations

​
Lightspeed K-Series

Lightspeed uses an OAuth connection. After connecting Lightspeed, you can:
  • Sync Lightspeed locations
  • Link each location to a Mathership storage unit
  • Activate locations
  • Start a historical migration
  • Sync Lightspeed items
  • Map items to ingredients or recipes
  • Run manual transfers for specific dates
  • Pause or resume automatic transfers
See Lightspeed K-Series for setup details.

​
Sides POS

Sides uses username and password credentials. After connecting Sides, you can:
  • Test the connection
  • Sync stores
  • Link each store to a Mathership storage unit
  • Activate stores
  • Start a historical migration
  • Sync products
  • Map products to ingredients or recipes
  • Run manual transfers for specific dates
  • Pause or resume automatic transfers
See Sides POS for setup details.

​
CSV Upload

CSV Upload is used when sales data is imported manually instead of through a live POS connection. Use CSV Upload to:
  • Upload POS sales data from a file
  • Process sales from systems without a direct integration
  • Apply configured CSV rules
  • Create inventory deductions based on mapped POS codes
CSV Upload requires correct POS mappings before sales can be processed. See CSV Upload for setup details.

​
POS mapping

POS mapping defines how sales affect inventory. A POS item can be mapped to:
  • Ingredient — the ingredient is deducted directly
  • Recipe — the recipe is broken down into its ingredients
  • Quantity factor — defines how much inventory is affected per sale
POS itemMapped toResult
CheeseburgerRecipeDeducts all recipe ingredients
EspressoIngredientDeducts coffee directly
Bottle ColaIngredientDeducts one bottle from stock
See POS Mapping for details.

​
Storage unit mapping

Before a POS location or store can be activated, it must be linked to a storage unit. This tells Mathership where inventory should be deducted from.
External systemExternal locationMathership storage unit
LightspeedMain RestaurantMain Storage
LightspeedBarBar Storage
SidesDowntown StoreKitchen Storage
Without a linked storage unit, activation and transfers may fail.
Always check the linked storage unit before activating a location or store. A wrong storage unit can create inventory movements in the wrong place.

​
Historical migration

Some integrations can process historical sales data. This is useful when:
  • You activate a new POS location or store
  • You want to import recent sales history
  • You added mappings after the integration was created
  • You need to rerun a migration after fixing mappings
For Lightspeed and Sides, activation can start a historical migration for the last 90 completed days.

​
Manual transfer

Manual transfers let you process sales for a specific date. Use this when:
  • You want to transfer one day manually
  • A previous transfer failed
  • You updated mappings and want to reprocess sales
  • You need to check one specific business day
  • You want to test an integration before relying on automatic processing
The transfer creates inventory ledger entries based on mapped POS sales.
Manual transfers are useful for testing because you can check the resulting ledger movements before enabling automatic transfers.

​
Automatic transfer

Some integrations support automatic sales transfers. Depending on the integration setup, automatic transfers can be:
StateMeaning
ActiveSales are processed automatically
PausedAutomatic processing is stopped, but setup and history are kept
ResumedAutomatic processing can be enabled again later
Use pause if you want to stop automatic inventory deductions temporarily without deleting the integration.

​
Common setup workflow

1

Connect the POS integration

Connect Lightspeed, Sides, or configure CSV Upload.
2

Sync locations or stores

Import external locations or stores.
3

Link storage units

Assign each location or store to the correct Mathership storage unit.
4

Sync POS products or items

Import the products or items that need to be mapped.
5

Create POS mappings

Map high-priority POS products or items to ingredients or recipes.
6

Activate the location or store

Activate only after storage units and key mappings are ready.
7

Review migration status

Check whether the historical migration started and completed correctly.
8

Check the ledger

Review created inventory movements.
9

Run manual transfers if needed

Use manual transfers to test or reprocess specific dates.

​
Best practices

Set up storage units first

Create and check storage units before activating POS locations or stores.

Sync before mapping

Sync products or items before creating mappings.

Start with important items

Start with high-volume POS items and products first.

Map carefully

Check ingredient, recipe, and quantity factor before saving mappings.

Review unmapped items

Use unmapped items after the first transfer as a working list.

Check the ledger

Review ledger movements after activation and after major mapping changes.

Rerun only when needed

Rerun migrations only after correcting mappings or setup issues.

Keep names clear

Keep product and recipe names clear so mappings are easier to maintain.

​
Troubleshooting

Check that:
  • Your credentials are correct
  • The external system is available
  • The integration is configured for the correct company
  • You have permission to manage the company
Check that:
  • The location or store was synced
  • A storage unit is linked
  • The storage unit belongs to the same company
  • No migration is already running
Try syncing products or items again.For Sides, products may be loaded from cache unless you manually sync them.For Lightspeed, use the item sync option to refresh cached items.
Check that:
  • POS items are mapped
  • The mapped ingredient or recipe belongs to the same company
  • The location or store is activated
  • A storage unit is linked
  • The transfer completed successfully
Check:
  • POS mappings
  • Quantity factors
  • Recipe ingredients
  • Storage unit assignment
  • Ledger entries for the affected date

Lightspeed K-Series

Connect Lightspeed and transfer POS sales into inventory.

Sides POS

Connect Sides and process daily sales reports.

CSV Upload

Upload POS sales data manually from CSV files.

POS Mapping

Map POS products to ingredients or recipes.

Storage Units

Set up the storage units used for inventory transfers.

Ledger

Review inventory movements created by integrations.
Last modified on June 7, 2026