# Setting up a ANWB API

ANWB is a well-known Dutch organization offering a wide range of products and services, from travel and leisure to roadside assistance.

{% stepper %}
{% step %}

### Step 1: Create a new connection

* Navigate to **\[Your project] > APIs**.
* Click on the **+Add new API** button. This will redirect you to your company's connections page.
* On the connections page, select **+Add a new connection**.
* Search for the "ANWB" connection by clicking through the pages and select it.

[![](/files/ae13e50ab9e7b6abf20a1e270b666954a5106d83)](https://helpcenter.channable.com/hc/article_attachments/21547535658642)

* Add a label.
* Click on **Create**. You will be redirected to ANWB for the next step.

|                                                                                                                                |                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| [![](/files/e26f1f3a996a17d34c01d72dc1880f6022b59a66)](https://helpcenter.channable.com/hc/article_attachments/21547520301586) | [![](/files/4e9e2bc37c46d19f2387781c970078e1fb528331)](https://helpcenter.channable.com/hc/article_attachments/21547520302354) |

* Once redirected, log in using your ANWB credentials.

After successfully logging in, the connection with ANWB is ready. Next, you will be brought back to the API setup.
{% endstep %}

{% step %}

### Step 2: Create the API

Once you have created your connection, select your new ANWB connection and configure your API settings:

* Give your API a name.
* Choose the Unique ID per item from the dropdown. We recommend the `id` field.
* Select the language of your API.
* Click **Continue** to create the new ANWB API.

[![](/files/57d776af2410bc23744bf1247b9b8e063483cbcf)](https://helpcenter.channable.com/hc/article_attachments/22327676106002)
{% endstep %}

{% step %}

### Step 3: Create your product listings

Follow these steps to set up your channel.

{% stepper %}
{% step %}

#### Categorize your products

To set up your product data, assign categories to your products.

* AI product 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

[Learn more about categorizing for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step.md)
{% endstep %}

{% step %}

#### 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.

[Read more about using rules for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step.md)
{% endstep %}

{% step %}

#### Build your listings

The **Build** step is where you configure your product listings to match marketplace requirements. It’s essential 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 common fields that apply across your products, such as EAN, prices, and titles.
* Use static or dynamic values:
  * Static values: Fixed values that don’t change (e.g. brand name).
  * Dynamic values: Fields that change based on linked data (e.g. stock, prices).

Category-specific attributes:

* Category-specific attributes are fields that specifically apply to the category for your products (e.g. size for clothing or dimensions for furniture).
* Fill in attributes that are specific to the selected category.

{% hint style="success" %}
**Tip:** Click **Auto-map fields** to automatically map using information using information from your other channels or other similar setups. [Learn more](/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis.md).
{% endhint %}

[Learn more about the Build step for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step.md)
{% endstep %}

{% step %}

#### Check the quality of your setup

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.

[Learn more about the Quality step for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step.md)
{% endstep %}

{% step %}

#### 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 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.

[Learn more about the Preview step for marketplaces](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step.md)
{% endstep %}
{% endstepper %}

**Additional requirements for ANWB**

These attribute requirements are specific to ANWB and apply to the attributes in the **Build** step.

Item tab:

* Shipping class (logistic class): The logistic classes determine the respective shipping costs for your items. Enter the logistic class of your product.
* Lead time to ship: The shipping lead time indicates the time required until the package is handed over to the shipping. Indicate the shipping time in days.

Textual requirements: Not allowed:

* The formal address ‘u’. Instead, use the informal address ‘je/jij’.
* Links/URLs to other sources of information.
* References to your own website.
* Other business or commercial references (for example, discounts).
* Promotional call-to-action texts (for example, "Order now!", "What are you waiting for?").

Title requirements:

|                                    |                                                                                         |
| ---------------------------------- | --------------------------------------------------------------------------------------- |
| **Maximum length**                 | 56 characters                                                                           |
| **Structure**                      | Product name/type - Product category - Size/length                                      |
| **Special characters/expressions** | Must not contain: ‘!', ‘?’, ‘New’, ‘Action’, ‘Now with free ...’ or similar expressions |

Long description requirements:

|                                       |                                                             |
| ------------------------------------- | ----------------------------------------------------------- |
| **Maximum length**                    | 2000 characters                                             |
| **Titles, bullet points, paragraphs** | Use these to help with SEO                                  |
| **Content**                           | Avoid copying the product description from ANWB Marketplace |

Short description requirements:

|                    |                                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Maximum length** | 225 characters                                                                                                   |
| **SERP/SEO**       | This text also appears in SERP in Google for SEO purposes, so it is advisable to mention the brand at least once |

Image requirements:

|                                             |                                                         |
| ------------------------------------------- | ------------------------------------------------------- |
| **Minimum dimensions**                      | 550 x 550 pixels                                        |
| **Supported formats**                       | gif, jpeg, png, webp                                    |
| **Main image**                              | Freestanding, entire product. No packaging may be shown |
| **No watermarks, logos or text components** | Only the product itself should be shown                 |
| **Background**                              | Required and must be white. No black and white images   |

{% hint style="info" %}
Note: No rich media content (videos) can be uploaded yet.
{% endhint %}

Best practices:

* Adding multiple attribute values: When adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing.
* Seller's Product ID for Single/simple products: There are two attributes named `SellerArticleId` and `SellerProductId`. `SellerProductId` refers to the Parent ID, while `SellerArticleId` refers to the variant items. For single products, both attributes must be filled with the same value.

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out [our dedicated guide](/list-advertise/sell-on-marketplaces/mirakl-marketplaces.md).
{% endstep %}

{% step %}

### Step 4: Send your product listings to ANWB

Once your product listings are ready:

* If you have not activated your project, go to **\[Your project] > Settings** and click **Activate project**.
* In **\[Your project] > APIs**, go to **\[Your ANWB API] > Settings**.
* Click on **Activate API**.
* Once you have activated the API, navigate back to **APIs**.
* Click the **Run now** button in the 'Status' column to send your product listings to ANWB.
  {% endstep %}

{% step %}

### Step 5: Check your product listings for errors

* To check for errors, navigate to the **Result page of the API > Errors** tab. Here you will see a list of the product listings that have errors.
* Click on the specific error to display more information about what is causing the error.

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-a-anwb-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.