Snelstart Integration

Version v2.5.1
Platform Magento 2
Released 12 December 2025

SnelStart Configuration Guide

Complete reference for all SnelStart module settings. Configuration is split between the base module (General) and the SnelStart-specific settings. The key difference from other accounting integrations is that SnelStart uses OAuth for connection and organizes ledgers by tax rate category.

Tip: Not sure which ledger accounts or tax rates to use? See Setup Helper: Configure Magento Using SnelStart Data to learn how to create a test invoice in SnelStart and fetch the exact values you need.

Locations:

  • Stores → Configuration → Accounting → General (base settings)
  • Stores → Configuration → Accounting → SnelStart (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 SnelStart debtor per Magento customer. Unique check on: customer_id, country_id, vat_number
Address One SnelStart 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. This is intentional because country and VAT number affect tax rates.

SnelStart Settings

Location: Stores → Configuration → Accounting → SnelStart

SnelStart (Module Control)

Setting Description Options
Enabled Enable/disable SnelStart sync Yes/No
Synchronization Cron frequency for syncing Every 5/15/30/60 minutes, Daily

Connection

Unlike other accounting integrations, SnelStart uses OAuth. You don't enter API credentials manually.

Setting Description
Enabled Enable connection for this scope
Account Your SnelStart account (read-only, imported)
Company Your company name (read-only, imported)
One Stop Shop OSS status from SnelStart (read-only)
Connect Button Opens SnelStart login for authorization

To connect: Click the connect button, log in to SnelStart, and authorize the Magmodules application. After successful connection, the Account and Company fields populate automatically.

Scope: Connection can be configured per store view, allowing different SnelStart accounts for different stores.

Ledger Accounts & Cost Centers

SnelStart organizes ledgers by tax rate category. This means you configure a separate ledger for each VAT rate (21%, 9%, 0%, etc.) rather than one general ledger for all sales.

Why tax-rate based ledgers? SnelStart requires revenue to be booked to ledgers that match the VAT rate. A 21% sale goes to a "high rate" ledger, 9% to a "low rate" ledger, etc. This ensures correct VAT reporting.

Product Ledgers

Setting Tax Rate Use for
Product Hoog 21% Standard products (most items)
Product Laag 9% Reduced rate items (food, books, medicine)
Product Overig Other Non-standard VAT rates
Product Nultarief 0% Zero-rated domestic sales
Product Buiten EU Non-EU Exports outside EU (0% VAT)
Product Binnen EU Intra-EU B2B sales within EU with reverse charge (ICP)

Sync Button: Click "Sync Ledger & Costs from SnelStart" to import available ledgers from your SnelStart account before configuring these fields.

Shipping Ledgers

Setting Description
Use same as product Yes = shipping uses product ledgers (most common), No = configure separate shipping ledgers

When set to "No", you can specify separate ledgers for shipping costs per tax rate (Shipping Hoog, Shipping Laag, etc.). Most shops use the same ledgers as products.

Adjustment Fee & Extra Fee Ledgers

Same structure as shipping - choose to use product ledgers or configure separate ones. These apply to:

  • Adjustment Fee: Order adjustments and modifications
  • Extra Fee: Payment surcharges and additional fees

One Stop Shop (OSS)

OSS is the EU VAT scheme for distance selling to consumers in other EU countries. Instead of registering for VAT in each country, you report all EU VAT through the Dutch Belastingdienst.

Important: Enable OSS in SnelStart first, then configure here.

Setting Description
Enabled Enable OSS processing for EU consumer sales
Ledger: Standaard Default OSS ledger (typically 8080)
Ledger: Verlaagd hoog For reduced high rate items
Ledger: Verlaagd laag For reduced low rate items
Ledger: Super verlaagd For super reduced rate items
VAT Ledger Where OSS VAT liability is recorded (typically 1700)
Country Mapping Override ledgers per EU country (advanced)

When OSS applies: B2C sales to EU consumers (without VAT number) in countries other than Netherlands. B2B sales with VAT numbers use reverse charge instead.

Advanced Settings

Default Tax Classes (Fallback)

Setting Use when
With Tax Order has tax but no Tax Rate Mapping match found
No Tax Order has no tax and no mapping match
EU No Tax Intra-EU VAT exempt (ICP/ICL) with no mapping
No EU No Tax Non-EU order without tax and no mapping

Note: These fallbacks are only used when Tax Rate Mapping doesn't have a match - typically after data migrations or imports. Properly configured mappings should handle all cases.

Advanced Ledgers

Setting Description
Enable Advanced Ledger Mapping Enable product attribute-based ledger mapping
Mapping Attribute-value to ledger mapping

Use case: When different product categories need different ledgers. For example, you might want digital products on a different ledger than physical products. Map a product attribute (like "product_type") to specific ledgers.

Customers

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

Only enable if you want Magento to control customer code generation. Leave disabled if you have existing customers in SnelStart with codes you want to preserve.

Numbering and Descriptions

Setting Description
Invoice Number How invoice numbers are generated
Invoice Invoice description pattern
Creditmemo Credit memo description pattern

Description Variables:

  • {invoice_number} - Magento invoice number
  • {creditmemo_number} - Magento credit memo number
  • {order_number} - Magento order number
  • {transaction} - Payment transaction ID
  • {transaction_clean} - Transaction ID without special characters

Example: "Order {order_number}" becomes "Order 100000123"

Debug & Logging

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

Log locations:

  • Debug: var/log/snelstart/debug.log
  • Errors: var/log/snelstart/error.log

Configuration Checklist

  • Module enabled
  • Connection authorized via OAuth
  • Ledgers imported from SnelStart
  • Product ledgers configured per tax rate
  • Tax Rate Mapping completed
  • OSS configured (if applicable)
  • Automation enabled
  • Cron frequency set
  • Test invoice synced successfully

Need More Help?

Documentation:

Support:

Created:
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