Pyle

Vendor Mappings ​

What This Is ​

Vendor Mappings connect supplier-side catalog items to the real products Pyle sells from.

This is the workflow that lets Pyle turn staged vendor supply into canonical inventory and later storefront availability.

When You Would Use It ​

Use Vendor Mappings when you need to:

  • map a supplier item to a real product
  • correct the product a supplier item points to
  • adjust price or inventory multipliers
  • review mappings that need attention
  • bulk-edit mappings through Excel

Before You Start ​

Before you work with Vendor Mappings, make sure:

  • the vendor and staged catalog item already exist
  • the target product already exists
  • you know the product SKU you want to map to
  • you understand whether the supplier item already has valid staged inventory behind it

How To Use It In The Admin ​

  1. Open a vendor record.
  2. Go to Mappings.
  3. Search or filter the list by review state, manufacturer, or supplier item details.
  4. Open an existing mapping to edit it, or create one from a vendor catalog item workflow.
  5. 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
    • delete the mapping
    • export mappings

You can also maintain mappings in bulk with the Excel workflow.

What It Changes In The Storefront ​

Vendor Mappings do not show up as a shopper-facing feature.

They affect the storefront indirectly by controlling whether vendor supply becomes usable canonical inventory, which can then change:

  • stock availability
  • product sellability
  • location-backed supply

Common Tasks ​

Create a new mapping ​

Link a staged vendor item to the correct product using the product SKU and the right multipliers.

Fix multipliers ​

Adjust the price or inventory multipliers when the supplier unit does not match the product unit one-to-one.

Review flagged mappings ​

Use the review state and projected values to decide whether a mapping needs manual attention.

Bulk edit mappings ​

Use the Excel export/import workflow when many mappings need updates at once.

Rules, Limits, And Things To Watch ​

  • A mapping is not just a lookup. It can affect real inventory and sellable supply.
  • Only one mapping should act as the source mapping for a product.
  • Some mapped items still will not create canonical inventory if the staged supply does not meet the sync rules.
  • Saving a mapping can trigger downstream sync behavior automatically.

Troubleshooting ​

I saved a mapping, but nothing changed ​

Check whether the staged vendor item has active eligible inventory behind it. A mapping alone does not guarantee sellable stock.

The supplier item is not in the mappings page ​

It may still be unmapped and waiting in the vendor catalog-item workflow instead.

The projected values look wrong ​

Review the multipliers and the staged supplier unit or quantity information before accepting the result.

  • Vendor Catalog Items
  • Mapping Attempts
  • Inventory Locations
  • Bulk Excel import/export

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/Models/ProductVendorMapping.php