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
- Preparation
- Create a new connection
- Create the API
- Create your product listings
- Send your product listings to Winkelstraat.nl
- 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:
- 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.
- On the connections page, select "+Add a new connection".
- 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
- 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.
-
Configure API settings:
- Name your API
- Choose the unique ID per item. (we recommend the 'id' field)
- Select the language of your API
- Create API: Click on "Continue" to create the new Winkelstraat.nl API.
Step 3: Create your product listings
Follow these steps to set up your channel:
1. Categorize your products
To set up your product data, assign categories to your products.
- Smart Categorization: Automatically assigns product categories through our algorithm.
- Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
- Uncategorized Items: Products that still need to be reviewed and categorized
2. Set up rules
Rules help you quickly optimize your product data for the marketplace you want to sell on.
- Rule templates: Commonly used rules you can adjust for your use case.
- Rules setup: Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.
3. Build your listings
The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.
Mandatory and optional fields:
- Mandatory fields : Required to list your products on this marketplace
- Recommended : Recommended to avoid errors
- Optional : Not required to list
Shared attributes
Shared attributes are the common fields that apply across your 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: Fixed values that don’t change (e.g. brand name, manufacturer)
- Dynamic values: Fields that automatically change based on the linked data (e.g. stock, prices)
Category-specific attributes
Category-specific attributes fields that specifically apply to the category for your products .This step helps in fine-tune your listings to meet category requirements for your marketplace.
Fill in attributes that are specific to the selected category (e.g. such size for clothing or dimensions for furniture.)
Learn more about the Build step for marketplaces
4. Check the quality of your set up
The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.
- Solve errors, prioritizing mandatory errors first.
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. Directs to the Settings step.
5. Preview before activating
The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.
Filtering:
- Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
- Filter by category: Click the All categories dropdown and select the category you want to filter by.
Before you continue:
- 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.
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 > Feedback 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.