English

中文

English

中文

Appearance

Unknown Product Detail ​

Table of Contents ​

I. Feature Guide ​

When you click a record in the Unknown Products list, you land on this detail page. It shows the full information for this Unknown Product, which orders are currently blocked, and lets you perform the most important step of the whole flow — "Confirm Mapping" it to the correct product in the system, unfreezing all affected orders at once.

Unknown Product Detail - Page Overview

Quick Links: Basic Info | Map to Real Product | Affected Orders

1.1 Basic Info ​

The info card at the top shows the source and impact of this Unknown Product, helping you judge what it is and how many orders it blocks before mapping:

FieldDescription
Platform, EC AccountWhich platform and shop this record was synced from; manual orders show "-"
Pending OrdersHow many not-yet-shipped orders are blocked on this unknown product — also the number of orders that get updated when you map it
Total QuantityThe total quantity those orders demand for this unknown product

The remaining fields (Identifier, SKU, Product Name, Merchant, Created At, Updated At) display by name.

1.2 Map to Real Product ​

This is the most important operation on the detail page. Mapping tells the system "this Unknown Product is actually this system product," and the system then swaps every blocked order to the correct product and reallocates inventory.

▸ Steps ​

  1. In the "Select Product" dropdown, search for and select the correct system product. The dropdown only lists products under the current merchant, so the product must already exist in the system.
  2. Click "Confirm Mapping".
  3. The system shows a confirmation dialog reading "This will affect {{count}} orders"; confirm to proceed.
  4. If this record comes from a platform that supports backfill (currently Shopee), it then asks once more, "Also push the new SKU back to the e-commerce platform?" — see the FAQ below.

▸ What happens after mapping ​

  • Every order item blocked on this Unknown Product is swapped to the real product you selected.
  • The system reallocates inventory for those orders and re-checks order status, so the previously frozen orders return to the normal flow.
  • Each affected order gets a mapping entry recorded in its order history.
  • This Unknown Product record is deleted, so it no longer appears in the list.
  • The page shows a success message, and the "Affected Orders" section below confirms the result.

⚠️ Mapping cannot be undone ​

Once mapping completes it cannot be reverted. If you pick the wrong product, you can only go into each affected order and change the product back by hand. Always double-check the product before clicking confirm.

1.3 Affected Orders ​

The section at the bottom lists every order blocked on this Unknown Product, including Order Number, Status, Receiver Name, and Created At. Clicking the Order Number opens that order in a new tab. After mapping completes, this list is the result of the operation.

II. FAQ ​

Quick Links: FAQ | Important Notes

2.1 FAQ ​

▪ What if I mapped to the wrong product? ​

Mapping cannot be undone. If you picked the wrong product, you can only go into each affected order and change the product back by hand. So double-check before confirming.

▪ Why can't I find the product in the "Select Product" dropdown? ​

The "Select Product" dropdown only lists products under the current merchant. If it's missing, usually it's because: the product isn't created in the system yet (add it in the Product List first), the product is deactivated, or the search keyword is off (try the SKU or full product name).

▪ Can one unknown product map to multiple real products? ​

No, only one. If different products in a batch of orders were grouped under the same Unknown Product, it means the source orders share the same SKU/name — you need to fix the order data first to map them separately.

▪ Which option should I choose for "Backfill this SKU to the platform?" ​

Choosing "Yes" updates the platform product's SKU to your internal SKU, so future orders for the same product match automatically and no longer become Unknown Product; choosing "No" only completes this mapping and leaves the platform untouched. This prompt only appears when the record comes from a platform that supports backfill (currently Shopee); manual orders and other platforms won't show it.

▪ What happens if the platform backfill fails? ​

A failed backfill does not affect this mapping — the orders are already swapped to the correct product and inventory is allocated; only the SKU wasn't written back to the platform. The system shows a notice explaining the cause (e.g., platform not supported, platform rejected it, connection failed). You can try again later, or change the product's SKU to the internal SKU manually in the platform's seller portal.

▪ After mapping, do order inventory and status update automatically? ​

Yes. During mapping the system reallocates inventory for the affected orders and re-checks order status — you don't need to do anything more on the order page. See "What happens after mapping" for the full impact.

2.2 Important Notes ​

⚠️ Important Reminders ​

  • Mapping cannot be undone; confirm the correct product before running it.
  • After a successful mapping, this Unknown Product record is deleted and cannot be recovered.
  • Backfilling to the platform only changes the SKU on the platform — it's separate from this mapping; a failed backfill does not invalidate the mapping.
FeatureDescriptionLink
Unknown Product ListReturn to the list to see all pending unknown productsGo
Product ListConfirm the target product exists before mappingGo
Order ListView or fix orders blocked by unknown productsGo