Skip to main content

Understanding the 'How to Fix' (AI Error Helper)

Karolina Santiago avatar
Written by Karolina Santiago
Updated over a month ago

The How to Fix feature is an AI-powered assistant that helps you quickly understand and resolve errors that occur during bulk actions in 3Dsellers. When a bulk action fails, How to Fix analyzes the error and gives you clear, actionable steps to get things back on track—without digging through confusing marketplace messages.


What is How to Fix?

Bulk actions (like listing products, updating prices, or syncing inventory across marketplaces such as eBay, Amazon, Shopify, or Walmart) may sometimes fail due to marketplace rules, missing data, or formatting issues.

Instead of showing only a cryptic marketplace error, How to Fix uses AI to:

  • Analyze the error based on the bulk action and marketplace involved

  • Explain what went wrong in simple, human language

  • Provide marketplace-specific troubleshooting steps

  • Suggest a direct fix so you can retry the action confidently

⚠️ AI Credit usage notice

Each time you click How to Fix to generate an explanation, 1 AI credit is deducted.
This also applies if you click again to refresh/regenerate the response.


Where you’ll see it

How to Fix appears whenever a bulk action item fails and an error is logged. You can open the error and request an AI explanation directly from the log.

  1. Click in the View Errors

  2. Below the Error description click in the 'How to Fix' button


AI Helper pop-up: key functionality

When the How to Fix pop-up opens, it includes several built-in tools to help you resolve the issue quickly and efficiently.

Refresh / regenerate the AI explanation

Inside the pop-up, next to the How to Fix section, you’ll see a refresh (↻) icon.

  • Clicking this regenerates the AI explanation

  • Useful if:

    • the issue persists after applying the steps

    • the error has changed

    • you want a fresh analysis

  • Each refresh consumes 1 AI credit, just like the initial request


Quick Navigation shortcuts

At the bottom of the pop-up, the Quick Navigation menu provides direct links to the most relevant areas for fixing the issue.

Depending on the error, this may include shortcuts to:

  • Edit Product – update missing or invalid product data

  • Edit Mapping Template – fix attribute or rule mismatches

  • Categories Mapper – resolve category-related errors

  • Products Catalog – review or manage catalog-level data

These shortcuts let you jump straight to the place that needs fixing, without searching through the platform.


Contact Support Team

If the AI explanation doesn’t resolve the issue, you can use the Contact Support Team button directly from the pop-up.

This is recommended when:

  • the error is caused by marketplace account restrictions

  • the issue is policy-related or unclear

  • you’ve completed all suggested steps and the error still occurs


AI credit usage reminder

Each time you:

  • click How to Fix, or

  • regenerate the explanation using the refresh icon

1 AI credit is deducted per request.


How it works (behind the scenes)

When you request a How to Fix explanation, the system uses multiple layers of context to generate helpful guidance:

1. Error detection

3Dsellers logs the failure together with key context such as:

  • The bulk action you attempted (e.g., “List on eBay”)

  • The marketplace/channel used

  • The raw marketplace error message

  • The exact data sent to the marketplace

2. AI analysis

The AI then evaluates the issue using:

  • The platform error itself

  • Your action type

  • Your marketplace connection

  • Product or item data involved

  • Marketplace troubleshooting documentation

3. Smart caching for speed

To keep responses fast and consistent:

  • Explanations for identical errors are cached for 24 hours

  • If the same error happens again, you get an instant explanation

  • You can still regenerate a fresh one anytime

4. Explanation delivery

You’ll receive:

  • A clear cause of the issue

  • Step-by-step instructions to fix it

  • Any relevant marketplace limitations or requirements


Key benefits

Intelligent context analysis

How to Fix doesn’t just read the error text—it understands the full situation, including:

  • Marketplace rules (eBay, Amazon, Shopify, Walmart, etc.)

  • The exact bulk action you ran

  • The data that triggered the failure

  • Channel-specific formatting/validation requirements

Fast, reliable answers

  • Cached explanations return instantly

  • Fresh AI explanations typically take only seconds

  • Results are saved for future reference

Actionable, step-by-step fixes

Instead of generic messages, you get:

  • clear next steps

  • prevention tips

  • marketplace-aligned guidance


Common use cases

How to Fix is especially useful for:

  1. Product listing failures

    • Missing required fields

    • Invalid attribute values

    • Category mismatches

    • Image or variation rules

  2. Inventory sync errors

    • SKU mismatches

    • Quantity validation problems

    • Fulfillment conflicts

  3. Price update issues

    • Pricing policy violations

    • Currency/format errors

    • Min/max price restrictions

  4. Order processing/import errors

    • Missing buyer info

    • Address validation failures

    • Marketplace payment rules


Best practices

Do

  • Use How to Fix as soon as you see errors

  • Check whether the response came from cache

  • Follow the steps in order

  • Use exact identifiers (bulk_log_id or item_id) for accuracy

Don’t

  • Ignore marketplace context (it’s often the root cause)

  • Skip steps—each one is sequenced for a reason

  • Hesitate to regenerate if the issue persists

  • Forget to retry the bulk action after applying the fix


Troubleshooting How to Fix

If you don’t get an explanation

  1. Verify you sent valid identifiers (bulk_log_id, item_id, or seller_id + product_id)

  2. Make sure the error exists in your logs

  3. Confirm your user role has access to the bulk action

If the explanation isn’t helping

  1. Regenerate with "regenerate": true

  2. Double-check you’re fixing the right item/action

  3. Contact support and include your bulk_log_id

If you see a generic message

A fallback like “Issue on platform side” may mean:

  • The AI couldn’t confidently identify the cause

  • The issue may be temporary or on our side

  • Please contact support if urgent

Did this answer your question?