To main website
  1. Help Center - Channable
  2. API's
  3. Other channel setups

Articles in this section

See more

Setting up a Winkelstraat.nl API

Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable platform and start with the Basic APIs or Expert APIs course.

Winkelstraat.nl is an online platform featuring a wide range of luxury and designer fashion from over 600 high-end brands. It offers exclusive items from premium boutiques across the Netherlands and Belgium. In this article we'll explain how you can set up a Winkelstraat.nl API in Channable.

Table of contents

  1. Preparation
  2. Create a new connection
  3. Create the API
  4. Create your product listings
  5. Send your product listings to Winkelstraat.nl
  6. Check your product listings for errors

Preparation

  • Request the Winkelstraat.nl API credentials: For Winkelstraat you need a Client ID and a Secret key in order to make a valid API connection. To get these credentials, you need to request them by sending an e-mail to contentapi@winkelstraat.nl.
    When you have received the credentials from Winkelstraat, you can create the API connection in Channable.

Step 1: Create a new connection

To create a new Winkelstraat.nl connection, follow the steps below:

  1. Begin by navigating to the API page within your project and click on the "+Add new API" button. This action will redirect you to your company's connections page.
  2. On the connections page, select "+Add a new connection".
  3. Search for the 'Winkelstraat.nl' connection by clicking through the pages, after finding the 'Winkelstraat.nl' connection provide the following information:
    • Label
    • Client ID
    • Secret
  4. After filling in the required information, click on "Connect with Winkelstraat.nl" and the connection will be validated and created.

Step 2: Create the API

Now you can start creating your product listings. Choose your new connection with Winkelstraat.nl and continue setting up your API.

  1. Configure API settings:
    • Name your API
    • Choose the unique ID per item. (we recommend the 'id' field)
    • Select the language of your API
  2. Create API: Click on "Continue" to create the new Winkelstraat.nl API.

Step 3: Create your product listings

Note: In the coming months, we are gradually rolling out Marketplaces V2. If your API is on Marketplaces V1, these steps might be different. Refer to this article for more information!

To set up your API, follow the steps outlined below. Click on each step to expand and view the detailed instructions, which will guide you through the entire process.

1. Categorization

For your product data to be created, your products need a category. Add categories to your products by using the generate categories feature, or create new categories from scratch.

  • Smart Categorization: This feature automatically assigns categories to your products based on predefined criteria, simplifying the categorization process.
  • Manual Categorization: Manually assign categories to your products by setting specific rules. You can create detailed filters to map each product to the correct category.
  • Uncategorized Items: Review and categorize any items that remain uncategorized to ensure all products are properly organized.

Click here to read more about the Categorization in APIs.

2. Rules

Create different rules to optimize your product data. For examples, refer to our common rules support article for guidance.

  • Rules Setup: Set up various rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

Click here to read more about the Rules in APIs.

3. Build step

The Build step in Channable allows you to configure all necessary attributes for your items, ensuring your product data aligns with marketplace requirements. This step is crucial for successful product listings and avoiding errors.

3.1 Overview

  1. Access the Build step: Start by accessing the centralized interface of the Build step. This is where you will manage and map all product attributes.
  2. Identify mandatory and optional Fields: Mandatory fields are highlighted in pink, indicating they are essential for listing your products. Optional fields are marked in orange and can be filled based on specific needs.

3.2 Populate Shared Attributes

  1. Fill Shared Attributes: Enter common details that apply to all products, such as EAN, prices, and titles. This step ensures uniformity in basic product information across your listings.
    • Use static or dynamic Values:
      • Static Values: Directly input values that remain constant, like brand name or manufacturer.
      • Dynamic Values: Utilize fields that automatically update based on linked data, ideal for variables like stock levels or prices.

After you have filled in the desired values for the Shared attributes, continue to the Category specific attributes below.

3.3 Specify Category-Specific Attributes

  1. Select product category: Choose the relevant category for your product, such as clothing or furniture.
  2. Input Category - specific attributes: Fill in attributes that are specific to the selected category, such as size for clothing or dimensions for furniture. This step helps in fine-tuning your listings according to category requirements. Here you can again use static or dynamic values.

Click here to read more about the Build step.

4. Quality step

The quality step provides instant feedback on setup quality, highlighting mandatory and optional errors to ensure your product data meets the marketplaces' standards.

Actions

  • View items: See products with specific issues.
  • View in build: Redirects to the build step to map missing information.
  • Set categories: Directs to the categories step to categorize items.
  • Show source: Available for ID fields, directing to the settings step.

Click here to read more about the Quality step.

5. Preview step

The preview step displays mapped attributes for multiple items, highlighting errors before exporting to the marketplace.

Features

  • Search & filter: Find specific products or filter by error message/category.
  • Item overview: Shows all items to be exported; it can filter to show only items with errors.
  • Detailed product preview: Displays missing information and dynamic actions to correct errors.

Checklist for finalizing attributes

  • Review shared attributes: Ensure all mandatory shared attributes are filled.
  • Review category-specific attributes: Ensure all mandatory category-specific attributes are filled.
  • Check for errors: Correct any red-marked fields.

Click here to read more about the Preview step.

6. Result step

The result tab provides an overview of your API setup outcomes, including successful uploads, errors, and a preview of the products to be listed. This tab ensures your product data is correctly processed and identifies any issues that need resolution.

  • Overview: The result tab shows the status of your product listings, highlighting errors and issues for detailed insights.
  • Preview products: Displays an overview of products to be sent to the marketplace, allowing verification of correctly filled attributes.
  • Successful: Lists products successfully processed and ready for listing, confirming compliance with marketplace requirements.
  • Errors: Identifies errors during processing, providing detailed information to troubleshoot and resolve issues.

Optional tabs like repricer errors, repricer event history, stock updates, and fulfillment updates appear only if relevant to the API you are using. Click here to read more about the Result step.

Additional requirements for Winkelstraat.nl

The following information is specific to Winkelstraat.nl, we discuss per tab what you should look out for.

Item tab

  • Item group ID is mandatory: field is mandatory to fill in. Usually, the field you can use here is called 'item_group_id' or 'parent_id'.
  • EAN not mandatory: At this moment the EAN field is not mandatory to get your items accepted by Winkelstraat, but it is highly recommended by them to still add them.

Attributes per category tab

  • Images and description: These fields are mandatory and need to be filled in the 'Attributes per category tab'.

Additional information

  • Removing products from the platform: For Winkelstraat.nl, it is not possible to completely remove products from your account. Instead, set the product's stock to '0' to deactivate it on the platform. If you need to eliminate your products, resend them with the stock set to '0'.

Step 4: Send your product listings to Winkelstraat.nl

Almost there, your product listings are ready to be sent. If you have not activated your project, go to your project settings on the left-hand side of the screen and click "Activate project". 

After, go back to the APIs overview and go to [Your Winkelstraat.nl API] > Settings, where you activate the API by clicking "Activate API".

Once you have activated the API, navigate back to the API overview and click on the blue "Run now" button to send your product listings to Winkelstraat.nl.

Step 5: Check your product listings for errors

To check for errors, navigate to the Result page of the API > Errors tab, where you see which product listings have errors. By clicking on the specific, it will display more information on what is causing the error.