Pyle

Mapping Attempts ​

What This Is ​

Mapping Attempts are the automatic suggestions Pyle generates when it thinks a staged vendor item might match a real product.

They exist to speed up mapping review without forcing operators to create every mapping manually from scratch.

When You Would Use It ​

Use Mapping Attempts when you need to:

  • review automatic match suggestions
  • approve a good suggestion quickly
  • reject a bad suggestion
  • retry matching after data changes

Before You Start ​

Before you review Mapping Attempts, make sure:

  • the vendor already has staged catalog items
  • those items are not already mapped
  • you understand that a mapping attempt is only a suggestion until you accept it

How To Use It In The Admin ​

  1. Open a vendor record.
  2. Go to Mapping Attempts.
  3. Filter the list by the state you need:
    • in progress
    • to review
    • accepted
    • rejected
    • confidence level
    • match result
  4. Open the details when you need to inspect the suggestion more closely.
  5. Choose the next action:
    • accept
    • reject
    • retry
  6. Continue into the mapping workflow if you need to review the created mapping afterward.

What It Changes In The Storefront ​

Mapping Attempts do not affect the storefront by themselves.

Only accepted attempts matter downstream, because accepting an attempt creates the real mapping that later drives inventory sync.

Common Tasks ​

Accept a strong suggestion ​

Use this when the proposed product match is correct and you want to move quickly.

Reject a bad suggestion ​

Use this when the proposed match is wrong and should not create a real mapping.

Retry matching ​

Use this after changing the staged item, related rules, or other supporting data.

Rules, Limits, And Things To Watch ​

  • A mapping attempt is not the final mapping record.
  • You can only accept or reject attempts that are in the right review state.
  • A failed attempt does not create a real mapping.
  • Even an accepted attempt may still need you to review the resulting mapping later.

Troubleshooting ​

I do not see any mapping attempts ​

The item may already be mapped, invalid, or not eligible for attempt generation yet.

I accepted an attempt, but storefront availability still did not change ​

The accepted attempt only creates the mapping. Inventory still depends on the staged supply and later sync rules.

I cannot accept or reject an attempt ​

Check the attempt status. Only the right reviewable states allow those actions.

  • Vendor Mappings
  • Vendor Catalog Items
  • Vendors

Sources ​

  • packages/framework/src/Actions/ProductMappingAttempt/CreateMappingAttempt.php
  • packages/framework/src/Actions/ProductMappingAttempt/AcceptMappingAttempt.php
  • packages/framework/src/Actions/ProductMappingAttempt/RejectMappingAttempt.php