It can be challenging initially for Sellers to understand how adding products (known as Adverts) works via the Marketplacer Seller API, so it is a good idea to have them create a product directly in the Seller Portal first. This will help them understand the fields and elements that make up a product in Marketplacer.
Follow this procedure for manually adding products via the seller portal.
Here’s an example of a new product, with some basic details.
Product Details
When Sellers add products to Marketplacer, the details of the product being added need to match the fields and definitions you have set up in your Marketplace. For example, they need to include (at minimum):
- Title & Description
- Category (known as a Taxon in the API)
- Brand
- Price (Base, Sale, From, etc.)
- Availability
However, the underlying product structure in Marketplacer is complex. And it's important that Sellers understand the structure in order to build a successful API connection and upload products.
Product Structure
In Marketplacer, products are:
- assigned to a Category – the broad grouping of products. E.g., Headphones, dinnerware, apparel. Subcategories can exist too, e.g., Headphones > Gaming, Headphones > Kids.
- defined by Prototypes – a pre-defined mix of Variants and Features.
Category details
Prototype details
Variant details
The image below shows how a Variant is defined by selecting the variant options.
Related articles