Documentation Index

Fetch the complete documentation index at: https://help.mathership.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Integrations

Connect Bestellfix 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

​

Available integrations

​

Access integrations

To manage integrations:

1. Go to Manage → Integrations
2. Select the integration you want to configure
3. Connect or update the external system
4. Sync locations, stores, products, or items
5. Set up the required mappings
6. Activate the integration when everything is ready

​

How integrations work

Most POS integrations follow the same basic structure:

1. Connect the system
   • OAuth connection for Lightspeed
   • Username and password connection for Sides
   • CSV configuration for manual imports
2. Sync external data
   • Locations or stores
   • POS items or products
   • Product information needed for mapping
3. Link storage units
   • Each active POS location or store needs a Bestellfix storage unit
   • This defines where inventory should be deducted from
4. Map POS items
   • POS items can be mapped to ingredients
   • POS items can also be mapped to recipes
   • Recipe mappings are exploded into ingredient movements
5. Transfer sales
   • Sales data creates inventory issues
   • Historical migrations can process past sales
   • Manual transfers can be triggered for a specific date

​

Direct POS integrations

​

Lightspeed K-Series

Lightspeed uses an OAuth connection. After connecting Lightspeed, you can:

• Sync Lightspeed locations
• Link each location to a Bestellfix 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 Bestellfix 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

Example: 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 Bestellfix where inventory should be deducted from. Example: Without a linked storage unit, activation and transfers may fail.

​

Historical migration

Some integrations can process historical sales data. This is useful when:

• You activate a new POS location
• 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 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

The transfer creates inventory ledger entries based on mapped POS sales.

​

Automatic transfer

Some integrations support automatic sales transfers. Depending on the integration setup, automatic transfers can be:

• Active
• Paused
• Resumed later

Use pause if you want to stop automatic inventory deductions temporarily without deleting the integration.

​

Common setup workflow

1. Connect the POS integration
2. Sync locations or stores
3. Link locations or stores to storage units
4. Sync POS products or items
5. Create POS mappings
6. Activate the location or store
7. Review migration status
8. Check the inventory ledger
9. Run manual transfers if needed

​

Best practices

• Set up storage units before activating POS locations
• Sync products or items before creating mappings
• Start with the most important POS items first
• Map high-volume products carefully
• Review unmapped items after the first transfer
• Check the inventory ledger after activation
• Rerun migration only when needed
• Keep product and recipe names clear

​

Troubleshooting

​

Integration cannot be connected

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

​

Location or store cannot be activated

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

​

Products or items are missing

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.

​

Sales do not affect inventory

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

​

Inventory numbers look wrong

Check:

• POS mappings
• Quantity factors
• Recipe ingredients
• Storage unit assignment
• Inventory ledger entries for the affected date

​

Related pages