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.

​

Sides POS Integration

Connect Bestellfix with Sides POS to transfer sales into your inventory. The integration can:

• Connect to your Sides account
• Sync Sides stores
• Link stores to Bestellfix storage units
• Sync Sides products
• Map products to ingredients or recipes
• Process daily sales reports
• Create inventory deductions automatically

​

How it works

Sides sales are imported into Bestellfix and converted into inventory movements. The basic flow is:

1. Connect your Sides account
2. Sync stores
3. Link each store to a storage unit
4. Sync products
5. Map products to ingredients or recipes
6. Activate the store
7. Process sales into inventory

​

Before you start

Make sure you already have:

• A Sides account
• Valid Sides login credentials
• At least one Bestellfix storage unit
• Ingredients or recipes created in Bestellfix
• Permission to manage the selected company

​

Create a Sides integration

1. Go to Manage → Integrations
2. Select Sides POS
3. Enter your Sides username and password
4. Save the integration

Bestellfix tests the Sides connection before saving it. If the credentials are invalid, the integration is not created.

​

Test the connection

After creating the integration, use Test connection to confirm that Bestellfix can still reach Sides. A successful test confirms that:

• Credentials are stored
• The Sides API is reachable
• Bestellfix can authenticate with Sides

If the test fails, update the Sides credentials and try again.

​

Sync stores

Sides stores are the POS locations connected to your Sides account. To load them into Bestellfix:

1. Open the Sides integration
2. Click Sync stores
3. Review the imported stores

Bestellfix stores the synced list and normally uses cached stores for up to one week. Use Sync stores again to force a fresh update from Sides.

​

Link stores to storage units

Each Sides store must be linked to a Bestellfix storage unit before it can be activated. This tells Bestellfix where inventory should be deducted. Example: To link a store:

1. Open the Sides store
2. Select a Bestellfix storage unit
3. Save the assignment

You can also remove the storage unit assignment later.

​

Activate a store

After linking a storage unit, activate the store. Activation:

• Marks the store as active
• Starts a historical migration
• Processes sales history for the last 90 days

A store cannot be activated without a linked storage unit.

​

Migration status

After activation, Bestellfix starts a migration job. Use the migration status view to check:

• Whether the migration is pending
• Whether it is running
• Whether it completed
• Whether it failed or was cancelled

​

Cancel a migration

You can cancel a running or pending migration. Use this if:

• The wrong storage unit was linked
• Product mappings are not ready
• The migration was started by mistake

Cancelling stops the active migration job.

​

Rerun a migration

You can rerun a migration after a store has been activated. Use this when:

• You added new mappings
• You corrected product mappings
• A previous migration missed items
• You want to process the 90-day period again

A migration cannot be rerun while another migration is already pending or running.

​

Sync products

Sides products are synced at integration level. To load products:

1. Open the Sides integration
2. Click Sync products
3. Review the imported products

Bestellfix can cache products and reuse the cached list. Use Sync products to force a fresh product update from Sides. Synced product data can include:

• Product name
• Article ID
• Article number
• Product type
• Kitchen name
• Description
• Price information
• Menu or sales article flags

​

Product types

Bestellfix classifies Sides products based on Sides data. Common types are: The type helps identify how the product should be mapped.

​

Map Sides products

A Sides product must be mapped before it can affect inventory. You can map a product to:

• An ingredient
• A recipe

​

Ingredient mapping

Use ingredient mapping when the sold POS item should deduct one ingredient directly. Example:

​

Recipe mapping

Use recipe mapping when the sold POS item consists of several ingredients. Example: When the product is sold, Bestellfix deducts the recipe ingredients from inventory.

​

Mapping quantity

The quantity controls how much inventory is affected per sold POS item. Examples: Use this carefully. Incorrect quantities will create wrong inventory deductions.

​

Subtraction setting

The mapping can include an is_subtraction setting. In normal cases, mapped POS sales reduce inventory. Use special subtraction settings only when the mapping should behave differently for a specific POS item or correction case.

​

Manual product management

Bestellfix can also create, update, or delete Sides products manually inside the integration context. This is useful when:

• A product is missing from the sync
• A temporary product needs to be mapped
• A product should be corrected manually

Deleting a Sides product in Bestellfix is a soft delete. If the product has a mapping, the mapping is removed as well.

​

Manual sales transfer

You can manually process a Sides sales day. Use this when:

• You want to process a specific date
• You fixed mappings and want to retry
• A previous transfer failed
• You want to test the integration

The date must use this format: DD-MM-YYYY Example: 20-10-2025 Manual transfer always fetches fresh Sides data and recreates the relevant inventory entries for that store and date.

​

What happens during transfer

When a transfer runs, Bestellfix:

1. Fetches the Sides daily report
2. Reads the orders and bill positions
3. Matches sold products to POS mappings
4. Explodes recipe mappings into ingredients
5. Creates inventory ledger entries
6. Returns a summary of processed and skipped items

​

Transfer results

A successful transfer can show:

• Processed bill positions
• Skipped bill positions
• Created inventory deductions
• Used recipes
• Exceptions
• Transfer log ID

If Sides returns no data for the date, Bestellfix returns a warning instead of creating inventory movements.

​

Automatic transfer

For active stores, automatic transfer can be paused or resumed. Use this when you want to temporarily stop automatic inventory deductions without removing the integration.

​

Review inventory movements

After a transfer, review the movements in the inventory ledger. The ledger can show:

• Deducted ingredient
• Quantity
• Storage unit
• Date
• Related Sides bill positions
• Current balance after the movement

See Inventory Ledger for details.

​

Recommended setup order

Follow this order for a clean setup:

1. Create storage units
2. Create ingredients and recipes
3. Create the Sides integration
4. Test the connection
5. Sync stores
6. Link stores to storage units
7. Sync products
8. Map important products
9. Activate the store
10. Check migration status
11. Review inventory ledger entries

​

Common issues

​

Connection failed

Check that:

• The username is correct
• The password is correct
• The Sides account is active
• The Sides API is reachable

Then update the credentials and test again.

​

No stores appear

Try Sync stores again. If stores still do not appear, check that the Sides account has access to stores.

​

Store cannot be activated

Check that:

• The store exists
• A storage unit is linked
• The storage unit belongs to the same company
• No permission error exists

​

Products do not appear

Try Sync products again. If products still do not appear, check that:

• At least one store exists
• The store has a valid UUID
• The Sides credentials are still valid

​

Sales do not affect inventory

Check that:

• The store is activated
• The store has a storage unit
• Products are mapped
• Recipes contain ingredients
• The transfer completed successfully

​

Wrong inventory deduction

Check:

• Mapping quantity
• Ingredient unit
• Recipe lines
• Storage unit assignment
• Whether the product is mapped to the correct ingredient or recipe

​

Migration already running

Only one migration can run for a store at a time. Wait until the current migration finishes, or cancel it before starting another one.

​

Best practices

• Create storage units before connecting Sides
• Sync stores before syncing products
• Map high-volume products first
• Use recipes for prepared menu items
• Use ingredient mappings for simple one-to-one products
• Check the inventory ledger after the first transfer
• Keep mappings updated when the menu changes
• Rerun migration after important mapping corrections

​

Related pages