Configure the Beslist.nl Winkelwagen

Path: Beslist.nl Feed → General

Enable

Default: No

Enable the Beslist.nl feed module.

Self-test

Click to run diagnostic tests on your feed configuration. Checks:

• Attribute mappings
• Feed generation
• Product availability
• Required fields

Path: Beslist.nl Feed → Attributes

Map your Magento product attributes to Beslist.nl feed requirements.

General Fields

Name

• Type: Attribute selector
• Required: Yes

Product name for the feed. Usually "Product Name" attribute.

Conditional/Multiple Options:

• Select "Conditional" to use different attributes based on conditions
• Select "Multiple" to combine multiple attributes

Description

• Type: Attribute selector
• Required: Yes

Product description. Usually "Description" or "Short Description".

Note: HTML will be converted to plain text with \n for line breaks.

Brand

• Type: Attribute selector
• Required: Recommended

Manufacturer or brand attribute. Important for product categorization on Beslist.nl.

EAN-code

• Type: Attribute selector
• Required: Highly recommended

GTIN/EAN barcode. Helps Beslist.nl match products correctly.

Product Images

Source

• Options:
  • Base Image Only - Export only the main product image
  • All Images - Export all product images

Main Image (when "All Images" selected)

• First Image - Use first image as main
• Base Image - Use base image as main

Recommendation: Use "All Images" with "Base Image" for best product presentation.

Additional Fields

Optional fields that improve product listings, especially for fashion items.

SKU Product SKU/article number.

Size (Apparel) Clothing sizes (S, M, L, XL, etc.).

Size (Non-apparel) Other size specifications (dimensions, volume, etc.).

Color Product color attribute.

Material Material composition (cotton, polyester, leather, etc.).

Gender Target gender (Male, Female, Unisex).

Recommendation: Configure these for fashion and apparel products. Beslist.nl uses them to create variant codes for better product matching.

Product Condition

Condition Type

• Static - Same condition for all products
• Attribute - Use product attribute

Default Value (if Static)

• Nieuw (New)
• Als nieuw (Like New)
• Gebruikt (Used)

Recommendation: Use "Static" with "Nieuw" unless selling used/refurbished items.

Delivery Time - Netherlands

Configure delivery time shown to Dutch customers.

Delivery Time Type

• Static - Fixed text for all products
• Attribute - Use product attribute

In Stock Delivery time for in-stock products. Examples: "1-2 werkdagen", "24 uur"

Out of Stock Delivery time for out-of-stock products. Recommendation: Use "niet op voorraad" to exclude from feed

Backorders Delivery time for backorder products. Example: "2-3 weken"

Dynamic Values: You can include attribute values using `` syntax. Example: "Verwacht op "

Delivery Time - Belgium

Same configuration as Netherlands, but for Belgian customers.

Recommendation: Belgian delivery typically takes 1 day longer than NL.

Beslist Product Category

Skip Category

• Type: Multi-select

Categories to exclude from the category path. Use this to remove categories like "SALE", "BRAND", etc. that aren't useful for Beslist.nl.

Category if Empty Fallback category for products without category assignment.

Path: Beslist.nl Feed → Product Types

Configurable/Simple Products

Use Configurable/Simple Products

• Parent Only - Export configurable product only
• Simple Products Only - Export linked simple products only
• Both - Export both parent and simples

Recommendation: "Simple Products Only" - exports variants as individual products.

Use Parent Image for Simples

• Never - Always use simple product images
• Only if Empty - Use parent image if simple has none
• Always - Always use parent image

Recommendation: "Only if Empty"

Use Parent Data for Simples Multi-select which attributes to inherit from parent:

• Description
• Short Description
• Meta Data
• Brand
• EAN
• etc.

Recommendation: Select attributes that are same across variants (Brand, Description) but not variant-specific attributes (Color, Size).

Use Fallback only on Non Visible Simples

• Yes - Only apply inheritance to "Not Visible Individually" products
• No - Apply to all simple products

Recommendation: Yes - visible simples are treated as standalone products.

Path: Beslist.nl Feed → Advanced Options

Extra Fields

Add custom product features to the feed.

Extra Fields Table:

• Name - Feature name
• Attribute - Product attribute to use

Note: Only use on request from Beslist.nl to prevent feed errors.

Shipping Prices

Configure shipping costs for Netherlands and Belgium.

Calculation

• Price - Based on product price
• Weight - Based on product weight

Shipping Settings Table:

• Country - NL or BE
• From - Minimum price/weight
• To - Maximum price/weight
• Shipping Cost - Cost in euros

Example Setup:

NL | 0.00   | 50.00    | 5.95  (Paid shipping under €50)
NL | 50.01  | 999999   | 0.00  (Free shipping over €50)
BE | 0.00   | 75.00    | 7.95  (Paid shipping under €75)
BE | 75.01  | 999999   | 0.00  (Free shipping over €75)

Recommendation: Match your actual shipping table or use flat rates required by Beslist.nl.

Tax

Tax Calculation

• Exclude Tax - Show prices excluding VAT
• Include Tax - Show prices including VAT

Recommendation: "Include Tax" - Beslist.nl shows prices including VAT to consumers.

Path: Beslist.nl Feed → Filter Options

Control which products appear in the feed.

Filter on Visibility

Enable Activate visibility filtering.

Only add products with the following Visibility Multi-select:

• Not Visible Individually
• Catalog
• Search
• Catalog, Search

Recommendation: Select "Catalog, Search" to include main products.

Filter by Category

Enable Activate category filtering.

Type of Filter

• Include - Only products in selected categories
• Exclude - All products except those in selected categories

Category Multi-select categories to include/exclude.

Note for Include: Simple products within configurables must also be in the category.

Note for Exclude: Products in multiple categories must be excluded from all of them.

Advanced Filters

Enable Activate advanced attribute-based filtering.

Filter Conditions Table:

• Attribute - Product attribute
• Condition - Equals, Not Equals, Greater Than, etc.
• Value - Comparison value

Example Use Cases:

• Exclude products under certain price
• Only include specific brands
• Filter by stock level
• Include only products with images

Path: Beslist.nl Feed → Feed Generation Settings

Feed Generation

Enable Enable feed generation for this store view.

Filename Custom filename for the feed (without extension). Default: "beslist"

Feed URL: https://yourstore.com/pub/media/beslist/{filename}.xml

Cronjob

Enable Activate automatic feed generation via cron.

Frequency

• Every hour
• Every 2 hours
• Every 6 hours
• Every 12 hours
• Daily
• Custom

Custom Frequency Cron expression for custom scheduling. Example: 0 */4 * * * (every 4 hours)

Recommendation: "Every 6 hours" for most stores. More frequent if inventory changes rapidly.

Advanced Settings

Enable Activate advanced generation options.

Products per Batch Split large catalogs into batches to reduce memory usage.

Example: For 50,000 products, use 5,000 per batch.

Debug Memory Usage Log memory usage to var/log/beslist.log for troubleshooting.

Path: Beslist.nl Orders & Items → OrderXML Order Import

Import Beslist.nl Winkelwagen orders into Magento.

Enable

Activate order import functionality.

API Settings

Modus

• Disabled - Turn off order import
• Test - Test mode for development
• Live - Production order import

Order XML Key API key provided by Beslist.nl.

Client ID Client identifier from Beslist.nl.

Shop ID Shop identifier from Beslist.nl.

Day Limit Only import orders from the last X days. Default: 7 days

Product Id(s) (Test mode only) Comma-separated product IDs to simulate test orders. Example: "4,8,15,16"

Shipping Method

Default Shipping Method Select which Magento shipping method to assign to Beslist.nl orders.

Recommendation: Create a dedicated "Beslist.nl" shipping method to preserve feed shipping costs.

Select a fallback Shipping Method Alternative if default is unavailable.

Customers

Import Customers Create customer accounts for Beslist.nl orders.

Customer Group Which customer group to assign Beslist.nl customers.

Address & Invoice

Separate housenumber

• Yes - Split house number to second street line
• No - Keep in single street line

Create invoice for order Automatically create invoice when importing order.

Use Beslist Order ID Use Beslist.nl order ID instead of Magento increment ID.

Send order email to customer Send Magento order confirmation email.

Recommendation: Usually disabled as Beslist.nl sends their own confirmations.

Cronjob

Automation Enable automatic order checking and import.

Frequency

• Every 15 minutes
• Every 30 minutes
• Every hour
• Every 2 hours
• Custom

Custom Frequency Cron expression for custom scheduling.

Fully Automate Order Import

• Yes - Orders automatically created in Magento
• No - Orders go to Beslist.nl order grid for manual review

Recommendation: Enable after testing to automate order flow.

Failed Order Email

Enable Send email when order import fails.

Email From Sender identity.

Email To Recipient email address.

Email Template Template for failed order notifications.

Debugging

Enable Log order imports to var/log/beslist.log.

Recommendation: Enable during setup, disable in production for performance.

Path: Beslist.nl Orders & Items → ShopItem API Updates

Real-time price and stock synchronization.

Enable

Activate ShopItem API functionality.

API Settings

Modus

• Disabled
• Test
• Live

API Key ShopItem API key from Beslist.nl.

Shop ID Select your shop from the dropdown (populated after saving API key).

Automation

Modus

• Per Single Item - Update one product at a time
• Per Batch - Update multiple products together

Recommendation: "Per Batch" for stores with frequent changes.

Limit Maximum number of items per update run. Example: 1000

Invalidation

Modus

• Observer - Detect changes when product is saved
• Cronjob - Periodically check for changes

Recommendation:

• Observer - When manually managing products in Magento
• Cronjob - When using external product/stock management systems

Cron

Enabled Activate scheduled API updates.

Frequency

• Every 15 minutes
• Every 30 minutes
• Every hour
• Every 2 hours
• Custom

Recommendation: Match with your inventory update frequency.

Logging

Enabled Log API calls and updates.

Clean Logs by cron Automatically delete old logs.

Clean After x Days Number of days to retain logs. Default: 14 days

Show Debug Message Display detailed API responses in logs.

1. General: Enable module
2. Attributes: Map Name, Description, Brand, EAN, Image
3. Delivery Time: Configure NL and BE delivery times
4. Shipping: Set up price-based shipping for NL and BE
5. Product Types: Use "Simple Products Only" for configurables
6. Feed Generation: Enable with 6-hour frequency
7. Test: Run self-test and verify feed

Everything from Basic Setup, plus:

8. Order Import: Configure OrderXML API in test mode
9. Test Orders: Import test orders and verify
10. Order Import: Switch to live mode, enable automation
11. ShopItem API: Configure in test mode
12. ShopItem API: Switch to live, enable cron updates
13. Monitoring: Enable logging, configure fail alerts

Additional configuration for clothing/shoes:

• Additional Fields: Map Size (Apparel), Color, Material, Gender
• Variants: Use "Simple Products Only" to export all sizes/colors
• Parent Data: Inherit Brand and Description from configurable parent

• Batch Size: Set to 2,000-5,000 products per batch
• Cron Frequency: Feed every 12 hours (off-peak)
• ShopItem Limit: 1,000-2,000 items per run
• Memory Debug: Enable temporarily to optimize batch size