Configuration Guide

Complete reference for all e-Boekhouden module settings. Configuration is split between the base module (General) and the e-Boekhouden-specific settings.

Locations:

Stores → Configuration → Accounting → General (base settings)
Stores → Configuration → Accounting → e-Boekhouden.nl (platform settings)

General Settings (Accounting Base)

Location: Stores → Configuration → Accounting → General

General

Setting	Description	Recommended
Enabled	Enable/disable the accounting module	Yes
Start Date	No data syncs before this date	Start of fiscal year

Automation

Setting	Description	Recommended
Auto add invoices and creditmemos	Automatically queue new invoices/credit memos	Yes
Auto add customers	Automatically queue new customers	Yes

Advanced

Setting	Description	Recommended
Prefix Creditmemo	Add prefix to credit memo numbers	Yes
Creditmemo Prefix	The prefix value	C
Prefix Invoice	Add prefix to invoice numbers	No (unless multi-store)
Invoice Prefix	The prefix value	-
Customer Sync Logic	How customers are matched	Default
Force Base Currency Usage	Always use base currency	Only for multi-currency

Customer Sync Logic Options

Option	Behavior
Default	Uses Customer logic (see below)
Customer	One e-Boekhouden debtor per Magento customer. Unique check on: customer_id, country_id, vat_number
Address	One e-Boekhouden debtor per billing address. Unique check on: customer_id, country_id, vat_number, billing_address_id

Note: If the unique check fails (e.g., customer changes country or VAT number), a new debtor is created as these affect tax rates.

e-Boekhouden Settings

Location: Stores → Configuration → Accounting → e-Boekhouden.nl

e-Boekhouden.nl (Module Control)

Setting	Description	Options
Module Status	Enable/disable e-Boekhouden sync	Yes/No
Synchronization	Cron frequency for syncing	Every 5/15/30/60 minutes, Daily

Connection

Setting	Description	Scope
Enabled	Enable connection for this scope	Store View
Account	Your e-Boekhouden account (read-only)	Store View
User name	API username	Store View
Security Code 1	First security code (encrypted)	Store View
Security Code 2	Second security code (encrypted)	Store View

Finding credentials: In e-Boekhouden go to Beheer → Instellingen → Koppelingen tab → API/SOAP

Scope: Connection can be configured per store view, website, or default.

Ledger Accounts & Cost Centers

Ledger Accounts

Setting	Description
Product	Default ledger for product sales. Can be overridden per product.
Shipping	Ledger for shipping costs
Adjustment Fee	Ledger for adjustments
Payment/Extra Fee	Ledger for payment surcharges

Cost Centers

Setting	Description
Use Cost Centers	Enable cost center tracking
Product	Cost center for products
Shipping	Cost center for shipping
Adjustment Fee	Cost center for adjustments
Payment/Extra Fee	Cost center for payment fees

Sync Button: Click "Sync Ledger & Costs from e-Boekhouden" to import available ledgers and cost centers from your e-Boekhouden account.

Synchronization

Setting	Description	Options
Document type	How sales data is sent	Factuur, Mutatie, Dynamic
Default Type	Fallback when using Dynamic	Factuur/Mutatie
Type per method	Different type per payment method	Dynamic only
Factuursjabloon	Invoice template name	Factuur only
Betalingstermijn	Payment term in days	0-365
Description Invoice	Invoice description pattern	Variables available
Description Creditmemo	Credit memo description pattern	Variables available

Document Type Options

Type	Description
Factuur	Creates invoice document in e-Boekhouden
Mutatie	Creates mutation entry (recommended for webshops)
Dynamic	Type based on payment method

Description Variables

For invoices:

{invoice_number} - Magento invoice number
{order_number} - Magento order number
{transaction} - Payment transaction ID

For credit memos:

{creditmemo_number} - Magento credit memo number
{order_number} - Magento order number
{transaction} - Payment transaction ID

Advanced Settings

Default Tax Classes (Fallback)

Setting	Description
With Tax	Fallback tax code for orders with tax
No Tax	Fallback tax code for orders without tax
EU No Tax	Fallback for intra-EU VAT exempt (ICP/ICL)
No EU No Tax	Fallback for non-EU orders without tax

Note: These are only used when no match is found in Tax Rate Mapping (e.g., after migrations or imports).

Mini One Stop Shop (MOSS)

Setting	Description
Enable MOSS	Enable MOSS tax handling
Ledger	Ledger for MOSS tax rows
Mapping	Country-to-cost-center mapping

MOSS allows accounting for VAT due in multiple EU countries in one country.

Advanced Ledgers

Setting	Description
Enable Advanced Ledger Mapping	Enable product-level ledger mapping
Mapping	Attribute-based ledger assignment

Customers

Setting	Description
Overwrite customer code	Replace existing customer codes with module-generated ones

Recalculate

Setting	Description
Force Recalculate	Recalculate all items before syncing

Debug & Logging

Setting	Description
Debug Mode	Enable verbose logging
Debug Log	View/download debug.log
Error Log	View/download error.log
Self Test	Run diagnostic tests

Log locations:

Debug: var/log/eboekhouden/debug.log
Errors: var/log/eboekhouden/error.log

Multi-Store Configuration

The module supports different configurations per scope:

Setting Level	What to configure
Default	Module status, cron frequency, automation
Website	General ledger settings, tax classes
Store View	Connection credentials, specific ledgers

Example setup:

Dutch store: Connect to main e-Boekhouden account
Belgian store: Connect to separate e-Boekhouden account (or different settings)

Configuration Checklist

Module enabled
Connection credentials entered and tested
Ledgers imported from e-Boekhouden
Default ledgers configured (Product, Shipping)
Tax Rate Mapping completed
Automation enabled
Cron frequency set
Test invoice synced successfully

Need More Help?

Documentation:

All Help Articles - Complete documentation overview

Support:

Contact Support - Get help from our team

On this page

Product Information

General Settings (Accounting Base)

General

Automation

Advanced

Customer Sync Logic Options

e-Boekhouden Settings

e-Boekhouden.nl (Module Control)

Connection

Ledger Accounts & Cost Centers

Ledger Accounts

Cost Centers

Synchronization

Document Type Options

Description Variables

Advanced Settings

Default Tax Classes (Fallback)

Mini One Stop Shop (MOSS)

Advanced Ledgers

Customers

Recalculate

Debug & Logging

Multi-Store Configuration

Configuration Checklist

Need More Help?

The Magento and Shopware
development firm

Quick Links

Last Update Plugins

Pages

Reviews Plugins

Accounting Plugins

Marketplace Plugins

Company

Support

Office Hours

GitHub