Bol.com Integration

Version v1.7.0
Platform Magento 2
Last Updated 16 January 2026

Bol.com Invoice Grid in Magento 2

Since 1.7.0

The Invoices Grid shows all customer invoices queued for upload to Bol.com. Invoices are automatically queued when shipments are exported and can be uploaded manually or via cron.

Location: Bol.com → Data → Invoices

Why Use This?

Proactively uploading invoices provides several benefits:

  • Better customer experience - Invoices appear directly in the customer's Bol.com account
  • Fewer support requests - Customers don't need to request invoices manually
  • Faster processing - No waiting for customer invoice requests
  • Automation - Invoices are uploaded automatically after shipment

Without proactive upload, customers must manually request an invoice through Bol.com, which creates extra work for both the customer and merchant.

Columns

Column Description
ID Internal invoice queue ID
Account Bol.com seller account
Bol Order Original order ID from Bol.com
Magento Order Linked Magento order increment ID
Magento Invoice Linked Magento invoice increment ID
Status Upload status (see below)
Created At When the invoice was queued
Actions Upload single invoice

Mass Actions

Select multiple invoices and use:

Action Description
Upload Upload selected invoices to Bol.com
Delete Delete selected invoices from the queue

How Invoices Enter This Grid

Invoices are automatically queued when:

  1. A Bol.com order is shipped in Magento
  2. A Magento invoice exists for the order
  3. The shipment is successfully exported to Bol.com

The system then:

  1. Generates a PDF from the Magento invoice
  2. Uploads the PDF to Bol.com via their API
  3. Updates the status accordingly

Status Explained

Status Meaning
Pending Queued, waiting to be uploaded
Queued In the upload queue
Synced Successfully uploaded to Bol.com
Error Upload failed, will retry (up to 3 attempts)
Failed Permanently failed after 3 attempts or permanent error

Bol.com Requirements

Invoices uploaded to Bol.com must meet these requirements:

Requirement Details
Format PDF only
File size Maximum 2 MB

Note: Once uploaded, invoices cannot be deleted via the API. Deletion is only possible through the Bol.com Seller Dashboard.

Manual Invoice Upload

To manually upload invoices:

  1. Navigate to Bol.com → Data → Invoices
  2. Select invoices with status "Pending" or "Error"
  3. Use mass action Upload

Or via CLI:

bin/magento magmodules-bol:upload-invoices

Tips

  • Check Status column for failed uploads to investigate issues
  • Invoices in Error status will automatically retry up to 3 times
  • Failed invoices need manual intervention - check the error message
  • Large invoices (>2MB) will permanently fail - simplify the PDF template
  • Upload runs automatically via cron if configured

Need More Help?

Documentation:

Support:

Article Updated:
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025
star star star star star
star star star star star
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
Google 18 Jun 2025
star star star star star
star star star star star
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
Google 13 Jun 2025