Skip to main content

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.

Reports

Reports help you analyze purchasing, inventory, products, customers, delivery locations, and order activity. Bestellfix uses your order data, inventory movements, product data, delivery locations, and filters to create structured reports.

What Reports Do

With reports, you can:
  • Review inventory stock and movements
  • Analyze COGS and inventory value
  • View customer and client reports
  • View vendor order reports
  • View product reports
  • Create delivery location reports
  • Export report data as CSV
  • Export selected reports as PDF
  • Save report configurations
  • Create background export jobs
  • Download completed export files

Report Types

Bestellfix supports several report areas.
ReportPurpose
Inventory reportAnalyze stock, movements, costs, recipes, and activity
On-hand reportShow current stock by ingredient and storage unit
COGS reportCalculate cost of goods sold from issue movements
Client reportShow vendor customers and customer activity
Order reportShow vendor orders and order status
Product reportShow product data and ordering activity
Delivery location reportShow deliveries for one delivery location
Report exportsCreate downloadable report files

Inventory Report

The inventory report gives a general overview of ingredient stock, movements, costs, and recipe-related activity. It is not tied to one POS integration. The report can include:
FieldMeaning
IngredientIngredient included in the report
Storage unitStorage location
Current stockCurrent calculated on-hand quantity
MovementsInventory ledger entries
CostInventory value or movement value
RecipeRecipe-related usage
Transaction typeReceipt, issue, waste, transfer, or adjustment
ActivityWhether there was movement in the selected period

Inventory Report Filters

The inventory report can be filtered by:
FilterMeaning
CompanyCompany to report on
Date fromStart date
Date toEnd date
Ingredient IDsOne or more selected ingredients
Storage unit IDsOne or more storage locations
Recipe IDsOne or more recipes
Transaction typesReceipt, issue, waste, transfer, adjustment
Has activityShow only ingredients with activity
Current stock minimumShow stock above a minimum value
Current stock maximumShow stock below a maximum value
LimitLimit the number of returned rows
Date filters use the full day.
FilterTime used
Date from00:00:00
Date to23:59:59

On-Hand Report

The on-hand report shows current stock by ingredient and storage unit. It is calculated from inventory ledger quantities.
FieldMeaning
IngredientIngredient ID
Storage unitStorage unit ID
On handSum of all ledger quantities
You can filter by:
  • Company
  • Storage unit
  • Ingredient

COGS Report

The COGS report calculates cost of goods sold from inventory ISSUE movements. It uses the value of issue ledger entries in the selected date range.
FieldMeaning
CompanyCompany being analyzed
Date fromStart date
Date toEnd date
COGS valueSum of issue movement values
COGS is based on posted inventory issue movements. If POS sales or recipe deductions were not posted, they will not be included.

Client Report

The client report is mainly for vendors. It shows customer companies connected to the vendor. The report can include:
FieldMeaning
IDCustomer company ID
Customer numberVendor-specific customer number
Business nameCustomer company name
User emailCustomer user email
CityCustomer city
Total ordersNumber of orders from that customer
Created atCreation date

Order Report

The order report shows vendor order activity. It can include:
FieldMeaning
IDOrder ID
Order numberBestellnummer
Placed atDate and time the order was placed
StatusOrder status
Customer nameCustomer company
Vendor nameVendor company
Customer numberVendor-specific customer number
Items countNumber of order items
Status updated atLast status update
Archived orders are excluded.

Product Report

The product report shows product data and order activity. It can include:
FieldMeaning
IDProduct ID
Article numberVendor article number
Article nameProduct name
AvailabilityProduct availability
StockProduct stock
UnitProduct unit
PackagingPackaging information
Total orderedNumber of related order items
Created atProduct creation date

Delivery Location Report

The delivery location report shows all deliveries for one selected delivery location within a date range. It supports JSON, CSV, and PDF output. Required fields:
FieldMeaning
Delivery locationDelivery location to report on
Date fromStart date
Date toEnd date

Effective Delivery Date

The delivery location report uses an effective delivery date. Bestellfix checks dates in this order:
  1. Delivery date
  2. Estimated delivery date
  3. Placed at date
This means that if an actual delivery date exists, it is used first.

Delivery Location Report Fields

The delivery location report can include:
FieldMeaning
Delivery dateEffective delivery date
Article numberProduct article number
Article nameProduct name
QuantityReceived quantity if available, otherwise ordered quantity
UnitTop packaging level or product unit
Total priceQuantity multiplied by item price
Daily totalTotal value for one delivery date
Grand totalTotal value for the full report period

Received Quantity in Reports

If an order item has a received quantity, the delivery location report uses it. If no received quantity exists, the report uses the original ordered quantity.
SituationQuantity used
Item was receivedReceived quantity
Item was not receivedOrdered quantity

Product Exclusion from Partner Reports

Products can be excluded from partner reports. If a product is marked as excluded, it will not appear in the delivery location report. Use this for products that should not be shown in partner-facing delivery reports.

CSV Exports

Several reports can be downloaded as CSV. CSV exports are useful for:
  • Excel analysis
  • Accounting
  • Vendor reporting
  • Delivery checks
  • Internal controlling
  • Data backups
For German-language delivery location reports, CSV files use semicolon separators.

PDF Exports

Delivery location reports can also be exported as PDF. PDF reports are useful for:
  • Sharing with team members
  • Sending to partners
  • Printing
  • Archiving delivery summaries

Available Report Filters

Bestellfix can return available filters and columns for configurable reports. Supported configurable report areas include:
AreaTypical columns
ClientsCustomer number, business name, email, city, total orders
OrdersOrder number, placed at, status, customer, items count
ProductsArticle number, article name, availability, stock, unit
This helps build custom report views.

Saved Report Configurations

Report configurations allow users to save selected report settings. A configuration can include:
FieldMeaning
Report typeClients, orders, or products
FiltersSaved filter settings
ColumnsSelected columns
UserOwner of the configuration
Saved configurations can be opened again later to return the same report structure.

Report Configuration Data

When a saved report configuration is opened, Bestellfix rebuilds the report with:
  • The saved report type
  • The saved filters
  • The saved columns
  • The current available data
Saved report configurations store the report setup, not a frozen copy of old results.

Report Export Jobs

Report export jobs create downloadable files in the background. This is useful for larger reports or bundled exports. A report export job can include:
FieldMeaning
CompanyCompany the export belongs to
Report typeType of report to export
File formatExport format
Date fromStart date
Date toEnd date
StatusExport job status
File keyStored export file reference

Export Job Status

Export jobs can have different statuses.
StatusMeaning
PendingExport was created and is waiting
ProcessingExport is being generated
CompletedExport is ready for download
FailedExport could not be created

Downloading Export Files

Completed export jobs can be downloaded through a temporary download link. The download link is time-limited.
FieldMeaning
Download URLTemporary file link
Expires in secondsHow long the link remains valid
FilenameSuggested download filename
A report export can only be downloaded after the export job is completed and a file is available.

Common Workflows

Review Inventory Activity

  1. Open Reports
  2. Select Inventory Report
  3. Choose a date range
  4. Filter by ingredient or storage unit if needed
  5. Review stock, movement, and cost data

Check Current Stock

  1. Open the on-hand report
  2. Select the company
  3. Filter by storage unit if needed
  4. Review current stock by ingredient

Review COGS

  1. Open the COGS report
  2. Select the company
  3. Select the date range
  4. Review the COGS value

Create a Delivery Location Report

  1. Open Delivery Location Report
  2. Select the delivery location
  3. Select date from and date to
  4. Review the delivery summary
  5. Download CSV or PDF if needed

Export a Report

  1. Select the report type
  2. Choose the file format
  3. Select the date range
  4. Create the export job
  5. Wait until the job is completed
  6. Download the file

Save a Report Configuration

  1. Choose the report type
  2. Select filters
  3. Select columns
  4. Save the configuration
  5. Reopen it later when needed

Troubleshooting

Inventory Report Shows No Data

Check that:
  • The correct company is selected
  • The date range contains inventory movements
  • Ingredients exist
  • Storage units exist
  • Filters are not too restrictive
  • Inventory ledger entries exist

COGS Is Zero

Check that:
  • There are ISSUE movements in the selected period
  • POS sales or recipe deductions were processed
  • Weighted average costs exist
  • Receipt costs were posted before issues

Delivery Location Report Is Empty

Check that:
  • Delivery location is correct
  • Date range is correct
  • Orders exist for the delivery location
  • Orders are not archived
  • Products are not excluded from partner reports
  • Delivery date, estimated delivery date, or placed date falls inside the range

CSV Download Has Unexpected Columns

Check whether custom columns were selected. If no columns are provided, Bestellfix uses the default columns for that report type.

PDF Download Fails

Check that:
  • The delivery location report has data
  • Date from and date to are valid
  • The PDF template is available
  • The report format is set to PDF

Export Is Not Ready

The export job may still be pending or processing. Wait until the status is completed before downloading. Create a new download link for the completed export job.

Best Practices

Use Date Ranges Carefully

Use short date ranges for detailed analysis and larger date ranges for summaries.

Keep Inventory Posting Up to Date

Reports depend on posted inventory movements. Receive orders, post counts, process POS sales, and record waste regularly.

Use Delivery Dates

Delivery location reports are more accurate when actual delivery dates are maintained.

Exclude Irrelevant Products

Use product exclusion for partner reports when certain products should not appear in delivery summaries.

Save Frequently Used Reports

Save report configurations for recurring reports such as weekly orders, monthly product activity, or customer overviews.

Export Large Reports

Use background export jobs for larger reports instead of loading everything directly in the browser.

Summary

Reports help you understand what happened in purchasing, inventory, products, and deliveries. They help you:
  • Track stock levels
  • Analyze inventory movements
  • Review order activity
  • Calculate COGS
  • Check delivery location data
  • Export data for Excel or accounting
  • Save recurring report views

Inventory Ledger

Review the inventory movements that reports are based on.

Receiving Orders

Receive vendor orders and create receipt movements for reporting.

Ingredients

Manage the ingredient master data used in inventory reports.

Storage Units

Manage the storage locations used in stock and delivery reports.

Recipes

Connect POS sales and recipe deductions to inventory reporting.

Orders

Review customer and vendor orders used in order reports.

Product Mapping

Connect vendor products to ingredients for better inventory and cost reporting.

Dashboard

View live inventory summaries, critical stock, and recent movements.