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:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team