Skip to content

Vendor Catalog Items

What This Is

Vendor Catalog Items are the staged supplier-side product records that Pyle receives before they are fully resolved into the catalog and supply workflows you actually sell from.

They are useful because they let operators review incoming vendor data, classify it, archive it, and decide what should happen next.

When You Would Use It

Use Vendor Catalog Items when you need to:

  • review what a vendor feed imported
  • find invalid or unmapped supplier items
  • assign or correct manufacturer, category, or type
  • archive or delete bad staged items
  • create a product attempt or continue into mapping work

Before You Start

Before you work with Vendor Catalog Items, make sure:

  • the vendor exists
  • feed or import data has already been loaded
  • you understand whether the item is valid, mapped, archived, or still needs work

How To Use It In The Admin

  1. Open a vendor record.
  2. Go to Catalog Items.
  3. Filter the list by the state you need to review:
    • validity
    • mapping status
    • selling status
    • stock status
    • manufacturer
  4. Open the edit dialog when you need to change:
    • archive state
    • manufacturer
    • category
    • type
  5. Open a specific catalog item when you need the full detail view.
  6. From the detail view, review:
    • staged inventory rows
    • mappings
    • resulting canonical inventory rows
  7. Use the item actions when needed to:
    • archive or restore
    • delete
    • auto-assign manufacturer
    • create a product attempt

What It Changes In The Storefront

Vendor Catalog Items are not directly storefront-visible.

Their effect is indirect. They matter because they are the staging point that leads to:

  • mapped products
  • canonical inventory
  • customer-visible stock and availability changes

Common Tasks

Review invalid or unmapped items

Use the list filters to focus on the staged records that still need work.

Correct classification

Open the edit dialog to set or fix the manufacturer, category, or type.

Archive or remove a staged item

Use this when a supplier item should no longer be considered in active review.

Start resolution work

Use product attempts or mapping flows when the staged item is ready to be connected to the real catalog.

Rules, Limits, And Things To Watch

  • Valid, mapped, archived, and detected are different states. Do not treat them as the same thing.
  • The packaged edit dialog does not expose every vendor field. Most of the rich source data is still read-only staging data.
  • A staged item does not become customer-visible just because it exists. It still needs later resolution.

Troubleshooting

I can see the item, but it is not affecting anything

That is normal when it is still staged, unmapped, or otherwise unresolved.

I expected to edit more fields than the dialog shows

The packaged dialog mainly handles archive and classification decisions. Most imported vendor fields are not directly editable there.

The item disappeared from active review

Check whether it was archived or filtered out by the current list state.

  • Vendors
  • Vendor Data Feeds
  • Vendor Mappings
  • Mapping Attempts

Sources

  • packages/admin/src/Livewire/Admin/Vendor/CatalogItems/DataTable.php
  • packages/admin/src/Livewire/Admin/Vendor/CatalogItems/EditDialog.php
  • packages/admin/resources/views/components/vendor/catalog-items/page.blade.php
  • packages/admin/src/Livewire/Admin/Vendor/CatalogItem/Page.php
  • packages/framework/src/Models/ProductVendorCatalogItem.php