SnelStart Configuratiegids
Volledige referentie voor alle SnelStart module instellingen. Configuratie is verdeeld tussen de basismodule (General) en de SnelStart-specifieke instellingen. Het belangrijkste verschil met andere boekhoudintegraties is dat SnelStart OAuth gebruikt voor verbinding en grootboekrekeningen organiseert op BTW tarief categorie.
Tip: Niet zeker welke grootboekrekeningen of BTW tarieven te gebruiken? Zie Setup Helper: Configureer Magento Met SnelStart Data om te leren hoe u een testfactuur aanmaakt in SnelStart en de exacte waarden ophaalt die u nodig heeft.
Locaties:
- Winkels → Configuratie → Accounting → General (basis instellingen)
- Winkels → Configuratie → Accounting → SnelStart (platform instellingen)
Algemene Instellingen (Accounting Base)
Locatie: Winkels → Configuratie → Accounting → General
General
| Instelling | Beschrijving | Aanbevolen |
|---|---|---|
| Enabled | Schakel de boekhoudmodule in/uit | Yes |
| Start Date | Geen data synchroniseert voor deze datum | Start van fiscaal jaar |
Automation
| Instelling | Beschrijving | Aanbevolen |
|---|---|---|
| Auto add invoices and creditmemos | Automatisch nieuwe facturen/creditnota's in wachtrij | Yes |
| Auto add customers | Automatisch nieuwe klanten in wachtrij | Yes |
Advanced
| Instelling | Beschrijving | Aanbevolen |
|---|---|---|
| Prefix Creditmemo | Voeg prefix toe aan creditnota nummers | Yes |
| Creditmemo Prefix | De prefix waarde | C |
| Prefix Invoice | Voeg prefix toe aan factuur nummers | Nee (tenzij multi-store) |
| Invoice Prefix | De prefix waarde | - |
| Customer Sync Logic | Hoe klanten worden gematched | Default |
| Force Base Currency Usage | Altijd basisvaluta gebruiken | Alleen voor multi-currency |
Customer Sync Logic Opties
| Optie | Gedrag |
|---|---|
| Default | Gebruikt Customer logica (zie hieronder) |
| Customer | Eén SnelStart debiteur per Magento klant. Unieke check op: customer_id, country_id, vat_number |
| Address | Eén SnelStart debiteur per factuuradres. Unieke check op: customer_id, country_id, vat_number, billing_address_id |
Opmerking: Als de unieke check mislukt (bijv. klant wijzigt land of BTW-nummer), wordt een nieuwe debiteur aangemaakt. Dit is opzettelijk omdat land en BTW-nummer invloed hebben op belastingtarieven.
SnelStart Instellingen
Locatie: Winkels → Configuratie → Accounting → SnelStart
SnelStart (Module Control)
| Instelling | Beschrijving | Opties |
|---|---|---|
| Enabled | Schakel SnelStart sync in/uit | Yes/No |
| Synchronization | Cron frequentie voor synchronisatie | Elke 5/15/30/60 minuten, Dagelijks |
Connection
Anders dan andere boekhoudintegraties gebruikt SnelStart OAuth. U voert geen API credentials handmatig in.
| Instelling | Beschrijving |
|---|---|
| Enabled | Schakel verbinding in voor deze scope |
| Account | Uw SnelStart account (alleen-lezen, geïmporteerd) |
| Company | Uw bedrijfsnaam (alleen-lezen, geïmporteerd) |
| One Stop Shop | OSS status van SnelStart (alleen-lezen) |
| Connect Button | Opent SnelStart login voor autorisatie |
Om te verbinden: Klik op de connect knop, log in bij SnelStart en autoriseer de Magmodules applicatie. Na succesvolle verbinding worden de Account en Company velden automatisch gevuld.
Scope: Verbinding kan per storeview geconfigureerd worden, waardoor verschillende SnelStart accounts voor verschillende stores mogelijk zijn.
Ledger Accounts & Cost Centers
SnelStart organiseert grootboekrekeningen op BTW tarief categorie. Dit betekent dat u een aparte grootboekrekening configureert voor elk BTW tarief (21%, 9%, 0%, etc.) in plaats van één algemene grootboekrekening voor alle verkopen.
Waarom BTW-tarief gebaseerde grootboekrekeningen? SnelStart vereist dat omzet geboekt wordt op grootboekrekeningen die overeenkomen met het BTW tarief. Een verkoop met 21% BTW gaat naar een "hoog tarief" grootboekrekening, 9% naar een "laag tarief" grootboekrekening, etc. Dit zorgt voor correcte BTW-rapportage.
Product Grootboekrekeningen
| Instelling | BTW Tarief | Gebruik voor |
|---|---|---|
| Product Hoog | 21% | Standaard producten (meeste items) |
| Product Laag | 9% | Verlaagd tarief items (voeding, boeken, medicijnen) |
| Product Overig | Overig | Niet-standaard BTW tarieven |
| Product Nultarief | 0% | Nultarief binnenlandse verkoop |
| Product Buiten EU | Buiten-EU | Export buiten EU (0% BTW) |
| Product Binnen EU | Intra-EU | B2B verkoop binnen EU met verlegging (ICP) |
Sync Knop: Klik op "Sync Ledger & Costs from SnelStart" om beschikbare grootboekrekeningen te importeren van uw SnelStart account voordat u deze velden configureert.
Verzending Grootboekrekeningen
| Instelling | Beschrijving |
|---|---|
| Use same as product | Yes = verzending gebruikt product grootboekrekeningen (meest gebruikelijk), No = configureer aparte verzending grootboekrekeningen |
Wanneer ingesteld op "No", kunt u aparte grootboekrekeningen specificeren voor verzendkosten per BTW tarief (Shipping Hoog, Shipping Laag, etc.). De meeste winkels gebruiken dezelfde grootboekrekeningen als producten.
Adjustment Fee & Extra Fee Grootboekrekeningen
Dezelfde structuur als verzending - kies om product grootboekrekeningen te gebruiken of configureer aparte. Deze zijn van toepassing op:
- Adjustment Fee: Order aanpassingen en wijzigingen
- Extra Fee: Betalingstoeslagen en extra kosten
One Stop Shop (OSS)
OSS is de EU BTW-regeling voor afstandsverkoop aan consumenten in andere EU-landen. In plaats van BTW registreren in elk land, rapporteert u alle EU BTW via de Nederlandse Belastingdienst.
Belangrijk: Schakel OSS eerst in SnelStart in, configureer daarna hier.
| Instelling | Beschrijving |
|---|---|
| Enabled | Schakel OSS verwerking in voor EU consumentenverkoop |
| Ledger: Standaard | Standaard OSS grootboekrekening (typisch 8080) |
| Ledger: Verlaagd hoog | Voor verlaagd hoog tarief items |
| Ledger: Verlaagd laag | Voor verlaagd laag tarief items |
| Ledger: Super verlaagd | Voor super verlaagd tarief items |
| VAT Ledger | Waar OSS BTW-aansprakelijkheid wordt vastgelegd (typisch 1700) |
| Country Mapping | Overschrijf grootboekrekeningen per EU land (geavanceerd) |
Wanneer OSS van toepassing is: B2C verkoop aan EU consumenten (zonder BTW-nummer) in landen anders dan Nederland. B2B verkoop met BTW-nummer gebruikt verlegging in plaats daarvan.
Advanced Settings
Default Tax Classes (Fallback)
| Instelling | Gebruik wanneer |
|---|---|
| With Tax | Order heeft BTW maar geen Tax Rate Mapping match gevonden |
| No Tax | Order heeft geen BTW en geen mapping match |
| EU No Tax | Intra-EU BTW vrijgesteld (ICP/ICL) zonder mapping |
| No EU No Tax | Niet-EU order zonder BTW en geen mapping |
Opmerking: Deze fallbacks worden alleen gebruikt wanneer Tax Rate Mapping geen match heeft - typisch na datamigraties of imports. Correct geconfigureerde mappings dekken alle gevallen.
Advanced Ledgers
| Instelling | Beschrijving |
|---|---|
| Enable Advanced Ledger Mapping | Schakel product attribuut-gebaseerde grootboekrekening mapping in |
| Mapping | Attribuut-waarde naar grootboekrekening mapping |
Use case: Wanneer verschillende productcategorieën verschillende grootboekrekeningen nodig hebben. Bijvoorbeeld, u wilt digitale producten op een andere grootboekrekening dan fysieke producten. Map een productattribuut (zoals "product_type") naar specifieke grootboekrekeningen.
Customers
| Instelling | Beschrijving |
|---|---|
| Overwrite customer code | Vervang bestaande SnelStart klantcodes met module-gegenereerde codes |
Schakel alleen in als u wilt dat Magento klantcode generatie beheert. Laat uitgeschakeld als u bestaande klanten in SnelStart heeft met codes die u wilt behouden.
Numbering and Descriptions
| Instelling | Beschrijving |
|---|---|
| Invoice Number | Hoe factuurnummers worden gegenereerd |
| Invoice | Factuur omschrijving patroon |
| Creditmemo | Creditnota omschrijving patroon |
Omschrijving Variabelen:
{invoice_number}- Magento factuurnummer{creditmemo_number}- Magento creditnota nummer{order_number}- Magento ordernummer{transaction}- Betaling transactie ID{transaction_clean}- Transactie ID zonder speciale tekens
Voorbeeld: "Order {order_number}" wordt "Order 100000123"
Debug & Logging
| Instelling | Beschrijving |
|---|---|
| Debug Mode | Schakel verbose logging in (uitschakelen in productie) |
| Debug Log | Bekijk/download debug.log |
| Error Log | Bekijk/download error.log |
| Self Test | Voer diagnostische tests uit |
Log locaties:
- Debug:
var/log/snelstart/debug.log - Errors:
var/log/snelstart/error.log
Configuratie Checklist
- Module ingeschakeld
- Verbinding geautoriseerd via OAuth
- Grootboekrekeningen geïmporteerd van SnelStart
- Product grootboekrekeningen geconfigureerd per BTW tarief
- Tax Rate Mapping voltooid
- OSS geconfigureerd (indien van toepassing)
- Automatisering ingeschakeld
- Cron frequentie ingesteld
- Test factuur succesvol gesynchroniseerd
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team