Setup OSS Tax rules with Snelstart and Magento 2
This guide explains how to configure One Stop Shop (OSS) tax rules using SnelStart with Magento 2. OSS simplifies VAT reporting for EU distance sales by allowing you to report all EU VAT through your home country's tax authority.
Tip: Not sure which OSS ledger accounts 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.
What is OSS?
One Stop Shop (OSS) is an EU VAT scheme for distance selling to consumers in other EU countries:
- Before OSS: Register for VAT in each EU country where you exceed thresholds
- With OSS: Report all EU VAT through one registration in your home country
- Threshold: €10,000 annual EU distance sales (combined all countries)
Prerequisites
Before configuring OSS in Magento:
-
Enable OSS in SnelStart first
- This must be done in your SnelStart application
- See: SnelStart Kennisplein
-
Configure EU VAT rates in Magento
- Each destination country needs its VAT rate configured
-
Verify EU country list in Magento
- Stores → Configuration → General → Country Options
- Check European Union Countries list
Step 1: Configure VAT Rates in Magento
- Go to Stores → Tax Zones and Rates
- Add each EU country with their local VAT rate:
| Country | Standard Rate | Reduced Rate |
|---|---|---|
| Germany | 19% | 7% |
| France | 20% | 5.5% |
| Belgium | 21% | 6% |
| Spain | 21% | 10% |
| Italy | 22% | 10% |
| Austria | 20% | 10% |
| Poland | 23% | 8% |
| Netherlands | 21% | 9% |
- Go to Stores → Tax Rules
- Create tax rules that apply the correct rates based on destination country
Step 2: Enable OSS in Magento
- Go to Stores → Configuration → Accounting → SnelStart
- Navigate to One Stop Shop section
- Set Enabled to Yes
Step 3: Configure OSS Ledgers
Configure which ledger accounts to use for OSS sales:
| Setting | Description | Typical Value |
|---|---|---|
| Ledger: Standaard | Default OSS sales ledger | 8080 - Omzet afstandsverk. binnen EU |
| Ledger: Verlaagd hoog | Reduced high rate OSS ledger | (select appropriate) |
| Ledger: Verlaagd laag | Reduced low rate OSS ledger | (select appropriate) |
| Ledger: Super verlaagd | Super reduced rate OSS ledger | (select appropriate) |
| VAT Ledger | VAT liability account | 1700 - Te betalen EU VAT |
Note: Click "Sync Ledger & Costs from SnelStart" first to import available ledgers.
Step 4: Country Mapping (Advanced)
For specific ledger accounts per country:
- In the Country Mapping section
- Add mappings for countries needing different ledgers
- Each country can have its own:
- Sales ledger
- VAT ledger
This is useful when you need to track sales per country separately.
Step 5: Verify Configuration
-
Check connection status:
- One Stop Shop field should show your OSS status from SnelStart
-
Place a test order:
- Create an order from an EU country (not your home country)
- Customer should be a consumer (B2C)
- Create the invoice
-
Verify in sync logs:
- Go to Accounting → Synchronisation Logs → Invoice
- Check the OSS invoice synced correctly
-
Verify in SnelStart:
- Open the synced invoice
- Confirm it's booked to OSS ledger
- Check VAT is recorded to VAT Ledger
How OSS Invoices Are Processed
When an invoice is synced:
-
System checks: Is destination an EU country? Is buyer a consumer?
-
If OSS applies:
- Uses OSS ledger accounts instead of standard product ledgers
- Records VAT to the OSS VAT Ledger
- Applies destination country VAT rate
-
If OSS doesn't apply:
- B2B sales → Normal intra-EU rules (reverse charge)
- Same country → Normal domestic VAT
- Outside EU → Export/non-EU rules
OSS Reporting in SnelStart
For quarterly OSS reporting:
- Open SnelStart
- Go to reports/VAT section
- Generate OSS report for the quarter
- Submit to Belastingdienst
The module ensures correct ledger booking for easy OSS report generation.
Troubleshooting
OSS not being applied
Check:
- Is OSS enabled in SnelStart?
- Is OSS enabled in Magento configuration?
- Is the destination country in EU list?
- Is the customer a consumer (not B2B with VAT number)?
Wrong ledger used for OSS
Check:
- OSS ledger configuration in Magento
- Country mapping overrides
- Ensure ledgers are synced from SnelStart
VAT rate incorrect
Check:
- Magento tax rules for destination country
- Tax rate configuration in Stores → Tax Zones and Rates
OSS status shows "Not enabled"
- Enable OSS in SnelStart application first
- Reconnect OAuth to refresh status
- Verify your SnelStart subscription includes OSS
B2B vs B2C
OSS only applies to B2C (consumer) sales:
| Customer Type | VAT Treatment |
|---|---|
| Consumer (no VAT number) | OSS - destination country VAT |
| Business with VAT number | Reverse charge (0%, ICP/ICL) |
The module automatically determines this based on whether the customer has a VAT number.
Need More Help?
External Resources:
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team