AI Configuration Guide: Map Supplier API Products to WooCommerce with AI

Overview

AI configuration reads your supplier's API and suggests the settings you would otherwise fill in by hand, so a new supplier can be ready to sync in minutes. There is nothing to upload: AI works from the live API response of the connection you created.

It helps in two places:

• Pre-requisites: where the product list sits in the API response, what kind of products it holds, how variations are sent, and the unique product and variation codes.
• Attribute mapping: which supplier field feeds each WooCommerce field, such as Name, SKU, price, stock, images, categories, colour and size.

Prerequisites for AI Product Mapping:

• A supplier with an API connection that you have saved and tested, so the plugin can read real product data.
• An AI provider connected in WordPress, with a text model available.

Configuration Steps

Step 1: Choose an AI service and model

AI suggestions need one connected AI service and one text model. The plugin uses the AI provider already connected in your WordPress site, so it never asks for or stores your API key.

• Connect an AI provider in WordPress if you have not already.
• In the AI panel, pick an AI service from the list. Only services that are connected and offer a text model appear.
• Pick a model for that service.

• Your choice is remembered, so you only do this once. You can change it at any time.

What If No AI Service Appears?

If the list is empty, the plugin shows "Connect an AI provider in WordPress, then try again."

If a service has no text model, you will see "This AI service has no text model available. Pick another service, or connect a text model in WordPress."

Step 2: Fill the product structure with AI

On the supplier's API connection screen, the Fill product structure with AI banner suggests how your supplier's products are laid out. Save and test the connection first, because AI reads the tested response.

• Open the supplier's API connection and make sure it is saved and tested.
• Optional: type a short brief in the hint box, for example "products live under data.items, SKU is articleNumber". A hint is not required, but it helps with unusual APIs.
• Click Get suggestions.
• Review each suggestion. Open Why this? to see the reason behind it.
• Click Use suggestion on each one you accept, or type your own value.
• Apply your choices and save the connection.

What AI fills in

The variation fields only appear when your supplier sends variable products.

Fixing one field: Click the wand next to a field, add an optional hint, and regenerate just that field. Changing some fields refreshes related ones, and you are told to review them before applying.

Step 3: Map attributes with AI

Attribute mapping links each WooCommerce field to a field in your supplier's API. The AI wizard suggests these links for the important fields in two steps: choose what to map, then review the suggestions.

Run the wizard

• Open Attribute Mapping for your supplier. The banner shows how many important fields are already mapped, for example "3 of 8 important fields mapped".
• Click Get suggestions.
• On the fields step, choose the supplier API each field should read from. Select an API for at least one field.
• Optional: add a hint, for example "this vendor uses productName for titles".
• Click Generate mappings.
• On the review step (Step 2 of 2), check each suggestion. Nothing is saved until you apply.
• Click Apply and confirm. The button shows how many accepted fields it will apply.

What the wizard covers

Reading the review step

Each suggestion shows a confidence percentage.

• 70% or higher: shown as a normal suggestion.
• Below 70%: marked "Needs a look". Check these before accepting.
• 80% or higher: included when you accept all suggestions in one go.

For each field you can accept the suggestion, choose Keep current to leave the existing mapping alone, or type a hint and click Regenerate to get a new suggestion for that field only. Choose Skip remaining to leave the rest unmapped, or I'll map by hand to leave the wizard.

When the wizard finishes, it shows how many fields were applied, skipped and still empty. Use Open Main Product or Open Variations to check samples on the mapping screens and fill anything left.

Suggest one field at a time: On any mapping screen you can also use Suggest supplier attribute with AI while a field is open, with an optional hint. If AI is not confident, it says so and you pick from the list yourself.

Tips

• Always test the connection first. Suggestions are only as good as the sample response AI can read.
• Do the pre-requisites before attribute mapping, because mapping depends on knowing where the products sit.
• Use hints for unusual APIs. One line naming the real field, such as "SKU is articleNumber", often fixes a wrong suggestion.
• Check anything marked "Needs a look", and compare a few mapped fields against real supplier data on the mapping screens.
• Run a small test sync before syncing the full catalogue.
• AI is optional. You can map any field by hand at any time.

Troubleshooting AI Configuration Errors

Related Articles

• WooCommerce API Product Sync with REST APIs
• Integrate External REST API into WordPress
• REST API Authentication Setup Guide for WordPress