​

Product Mapping

Product mapping connects vendor products to your internal ingredients. This allows Mathership to convert ordered products into ingredient stock when orders are received.

​

What is product mapping?

A product mapping tells Mathership which ingredient should be updated when a vendor product is received, and how much stock one unit of the product creates.

​

Why product mapping is important

Product mappings are required for automatic inventory receipts. Without a mapping, Mathership cannot know which ingredient should be updated.

​

When to use product mapping

Use product mapping when you want to:

• Receive vendor orders into inventory
• Convert ordered products into ingredient stock
• Track stock quantities correctly
• Calculate inventory value
• Support reorder suggestions
• Improve inventory reports

​

How mapping works

A mapping connects one vendor product to one internal ingredient. It includes:

​

Where to create mappings

Product mappings are created from two places:

​

The mapping sheet

Clicking Map product opens a side panel pre-filled with the vendor product details. The panel header shows the product name. A product card in the form displays the product image, if available, article number, product name, and packaging text from the vendor catalog.

​

Form fields

​

Creating a new ingredient inline

If the ingredient does not exist yet, select + Add new ingredient from the ingredient picker. This opens an inline form with:

• Name field
• Base unit dropdown

The ingredient is created immediately and the mapping continues without leaving the sheet.

​

Packaging levels

Packaging levels define the structure of the vendor product and how it converts into the ingredient’s base unit. Every mapping requires at least one packaging level. Each level has:

​

Packaging examples

Click Add level to add a row. Click the X button to remove a row. The last level must have a unit selected.

​

Conversion factor

The factor defines how much ingredient stock one received product unit creates. received quantity × factor = ingredient quantity added

​

AI Factor

Click Get AI factor in the mapping sheet to let Mathership suggest the factor and packaging levels automatically. The AI reads the product details and the selected ingredient and returns:

• A suggested conversion factor
• Suggested packaging levels with names, quantities, and units

​

Creating a mapping

​

Editing a mapping

Click an already-mapped product to open the mapping sheet pre-filled with the current values. Update any field and click Update mapping.

​

Deleting a mapping

Deleting a mapping stops future automatic inventory receipts for that product. Use this when:

• The product is no longer used
• The product was mapped incorrectly
• The vendor product should not affect inventory
• A cleaner mapping should replace it

​

Automatic factor calculation

Mathership may help calculate the conversion factor from packaging information. This can use:

• Product packaging text
• Packaging levels configured in the mapping
• The selected ingredient
• The ingredient base unit
• Unit conversions

​

Receiving orders with mappings

When receiving an order, Mathership checks each order item. If a product is mapped, the system creates a receipt movement in the inventory ledger. Unmapped items are flagged during the receiving flow. Click Map product on any unmapped item to create the mapping before posting.

​

Missing mappings

A missing mapping means Mathership cannot convert the product into ingredient stock. Common reasons:

• The vendor product is new
• The product was renamed
• The ingredient does not exist yet
• The conversion factor has not been set
• The product should not affect inventory

​

Product mapping and inventory ledger

When a mapped product is received, Mathership creates an inventory ledger entry. The ledger entry includes: See Ledger for details.

​

Product mapping and costs

Product mappings also help calculate inventory value. When receiving an order, Mathership uses the product price and conversion factor to calculate a cost per ingredient unit. This unit cost feeds into the ingredient’s weighted average cost.

​

Product mapping and reorder suggestions

If Mathership knows which vendor product belongs to which ingredient, it can suggest what to order when stock is low. See Reorder Suggestions for details.

​

Product mapping and reports

Product mappings improve inventory reports because received orders can be connected to ingredients. This helps answer questions like:

• Which products increased stock?
• Which ingredients were received?
• Which vendor products are not mapped yet?
• Which products create inventory value?
• Which ingredients need better mapping?

​

Good mapping examples

​

Common mistakes

​

Best practices

​

Common workflows

​

Map a vendor product to an ingredient

1. Open an order and find an unmapped item
2. Click Map product
3. Select the ingredient or create one inline
4. Add packaging levels
5. Set the factor or use Get AI factor
6. Save the mapping

​

Receive an order into inventory

1. Open the order
2. Check which items are mapped
3. Add missing mappings directly from the order if needed
4. Select the storage unit
5. Confirm received quantities
6. Post the receipt to inventory

​

Fix a wrong mapping

1. Open the mapped product from the order or the ingredient detail page
2. Correct the ingredient, packaging levels, or factor
3. Click Update mapping
4. Review the next receipt carefully to confirm the fix

​

Review unmapped products

1. Open the receiving flow for the order
2. Items marked as unmapped cannot be transferred to inventory
3. Click Map product on each unmapped item
4. Create the mapping and return to the order
5. Continue receiving

​

Common problems

​

Related pages