1688 Contact & Product Capture

Shopman currently has two separate 1688 capture flows:

• supplier contact capture, used to complete company, WangWang, contact, phone, and shipping address data
• product detail capture, used to import product name, colors, specs, URL, and thumbnail

Both flows rely on the built-in browser assistant. No manual extension installation is needed.

1. Contact Capture

Option A: Bulk capture from Favorites

This is the main path for building your supplier library.

1. Open the 1688 Favorites page
2. Click the Shopman icon and choose Sync Suppliers
3. Shopman first reads shop URLs, purchase counts, and service scores from Favorites
4. It then visits each supplier contact page in sequence
5. Captured data is written into the local supplier library automatically

Captured fields include:

• Company name
• 1688 shop URL
• WangWang entry URL
• Contact name
• Mobile / phone
• Shipping address
• Logo
• Purchase count
• Service score

Option B: Capture a single supplier from the contact page

If you only want to patch one supplier, open that supplier's 1688 contact page directly.

Typical path: the shop's contact section, or the page/contactinfo.htm URL under the store domain.

Then:

1. Wait for the page to finish loading
2. Click the Shopman panel at the bottom of the page
3. Push this supplier into the local queue
4. The client imports or updates the supplier automatically

Notes

• Favorites bulk capture includes throttling and human-like delay logic
• If a contact page fails to parse, refresh and retry first
• The WangWang field is stored as a reusable chat entry URL
• Suppliers support multiple contacts and multiple addresses after import

2. Product Detail Capture

Product capture is not a standalone left-nav page. It feeds the supplier product area automatically.

Recommended order

1. Import suppliers first
2. Open the corresponding 1688 product detail page
3. Click Capture Product Info in the Shopman panel
4. Wait for Shopman to match the supplier and import the product
5. Return to Suppliers and expand that supplier to inspect the product list

Captured fields

Current product capture collects:

• Product full name
• 1688 Offer ID
• Product URL
• Color list
• Spec / size list
• Product thumbnail
• Company name

Real import chain

This is the actual runtime flow:

1. The browser assistant pushes product data into product-scrape-queue
2. The client listens for product.queue.updated
3. It matches companyName against existing supplier names
4. If matched, it creates or updates the product automatically
5. If not matched, the queue item stays pending until supplier data is fixed

Where to view imported products

After a successful import:

1. Open Suppliers
2. Expand a supplier card
3. Check the product list under that supplier
4. Click the pencil button to edit price, logistics fee, MOQ, and remarks

3. When manual editing is still needed

Manual cleanup is still recommended when:

• companyName does not match the supplier name closely enough
• multiple similar products need clearer short names
• purchase price, logistics fee, MOQ, or remarks must be added
• color/spec extraction is incomplete and needs correction

4. Relationship to SKU binding

Contact capture solves who to buy from. Product capture solves what exactly to buy.

Once both are prepared, SKU binding becomes much faster:

1. Sync orders and find red SKU badges
2. Enter the binding flow
3. Pick from already imported suppliers and products
4. Auto-dispatch can work only after this mapping is in place

---

Next: SKU Binding →