Configureer de Beslist.nl Winkelwagen
Volledige referentie voor het configureren van de Beslist.nl Winkelwagen Connect extensie. Deze handleiding legt elke instelling uit om u te helpen uw Beslist.nl integratie te optimaliseren, van basis feed generatie tot geavanceerde bestelimport en real-time voorraad synchronisatie. Of u nu product exports instelt, verzendregels configureert of order fulfillment automatiseert, deze referentie behandelt alle configuratie opties die beschikbaar zijn in de module.
Configuratie Pad: Winkels → Configuratie → Magmodules
De module heeft twee hoofdsecties:
- Beslist.nl Feed - Product feed configuratie
- Beslist.nl Orders & Items - Bestelimport en ShopItem API
Beslist.nl Feed Configuratie
Algemene Instellingen
Pad: Beslist.nl Feed → General
Inschakelen
Standaard: Nee
Schakel de Beslist.nl feed module in.
Self-test
Klik om diagnostische tests uit te voeren op uw feed configuratie. Controleert:
- Attribuut mappings
- Feed generatie
- Product beschikbaarheid
- Vereiste velden
Attributes
Pad: Beslist.nl Feed → Attributes
Koppel uw Magento product attributen aan Beslist.nl feed vereisten.
Algemene Velden
Name
- Type: Attribuut selector
- Vereist: Ja
Productnaam voor de feed. Meestal "Product Naam" attribuut.
Conditioneel/Meerdere Opties:
- Selecteer "Conditional" om verschillende attributen te gebruiken op basis van condities
- Selecteer "Multiple" om meerdere attributen te combineren
Description
- Type: Attribuut selector
- Vereist: Ja
Product beschrijving. Meestal "Beschrijving" of "Korte Beschrijving".
Let op: HTML wordt geconverteerd naar platte tekst met \n voor regeleinden.
Brand
- Type: Attribuut selector
- Vereist: Aanbevolen
Fabrikant of merk attribuut. Belangrijk voor product categorisatie op Beslist.nl.
EAN-code
- Type: Attribuut selector
- Vereist: Sterk aanbevolen
GTIN/EAN barcode. Helpt Beslist.nl om producten correct te matchen.
Product Afbeeldingen
Source
- Opties:
- Base Image Only - Exporteer alleen de hoofdafbeelding
- All Images - Exporteer alle product afbeeldingen
Main Image (wanneer "All Images" geselecteerd)
- First Image - Gebruik eerste afbeelding als hoofd
- Base Image - Gebruik basis afbeelding als hoofd
Aanbeveling: Gebruik "All Images" met "Base Image" voor beste product presentatie.
Extra Velden
Optionele velden die product listings verbeteren, vooral voor fashion items.
SKU Product SKU/artikelnummer.
Size (Apparel) Kledingmaten (S, M, L, XL, etc.).
Size (Non-apparel) Andere maat specificaties (afmetingen, volume, etc.).
Color Product kleur attribuut.
Material Materiaal samenstelling (katoen, polyester, leer, etc.).
Gender Doelgroep geslacht (Man, Vrouw, Unisex).
Aanbeveling: Configureer deze voor mode en kleding producten. Beslist.nl gebruikt ze om variant codes te maken voor betere product matching.
Product Conditie
Condition Type
- Static - Zelfde conditie voor alle producten
- Attribute - Gebruik product attribuut
Default Value (als Static)
- Nieuw
- Als nieuw
- Gebruikt
Aanbeveling: Gebruik "Static" met "Nieuw" tenzij u tweedehands/refurbished items verkoopt.
Levertijd - Nederland
Configureer levertijd getoond aan Nederlandse klanten.
Delivery Time Type
- Static - Vaste tekst voor alle producten
- Attribute - Gebruik product attribuut
In Stock Levertijd voor producten op voorraad. Voorbeelden: "1-2 werkdagen", "24 uur"
Out of Stock Levertijd voor producten niet op voorraad. Aanbeveling: Gebruik "niet op voorraad" om uit feed te excluderen
Backorders Levertijd voor backorder producten. Voorbeeld: "2-3 weken"
Dynamische Waarden: U kunt attribuut waarden opnemen met `` syntax. Voorbeeld: "Verwacht op "
Levertijd - België
Zelfde configuratie als Nederland, maar voor Belgische klanten.
Aanbeveling: Belgische levering duurt meestal 1 dag langer dan NL.
Beslist Product Categorie
Skip Category
- Type: Multi-select
Categorieën om uit te sluiten van het categorie pad. Gebruik dit om categorieën zoals "SALE", "BRAND", etc. te verwijderen die niet nuttig zijn voor Beslist.nl.
Category if Empty Fallback categorie voor producten zonder categorie toewijzing.
Product Types
Pad: Beslist.nl Feed → Product Types
Configurable/Simple Products
Use Configurable/Simple Products
- Parent Only - Exporteer alleen configureerbaar product
- Simple Products Only - Exporteer alleen gekoppelde simple producten
- Both - Exporteer zowel parent als simples
Aanbeveling: "Simple Products Only" - exporteert varianten als individuele producten.
Use Parent Image for Simples
- Never - Gebruik altijd simple product afbeeldingen
- Only if Empty - Gebruik parent afbeelding als simple geen afbeelding heeft
- Always - Gebruik altijd parent afbeelding
Aanbeveling: "Only if Empty"
Use Parent Data for Simples Multi-select welke attributen te erven van parent:
- Description
- Short Description
- Meta Data
- Brand
- EAN
- etc.
Aanbeveling: Selecteer attributen die hetzelfde zijn voor alle varianten (Merk, Beschrijving) maar niet variant-specifieke attributen (Kleur, Maat).
Use Fallback only on Non Visible Simples
- Ja - Pas alleen overerving toe op "Niet Zichtbaar Individueel" producten
- Nee - Pas toe op alle simple producten
Aanbeveling: Ja - zichtbare simples worden behandeld als standalone producten.
Geavanceerde Opties
Pad: Beslist.nl Feed → Advanced Options
Extra Velden
Voeg aangepaste product features toe aan de feed.
Extra Fields Table:
- Name - Feature naam
- Attribute - Te gebruiken product attribuut
Let op: Alleen gebruiken op verzoek van Beslist.nl om feed fouten te voorkomen.
Verzendkosten
Configureer verzendkosten voor Nederland en België.
Calculation
- Price - Op basis van product prijs
- Weight - Op basis van product gewicht
Shipping Settings Table:
- Country - NL of BE
- From - Minimum prijs/gewicht
- To - Maximum prijs/gewicht
- Shipping Cost - Kosten in euro's
Voorbeeld Setup:
NL | 0.00 | 50.00 | 5.95 (Betaalde verzending onder €50)
NL | 50.01 | 999999 | 0.00 (Gratis verzending boven €50)
BE | 0.00 | 75.00 | 7.95 (Betaalde verzending onder €75)
BE | 75.01 | 999999 | 0.00 (Gratis verzending boven €75)
Aanbeveling: Match uw daadwerkelijke verzendtabel of gebruik vaste tarieven vereist door Beslist.nl.
Tax
Tax Calculation
- Exclude Tax - Toon prijzen exclusief BTW
- Include Tax - Toon prijzen inclusief BTW
Aanbeveling: "Include Tax" - Beslist.nl toont prijzen inclusief BTW aan consumenten.
Filter Opties
Pad: Beslist.nl Feed → Filter Options
Bepaal welke producten verschijnen in de feed.
Filter op Zichtbaarheid
Enable Activeer zichtbaarheid filtering.
Only add products with the following Visibility Multi-select:
- Not Visible Individually
- Catalog
- Search
- Catalog, Search
Aanbeveling: Selecteer "Catalog, Search" om hoofd producten op te nemen.
Filter op Categorie
Enable Activeer categorie filtering.
Type of Filter
- Include - Alleen producten in geselecteerde categorieën
- Exclude - Alle producten behalve die in geselecteerde categorieën
Category Multi-select categorieën om te includeren/excluderen.
Let op voor Include: Simple producten binnen configurables moeten ook in de categorie staan.
Let op voor Exclude: Producten in meerdere categorieën moeten van allemaal uitgesloten worden.
Geavanceerde Filters
Enable Activeer geavanceerde attribuut-gebaseerde filtering.
Filter Conditions Table:
- Attribute - Product attribuut
- Condition - Gelijk aan, Niet gelijk aan, Groter dan, etc.
- Value - Vergelijkingswaarde
Voorbeeld Use Cases:
- Excludeer producten onder bepaalde prijs
- Includeer alleen specifieke merken
- Filter op voorraad niveau
- Includeer alleen producten met afbeeldingen
Feed Generatie Instellingen
Pad: Beslist.nl Feed → Feed Generation Settings
Feed Generatie
Enable Schakel feed generatie in voor deze store view.
Filename Aangepaste bestandsnaam voor de feed (zonder extensie). Standaard: "beslist"
Feed URL: https://uwwinkel.nl/pub/media/beslist/{filename}.xml
Cronjob
Enable Activeer automatische feed generatie via cron.
Frequency
- Every hour
- Every 2 hours
- Every 6 hours
- Every 12 hours
- Daily
- Custom
Custom Frequency
Cron expressie voor aangepaste planning.
Voorbeeld: 0 */4 * * * (elke 4 uur)
Aanbeveling: "Every 6 hours" voor de meeste winkels. Frequenter als voorraad snel wijzigt.
Geavanceerde Instellingen
Enable Activeer geavanceerde generatie opties.
Products per Batch Splits grote catalogi in batches om geheugengebruik te verminderen.
Voorbeeld: Voor 50.000 producten, gebruik 5.000 per batch.
Debug Memory Usage
Log geheugengebruik naar var/log/beslist.log voor troubleshooting.
Beslist.nl Orders & Items Configuratie
OrderXML Bestelimport
Pad: Beslist.nl Orders & Items → OrderXML Order Import
Importeer Beslist.nl Winkelwagen bestellingen in Magento.
Enable
Activeer bestelimport functionaliteit.
API Instellingen
Modus
- Disabled - Schakel bestelimport uit
- Test - Test modus voor ontwikkeling
- Live - Productie bestelimport
Order XML Key API key verstrekt door Beslist.nl.
Client ID Client identificatie van Beslist.nl.
Shop ID Winkel identificatie van Beslist.nl.
Day Limit Importeer alleen bestellingen van de laatste X dagen. Standaard: 7 dagen
Product Id(s) (Alleen test modus) Comma-gescheiden product IDs om test bestellingen te simuleren. Voorbeeld: "4,8,15,16"
Verzendmethode
Default Shipping Method Selecteer welke Magento verzendmethode toe te wijzen aan Beslist.nl bestellingen.
Aanbeveling: Maak een toegewijde "Beslist.nl" verzendmethode om feed verzendkosten te behouden.
Select a fallback Shipping Method Alternatief als standaard niet beschikbaar is.
Klanten
Import Customers Maak klantaccounts aan voor Beslist.nl bestellingen.
Customer Group Welke klantgroep toe te wijzen aan Beslist.nl klanten.
Adres & Factuur
Separate housenumber
- Ja - Split huisnummer naar tweede straat regel
- Nee - Houd in enkele straat regel
Create invoice for order Maak automatisch factuur aan bij importeren bestelling.
Use Beslist Order ID Gebruik Beslist.nl order ID in plaats van Magento increment ID.
Send order email to customer Verstuur Magento bestel bevestiging email.
Aanbeveling: Meestal uitgeschakeld omdat Beslist.nl hun eigen bevestigingen verstuurt.
Cronjob
Automation Schakel automatische bestel controle en import in.
Frequency
- Every 15 minutes
- Every 30 minutes
- Every hour
- Every 2 hours
- Custom
Custom Frequency Cron expressie voor aangepaste planning.
Fully Automate Order Import
- Ja - Bestellingen automatisch aangemaakt in Magento
- Nee - Bestellingen gaan naar Beslist.nl order grid voor handmatige review
Aanbeveling: Schakel in na testen om orderflow te automatiseren.
Mislukte Bestelling Email
Enable Verstuur email wanneer bestelimport faalt.
Email From Afzender identiteit.
Email To Ontvanger email adres.
Email Template Template voor mislukte bestel notificaties.
Debugging
Enable
Log bestel imports naar var/log/beslist.log.
Aanbeveling: Schakel in tijdens setup, uitschakelen in productie voor prestaties.
ShopItem API Updates
Pad: Beslist.nl Orders & Items → ShopItem API Updates
Real-time prijs en voorraad synchronisatie.
Enable
Activeer ShopItem API functionaliteit.
API Instellingen
Modus
- Disabled
- Test
- Live
API Key ShopItem API key van Beslist.nl.
Shop ID Selecteer uw winkel uit de dropdown (gevuld na opslaan API key).
Automation
Modus
- Per Single Item - Update één product per keer
- Per Batch - Update meerdere producten samen
Aanbeveling: "Per Batch" voor winkels met frequente wijzigingen.
Limit Maximum aantal items per update run. Voorbeeld: 1000
Invalidation
Modus
- Observer - Detecteer wijzigingen wanneer product wordt opgeslagen
- Cronjob - Controleer periodiek op wijzigingen
Aanbeveling:
- Observer - Bij handmatig beheren producten in Magento
- Cronjob - Bij gebruik van externe product/voorraad beheer systemen
Cron
Enabled Activeer geplande API updates.
Frequency
- Every 15 minutes
- Every 30 minutes
- Every hour
- Every 2 hours
- Custom
Aanbeveling: Match met uw voorraad update frequentie.
Logging
Enabled Log API calls en updates.
Clean Logs by cron Verwijder automatisch oude logs.
Clean After x Days Aantal dagen om logs te behouden. Standaard: 14 dagen
Show Debug Message Toon gedetailleerde API responses in logs.
Aanbevolen Configuratie
Basis Setup (Alleen Feed)
- General: Schakel module in
- Attributes: Map Naam, Beschrijving, Merk, EAN, Afbeelding
- Delivery Time: Configureer NL en BE levertijden
- Shipping: Stel prijs-gebaseerde verzending in voor NL en BE
- Product Types: Gebruik "Simple Products Only" voor configurables
- Feed Generation: Schakel in met 6-uurs frequentie
- Test: Voer self-test uit en verifieer feed
Geavanceerde Setup (Volledige Integratie)
Alles van Basis Setup, plus:
- Order Import: Configureer OrderXML API in test modus
- Test Orders: Importeer test bestellingen en verifieer
- Order Import: Schakel naar live modus, schakel automation in
- ShopItem API: Configureer in test modus
- ShopItem API: Schakel naar live, schakel cron updates in
- Monitoring: Schakel logging in, configureer fail alerts
Mode/Kleding Winkels
Extra configuratie voor kleding/schoenen:
- Additional Fields: Map Size (Apparel), Kleur, Materiaal, Geslacht
- Variants: Gebruik "Simple Products Only" om alle maten/kleuren te exporteren
- Parent Data: Erf Merk en Beschrijving over van configureerbaar parent
Grote Catalogi (10.000+ producten)
- Batch Size: Stel in op 2.000-5.000 producten per batch
- Cron Frequency: Feed elke 12 uur (off-peak)
- ShopItem Limit: 1.000-2.000 items per run
- Memory Debug: Schakel tijdelijk in om batch size te optimaliseren
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team