Gebruik van het Magento 2 SnelStart CLI-commando voor debugging en validatie

Niet zeker welke grootboekrekeningen of BTW tarieven te gebruiken in Magento? Deze gids laat zien hoe u een testfactuur handmatig aanmaakt in SnelStart, en die data vervolgens ophaalt in Magento om precies te zien welke waarden u nodig heeft. Deze "reverse engineering" aanpak haalt het giswerk uit de configuratie.

Waarom Deze Aanpak Werkt

Bij het opzetten van de SnelStart integratie moet u configureren:

Product grootboekrekeningen per BTW tarief
BTW tarief mappings
OSS instellingen (indien van toepassing)

In plaats van gissen of zoeken door SnelStart documentatie, kunt u:

Een echte factuur handmatig aanmaken in SnelStart (zoals uw boekhouder het verwacht)
Het CLI commando gebruiken om die factuurdata op te halen
Precies zien welke grootboek en BTW codes SnelStart gebruikte
Magento configureren om overeen te komen

Stap 1: Maak Testfacturen in SnelStart

Voor een Standaard Nederlandse Verkoop (21% BTW)

Maak een factuur met:

Een product met 21% BTW (hoog tarief)
Boek het zoals uw boekhouder normaal zou doen

Voor Verlaagd Tarief (9% BTW)

Maak een factuur met:

Een product met 9% BTW (laag tarief) - voeding, boeken, etc.

Voor Nultarief / Export

Maak facturen voor:

EU B2B verkoop (intracommunautair, 0%)
Export buiten EU (0%)

Voor OSS (indien van toepassing)

Maak een factuur voor:

B2C verkoop aan EU consument (bijv. Duitse klant)
Gebruik het lokale BTW tarief van dat land

Stap 2: Haal de Facturen Op via CLI

Na het aanmaken van testfacturen in SnelStart, gebruik de CLI om ze op te halen.

Recente Transacties Ophalen

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

Dit toont uw recente transacties. Vind degene die u net heeft aangemaakt door te kijken naar factuurnummers of datums.

Transactie Details Ophalen

Kopieer de UUID van uw testfactuur en haal volledige details op:

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

Stap 3: Analyseer de Output

Het commando retourneert gedetailleerde informatie over hoe SnelStart uw factuur heeft geboekt.

Belangrijke Velden om te Noteren

Veld	Wat Het U Vertelt	Gebruik In Magento
grootboek.id	Grootboekrekening nummer	Product Hoog/Laag/etc. dropdown
grootboek.omschrijving	Grootboekrekening naam	Verifieer dat het de juiste is
btwSoort	BTW classificatie	Tax Rate Mapping
bedrag	Bedrag	Verifieer berekeningen

Voorbeeld Output Analyse

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

Dit vertelt u:

Grootboekrekening 8000 ("Omzet binnenland hoog") wordt gebruikt voor hoog tarief verkoop
BTW type is Hoog (21%)

Stap 4: Configureer Magento om Overeen te Komen

Configureer nu Magento met de waarden die u heeft ontdekt.

Grootboekrekeningen

Ga naar: Winkels → Configuratie → Accounting → SnelStart → Ledger Accounts

Klik op "Sync Ledger & Costs from SnelStart" om beschikbare grootboekrekeningen te importeren
Voor Product Hoog: Selecteer de grootboekrekening die u vond (bijv. 8000 - Omzet binnenland hoog)
Voor Product Laag: Selecteer de grootboekrekening van uw 9% testfactuur
Ga door voor elke BTW tarief categorie

Tax Rate Mapping

Ga naar: Accounting → Configuration → Tax Rate Mapping

Map uw Magento belastingregels naar SnelStart BTW types op basis van wat u vond:

Uw Magento Belastingregel	Stel SnelStart In Op
NL BTW 21%	Hoog
NL BTW 9%	Laag
EU Intracommunautair	Binnen EU
Export	Buiten EU

Stap 5: Test de Configuratie

Test nu dat Magento facturen correct aanmaakt.

Maak een Test Order

Plaats een testorder in Magento
Maak een factuur voor de order
Wacht op sync (of push handmatig)

Verifieer in SnelStart

Controleer de gesynchroniseerde factuur in SnelStart:

Staat het op de juiste grootboekrekening?
Is het BTW type correct?
Komen de bedragen overeen?

Of Gebruik CLI om te Verifiëren

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

Vergelijk de output met uw handmatig aangemaakte testfactuur - ze moeten overeenkomen.

Configuratie Mapping Spiekbriefje

Gebruik deze tabel om wat u vindt in SnelStart te mappen naar Magento instellingen:

SnelStart btwSoort	Magento BTW Type	Typische Grootboekrekening
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)

Let op: Werkelijke grootboekrekening nummers variëren per SnelStart account. Verifieer altijd met uw specifieke setup.

Veelvoorkomende Scenario's

"Ik weet niet welke grootboekrekening te gebruiken voor verzending"

Maak een handmatige factuur in SnelStart die verzending bevat
Haal het op via CLI
Controleer welke grootboek werd gebruikt voor de verzendregel
Configureer dat in Magento onder Shipping grootboekrekeningen

"OSS is verwarrend - welke grootboekrekening voor Duitse klanten?"

Maak een handmatige B2C factuur in SnelStart voor een Duitse klant
Gebruik het Duitse BTW tarief (19%)
Haal op via CLI en noteer de gebruikte OSS grootboekrekening
Configureer dat in Magento's OSS instellingen

"Mijn boekhouder gebruikt verschillende grootboekrekeningen voor verschillende product types"

Maak handmatige facturen voor elk product type
Noteer de verschillende gebruikte grootboekrekeningen
Schakel Advanced Ledger Mapping in Magento in
Map product attributen naar specifieke grootboekrekeningen

Tips

Maak meerdere testfacturen - één voor elk scenario dat u verwacht (binnenland, EU, export, etc.)
Betrek uw boekhouder - laat hen de testfacturen aanmaken zodat ze correct geboekt zijn
Documenteer uw bevindingen - houd een referentie bij van welke grootboekrekeningen mappen naar welke scenario's
Test voor u live gaat - verifieer altijd met testorders voor het verwerken van echte verkopen

Meer Hulp Nodig?

Documentatie:

Alle Help Artikelen - Compleet documentatie overzicht

Support:

Contact Opnemen - Hulp van ons team

Snelstart koppeling