How to Review Vendor Mappings

What This Task Does

This task reviews, edits, and maintains the mappings that connect staged vendor items to real products.

Use it when supplier items need to become usable sellable inventory, or when existing mappings need correction.

Before You Start

Make sure:

• the vendor already has staged catalog items
• the product you want to map to already exists
• you know the product SKU you need
• you understand the supplier unit or measurement well enough to set multipliers

Steps

1. Open the vendor record.
2. Go to Mappings.
3. Filter the list if needed by review status, manufacturer, or search terms.
4. Open a mapping to edit it, or create one from a vendor catalog-item workflow.
5. Review and set the important fields:
   • product SKU
   • price multiplier
   • inventory multiplier
   • source flag
6. Save the mapping.
7. Use row actions when needed to:
   • sync inventory
   • export mappings
   • delete the mapping

What Happens Next

After a valid mapping is saved:

• the system can recalculate projected values
• canonical inventory can be synced automatically or via a follow-up action
• downstream stock and availability can change

Common Mistakes

• Mapping to the wrong product SKU.
• Using the wrong multiplier because supplier units were misunderstood.
• Expecting an unmapped staged item to appear in the mappings page before a mapping exists.
• Forgetting that source ownership matters when multiple mappings point at the same product.

Related Guides

• Inventory & Vendor Supply
• Vendor Mappings
• How to review vendor catalog items and resolve them
• How to bulk edit vendor mappings with Excel

Sources

• packages/admin/src/Livewire/Admin/Vendor/Mappings/DataTable.php
• packages/admin/src/Livewire/Admin/Vendor/CatalogItems/Mappings/Form.php
• packages/admin/resources/views/components/vendor/mappings/page.blade.php
• packages/framework/src/Actions/ProductVendorMapping/UpdateOrCreateProductVendorMapping.php