Best Practices

Recommendations for getting the most out of your Bol.com Integration.

Initial Setup

Start Small

1. Test with few products first

   • Create a profile with narrow conditions
   • Select 5-10 products to start
   • Verify everything works before scaling up

2. Use On Hold mode

   • Enable "On Hold" in Product Profile
   • Review offers in grid before going live
   • Disable On Hold when ready to publish

3. Test in demo mode

   • Use Bol.com sandbox credentials first
   • Verify offer creation and order import
   • Switch to production when confident

EAN Quality

1. Validate EANs before publishing

   • Ensure all EANs are 13 digits
   • Verify EANs exist in Bol.com catalog
   • Fix invalid EANs before enabling profiles

2. Use dedicated EAN attribute

   • Create a specific EAN attribute in Magento
   • Don't rely on SKU unless SKUs are EANs
   • Makes mapping clearer and more reliable

Product Profiles

Organize by Purpose

Create separate profiles for:

• New vs Refurbished - Different conditions
• Fast vs Slow sellers - Different pricing strategies
• Categories - Electronics, clothing, etc.
• Seasonal items - Holiday products with specific timing

Condition Settings

1. Set realistic conditions

   • Don't over-complicate with too many rules
   • Test conditions with small product sets first
   • Use AND logic thoughtfully

2. Monitor condition matches

   • Check which products match after processing
   • Adjust conditions if too many/few products match
   • Review periodically as catalog changes

Pricing Strategy

1. Use markup percentage wisely

   • Account for Bol.com fees
   • Consider shipping costs in your margin
   • Test pricing against competitors

2. Price rounding

   • Use .99 or .95 endings for psychological pricing
   • Be consistent across your catalog
   • Match your brand's pricing strategy

Order Management

Import Settings

1. Set appropriate start date

   • Don't backdate too far initially
   • Avoid importing already-fulfilled orders
   • Adjust after initial sync is complete

2. Customer handling

   • Enable customer import for repeat buyers
   • Use appropriate customer group for Bol.com customers
   • Consider separate group for marketplace orders

Fulfillment Workflow

1. FBR orders

   • Process quickly to meet delivery promises
   • Use accurate carrier mapping
   • Add tracking immediately when shipping

2. FBB orders

   • Enable auto-ship for FBB items
   • Monitor inventory levels at Bol.com
   • Plan replenishment ahead

Synchronization

Cron Configuration

1. Set appropriate frequencies

   • Order import: Every 15-30 minutes
   • Offer export: Every 1-2 hours
   • Shipment export: Every 15-30 minutes

2. Monitor cron health

   • Check that jobs are running
   • Review error logs regularly
   • Set up monitoring alerts if possible

Auto Push

1. Enable for real-time sync

   • Price changes sync immediately
   • Stock changes sync immediately
   • Reduces delay in updates

2. Consider performance impact

   • High-volume stores may need batch updates
   • Monitor server load during peak times
   • Adjust batch sizes if needed

Inventory Management

Stock Accuracy

1. Keep stock in sync

   • Update Magento stock promptly
   • Consider safety stock for marketplace
   • Avoid overselling across channels

2. Multi-channel considerations

   • Reserve stock for each channel
   • Update all channels quickly
   • Consider inventory management tools

Out of Stock Handling

1. Monitor low stock
   • Set reorder alerts
   • Update offers before running out
   • Consider automatic deactivation rules

Monitoring & Maintenance

Regular Checks

Daily:

• Check for new orders
• Review export errors
• Process pending shipments

Weekly:

• Review offer sync status
• Check competing offers
• Analyze pricing position

Monthly:

• Review profile performance
• Clean up old data
• Update pricing strategies

Error Handling

1. Monitor error columns in grids

   • Check Offers grid for sync errors
   • Review Orders grid for import issues
   • Fix errors promptly

2. Enable debug logging when needed

   • Turn on for troubleshooting
   • Review logs for patterns
   • Turn off after debugging

Performance Optimization

Batch Sizes

1. Adjust for your server

   • Start with default sizes
   • Increase if server handles well
   • Decrease if timeouts occur

2. Process during low traffic

   • Schedule heavy syncs off-peak
   • Monitor server resources
   • Balance real-time vs batch needs

Database Maintenance

1. Keep tables clean
   • Archive old order data
   • Clean up obsolete offers
   • Maintain indexes

Security

API Credentials

1. Keep credentials secure

   • Don't share credentials
   • Use separate credentials per environment
   • Rotate credentials periodically

2. Access control

   • Limit admin access to module settings
   • Use Magento ACL for team access
   • Audit changes regularly

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team