Setting up a Winkelstraat.nl API

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.

1

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, request them by sending an e-mail to [email protected].

When you have received the credentials from Winkelstraat, you can create the API connection in Channable.

2

Create a new connection

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

• Navigate to the API page within your project and click "+Add new API". This redirects you to your company's connections page.

• On the connections page, select "+Add a new connection".

• Search for the 'Winkelstraat.nl' connection. After finding it, provide the following information:

  • Label

  • Client ID

  • Secret

• Click "Connect with Winkelstraat.nl" — the connection will then be validated and created.

3

Create the API

Choose your new Winkelstraat.nl connection and continue setting up your API.

• Configure API settings:

  • Name your API

  • Choose the unique ID per item (recommended: the 'id' field)

  • Select the language of your API

• Click "Continue" to create the new Winkelstraat.nl API.

4

Create your product listings

Follow these sequential sub-steps to prepare and map your product data for Winkelstraat.nl.

Categorize your products

Assign categories to your products using one of the following:

• AI product categorization: Automatically assigns product categories via an algorithm.

• Manual Categorization: Manually assign categories using custom rules and filters.

• Uncategorized Items: Products that still need review and categorization.

Learn more about categorizing for marketplaces

Set up rules

Rules help refine and optimize your product data for the marketplace.

• Rule templates: Predefined rules you can adjust.

• Rules setup: Filter, modify, or enhance data fields to meet marketplace requirements.

Read more about using rules for marketplaces

Build your listings

The Build step is where you configure your listings to match marketplace requirements.

• Mandatory fields: Required to list your products on this marketplace.

• Recommended: Recommended to avoid errors.

• Optional: Not required to list.

Shared attributes: common fields across products (e.g., EAN, prices, titles).

• Use static or dynamic values:

  • Static values: Fixed (e.g., brand).

  • Dynamic values: Change based on linked data (e.g., stock, prices).

Category-specific attributes: fields that apply only to a given category (e.g., size for clothing). Fill in attributes specific to the selected category.

Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.

Learn more about the Build step for marketplaces

Check the quality of your setup

The Quality step provides feedback before activation. It highlights mandatory and optional issues.

• Solve errors, prioritizing mandatory errors first.

Actions available:

• View items: See products with specific issues.

• View in build: Redirects to the Build step to map missing information.

• Set categories: Go to the Categories step to categorize items.

• Show source: Available for ID fields, redirects to Settings.

Learn more about the Quality step

Preview before activating

The Preview step shows the attributes mapped in Build and displays potential errors.

Filtering:

• Filter by error: Use the All dropdown to show only products with errors or specific error types.

• Filter by category: Use the All categories dropdown to filter by category.

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.

Learn more about the Preview step

5

Additional requirements for Winkelstraat.nl

The following information is specific to Winkelstraat.nl.

Item tab

• Item group ID is mandatory: Typically called 'item_group_id' or 'parent_id'.

• EAN not mandatory: EAN is currently not required to get items accepted, but Winkelstraat highly recommends providing it.

Attributes per category tab

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

Additional information

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

6

Send your product listings to Winkelstraat.nl

• If your project is not activated, go to Project Settings (left-hand menu) and click "Activate project".

• In the APIs overview, open [Your Winkelstraat.nl API] > Settings and click "Activate API".

• Return to the API overview and click the blue "Run now" button to send your product listings to Winkelstraat.nl.

7

Check your product listings for errors

• Go to the Result page of the API > Feedback tab to see which product listings have errors.

• Click a specific item to see detailed information about the cause of the error.