Marketplace Listings and Mapping

​

Review Listings On A Product

Open a product and select Listings. The tab groups marketplace listings by channel and shows whether each connector is available. When a connector is connected, operators can add a listing mapping. When it is not connected, Arcus sends the operator back to Integrations first.

• Connected: Arcus has an active connector for that channel and can add listing mappings.
• Not connected: connect the marketplace in Integrations before adding a listing for that channel.
• External SKU: the channel SKU, which may differ from the Arcus SKU.
• Sync inventory: allows Arcus stock changes to update that listing when the connector supports it.
• Sync price: allows Arcus pricing to update that listing when the connector supports it.

​

Choose The Right Mapping Target

The correct target is the Arcus item that should receive the imported order line and supply the inventory or price value sent back to the channel.

• Single physical SKU: map the external listing to the physical product.
• Marketplace variant: map the external variant to the matching Arcus child variant, not the variant parent.
• Kit listing: map to the kit or variant kit that customers buy, then let fulfillment consume the components.
• Service listing: map only when the channel line should become a service product in Arcus.
• External bundle managed outside Arcus: do not approve the mapping until support confirms whether Arcus or the channel owns inventory for that bundle.

​

Add A Listing Mapping

1. Open the product or variant parent record.
2. Go to Listings.
3. Find the connected marketplace channel.
4. Click Add Listing.
5. For Shopify, review the variant search results when Arcus finds candidates by SKU.
6. If the search does not find a candidate, enter the external listing or variant ID manually.
7. Confirm the external SKU and external title when available.
8. Choose whether inventory and price sync should be enabled.
9. Click Add Listing.

For Shopify, Arcus searches by the Arcus SKU when the product has one. One clear candidate can fill the external fields for review; multiple candidates require the operator to choose the correct external variant. If there are too many close matches, refine the SKU or use the manual External ID fallback instead of guessing. Inventory sync starts on by default in the dialog, while price sync should stay off until the channel price has been audited.

​

Use The Mapping Inbox

The Marketplace Mapping Inbox is for listings that arrived from a channel and still need human review. It keeps unmapped listings, suggested Arcus matches, drift rows, and bulk mapping work in one place.

• Unmapped Listings: listings that need a canonical product or variant before Arcus can treat them as mapped.
• Suggested matches: candidate products based on SKU and title similarity.
• Approve mapping: binds the listing to the selected Arcus item and activates the listing mapping.
• Reject: removes the listing from the inbox when it should not be mapped. Approving a row makes the listing active for that Arcus product or variant. After approval, review whether inventory sync and price sync should stay on. A listing can be mapped for order identity while price sync remains off until the pricing team finishes its audit.

​

Resolve Inventory Drift

Drift appears when Arcus and the marketplace disagree about listing quantity. Use the drift tab to review the Arcus quantity, channel quantity, difference, and available resolution actions.

• Push Arcus: mark the row resolved after using Arcus as the quantity source.
• Pull Shopify: mark the row resolved after using the marketplace quantity as the source.
• Ignore: close the row when the mismatch is intentional or not worth action. Use Push Arcus when Arcus inventory is the trusted source and the marketplace should be corrected. Use Pull Shopify only when the channel quantity is known to be right and Arcus must be updated or reconciled. Use Ignore for intentional channel differences, temporary maintenance, or rows that will be corrected by a separate process.

​

Use Bulk Map For Shopify

Bulk Map pulls the connected Shopify catalog and compares Shopify variant SKUs to unmapped Arcus products. Use it when a large catalog needs first-pass mapping or cleanup after a connector is connected.

1. Open Products and go to Marketplace Mapping Inbox.
2. Select Bulk Map.
3. Click Start Shopify Bulk Pull.
4. Wait for the catalog pull to finish.
5. Review exact and partial SKU matches. Exact SKU matches are strong candidates; partial matches still need human review.
6. Use selection controls only for rows that are correct.
7. Click Confirm Selected.
8. Spot check the Product Listings tab after confirmation. Bulk Map polls the Shopify catalog pull while it runs and then shows matched and unmatched rows. Unmatched products are not a failure by themselves; they are the cleanup list for missing SKUs, discontinued channel variants, or products that should stay unmapped.

​

How Listing Mapping Affects Other Workflows

• Imported orders: mapped listings help Arcus attach imported marketplace lines to the correct product or variant.
• Inventory sync: mapped listings are the targets for stock pushes when sync is enabled.
• Price sync: mapped listings are the targets for price pushes when price sync is enabled.
• Fulfillment sync: connector fulfillment updates depend on the imported order and listing relationship.
• Reporting: Listings Performance and channel reports are more useful when listing rows point at canonical products.
• Support: product, order, and channel troubleshooting is faster when the external SKU and Arcus SKU are connected.

​

Common Blocks

• Add Listing is missing: connect that marketplace under Integrations first.
• Shopify search finds no candidate: confirm the Arcus SKU matches the Shopify variant SKU, or use manual External ID entry.
• Multiple candidates appear: compare SKU, title, variant option, channel, and product identity before selecting one.
• Inventory updates the wrong listing: verify the listing is mapped to the exact product or variant being sold.
• Drift keeps coming back: review manual marketplace edits, connector health, order imports, and inventory corrections.
• Bulk Map shows too many partial matches: clean up Arcus SKUs and Shopify variant SKUs before confirming a large batch.
• Unmatched rows remain after Bulk Map: review whether the channel SKU is missing, discontinued, intentionally unmapped, or represented by a different Arcus variant.

​

Related Articles