Pyle

How to Review Mapping Attempts ​

What This Task Does ​

This task reviews automatic matching suggestions and turns good suggestions into real mappings.

Use it when you want to process the system's proposed matches instead of creating every mapping manually.

Before You Start ​

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

Steps ​

  1. Open the vendor record.
  2. Go to Mapping Attempts.
  3. Filter the list by the state you want to process:
    • to review
    • accepted
    • rejected
    • in progress
    • confidence
    • match type
  4. Open the details when you need more context.
  5. Choose the next action:
    • accept
    • reject
    • retry
  6. If needed, follow the created mapping into the mapping workflow afterward.

What Happens Next ​

After you accept an attempt:

  • the system creates the real mapping
  • that mapping can then participate in canonical inventory sync

After you reject an attempt:

  • the item stays unmapped
  • you can retry or resolve it another way later

Common Mistakes ​

  • Accepting a suggestion without checking the proposed product carefully.
  • Expecting a failed attempt to create a mapping.
  • Confusing mapping attempts with saved mappings.
  • Forgetting to revisit the mapping after acceptance when multiplier review is still needed.

Sources ​

  • packages/admin/src/Livewire/Admin/Vendor/Mappings/Attempts/DataTable.php
  • packages/admin/resources/views/components/vendor/mappings/attempts/page.blade.php
  • packages/framework/src/Actions/ProductMappingAttempt/AcceptMappingAttempt.php
  • packages/framework/src/Actions/ProductMappingAttempt/RejectMappingAttempt.php