Using the Magento 2 SnelStart CLI Command for Debugging and Validation

Not sure which ledger accounts or tax rates to use in Magento? This guide shows you how to create a test invoice manually in SnelStart, then pull that data into Magento to see exactly which values you need. This "reverse engineering" approach takes the guesswork out of configuration.

Why This Approach Works

When setting up the SnelStart integration, you need to configure:

Product ledger accounts (grootboekrekeningen) per tax rate
Tax rate mappings
OSS settings (if applicable)

Instead of guessing or searching through SnelStart documentation, you can:

Create a real invoice manually in SnelStart (the way your accountant expects it)
Use the CLI command to fetch that invoice's data
See exactly which grootboek and BTW codes SnelStart used
Configure Magento to match

Step 1: Create Test Invoices in SnelStart

Log into SnelStart and manually create test invoices that represent your typical sales scenarios.

For a Standard Dutch Sale (21% BTW)

Create an invoice with:

A product at 21% BTW (hoog tarief)
Book it the way your accountant normally would

For Reduced Rate (9% BTW)

Create an invoice with:

A product at 9% BTW (laag tarief) - food, books, etc.

For Zero Rate / Export

Create invoices for:

EU B2B sale (intracommunautair, 0%)
Export outside EU (0%)

For OSS (if applicable)

Create an invoice for:

B2C sale to EU consumer (e.g., German customer)
Use the local VAT rate of that country

Step 2: Fetch the Invoices via CLI

After creating test invoices in SnelStart, use the CLI to retrieve them.

Get Recent Transactions

bin/magento accounting:check:snelstart --top=10

This shows your recent transactions. Find the ones you just created by looking at the invoice numbers or dates.

Get Transaction Details

Copy the UUID of your test invoice and fetch full details:

bin/magento accounting:check:snelstart --id=<UUID>

Step 3: Analyze the Output

The command returns detailed information about how SnelStart booked your invoice.

Key Fields to Note

Field	What It Tells You	Use In Magento
grootboek.id	Ledger account number	Product Hoog/Laag/etc. dropdown
grootboek.omschrijving	Ledger account name	Verify it's the right one
btwSoort	Tax classification	Tax Rate Mapping
bedrag	Amount	Verify calculations

Example Output Analysis

{
  "grootboek": {
    "id": 8000,
    "omschrijving": "Omzet binnenland hoog"
  },
  "btwSoort": "Hoog",
  "bedrag": 100.00
}

This tells you:

Ledger account 8000 ("Omzet binnenland hoog") is used for high-rate sales
BTW type is Hoog (21%)

Step 4: Configure Magento to Match

Now configure Magento using the values you discovered.

Ledger Accounts

Go to: Stores → Configuration → Accounting → SnelStart → Ledger Accounts

Click "Sync Ledger & Costs from SnelStart" to import available ledgers
For Product Hoog: Select the ledger you found (e.g., 8000 - Omzet binnenland hoog)
For Product Laag: Select the ledger from your 9% test invoice
Continue for each tax rate category

Tax Rate Mapping

Go to: Accounting → Configuration → Tax Rate Mapping

Map your Magento tax rules to SnelStart BTW types based on what you found:

Your Magento Tax Rule	Set SnelStart To
NL BTW 21%	Hoog
NL BTW 9%	Laag
EU Intracommunautair	Binnen EU
Export	Buiten EU

Step 5: Test the Configuration

Now test that Magento creates invoices correctly.

Create a Test Order

Place a test order in Magento
Create an invoice for the order
Wait for sync (or manually push)

Verify in SnelStart

Check the synced invoice in SnelStart:

Is it on the correct ledger account?
Is the BTW type correct?
Do the amounts match?

Or Use CLI to Verify

bin/magento accounting:check:snelstart --top=1

Compare the output with your manually created test invoice - they should match.

Configuration Mapping Cheat Sheet

Use this table to map what you find in SnelStart to Magento settings:

SnelStart btwSoort	Magento Tax Type	Typical Ledger
Hoog	Product Hoog	8000-series (Omzet hoog)
Laag	Product Laag	8100-series (Omzet laag)
Nultarief	Product Nultarief	8200-series
GeenBtw	Product Buiten EU	8300-series (Export)
VerleggingsregBinn	Product Binnen EU	8400-series (ICP)

Note: Actual ledger numbers vary per SnelStart account. Always verify with your specific setup.

Common Scenarios

"I don't know which ledger to use for shipping"

Create a manual invoice in SnelStart that includes shipping
Fetch it via CLI
Check which grootboek was used for the shipping line
Configure that in Magento under Shipping ledgers

"OSS is confusing - which ledger for German customers?"

Create a manual B2C invoice in SnelStart for a German customer
Use the German VAT rate (19%)
Fetch via CLI and note the OSS grootboek used
Configure that in Magento's OSS settings

"My accountant uses different ledgers for different product types"

Create manual invoices for each product type
Note the different grootboeken used
Enable Advanced Ledger Mapping in Magento
Map product attributes to specific ledgers

Tips

Create multiple test invoices - one for each scenario you expect (domestic, EU, export, etc.)
Involve your accountant - have them create the test invoices so they're booked correctly
Document your findings - keep a reference of which ledgers map to which scenarios
Test before going live - always verify with test orders before processing real sales

Need More Help?

Documentation:

All Help Articles - Complete documentation overview

Support:

Contact Support - Get help from our team

Snelstart Integration