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

[![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/EgEcoNYPBnkGDNHWTNpE/21547535658642)](https://helpcenter.channable.com/hc/article_attachments/21547535658642)

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

|                                                                                                                                                                                   |                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/LsZL7iuyEyE4zhIyIYk5/21547520301586)](https://helpcenter.channable.com/hc/article_attachments/21547520301586) | [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/mQlTdDpBWm6Oqt5EDEli/21547520302354)](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.

[![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/SEvNmxmxDrqzlflvvUFL/22327676106002)](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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step)
{% 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step)
{% 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

[Learn more about the Build step for marketplaces](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-build-step)
{% 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step)
{% 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step)
{% 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces).
{% 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 %}