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:
- A Bol.com order is shipped in Magento
- A Magento invoice exists for the order
- The shipment is successfully exported to Bol.com
The system then:
- Generates a PDF from the Magento invoice
- Uploads the PDF to Bol.com via their API
- 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:
- Navigate to Bol.com → Data → Invoices
- Select invoices with status "Pending" or "Error"
- 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:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team