OSS Tax Rules for Magento 2 Setup

This guide explains how to set up One Stop Shop (OSS) VAT handling with the Yuki Connection for Magento 2. OSS is the EU VAT scheme that lets you report cross-border B2C sales through a single registration instead of registering in every destination country. If your store sells to consumers in other EU countries and you've crossed the €10,000 annual threshold, you need OSS. This guide covers what Yuki needs, how to set it up in Magento, and how to verify it's working correctly.

What is OSS?

One Stop Shop (OSS) is an EU VAT scheme for distance selling to consumers in other EU countries.

• Before OSS: You had to register for VAT in each EU country where you exceeded local thresholds.
• With OSS: You report all EU cross-border VAT through one registration in your home country. For Dutch merchants, that's the Belastingdienst.
• Threshold: €10,000 in annual EU distance sales (combined across all countries). Once you exceed this, destination country VAT rates apply to your B2C orders.

How Yuki Handles OSS

Most accounting platforms require you to maintain a mapping of destination country to tax code. Yuki doesn't work that way.

Yuki resolves the correct OSS BTW code automatically from three pieces of data sent on each invoice line:

• VATType 40 - the OSS type code
• VATPercentage - the destination country's VAT rate (e.g. 19% for Germany)
• VATCountry - the destination country code (e.g. DE)

This means you don't need country-to-tax-code mapping in Magento. You just need to:

1. Create matching BTW tax codes in Yuki for each destination country
2. Configure EU VAT rates in Magento
3. Select which EU countries to apply OSS for in the module settings

Prerequisites

Before configuring OSS:

1. Register for OSS with the Belastingdienst
2. Create BTW tax codes in Yuki for each EU destination country (see Step 1 below)
3. Configure EU VAT rates in Magento (Stores → Tax Zones and Rates)
4. Verify your EU country list in Magento (Stores → Configuration → General → Country Options)

Step 1: Create BTW Tax Codes in Yuki

For each EU country you sell to, create a BTW-tarief in the Yuki web application:

1. Go to the Yuki web application
2. Navigate to BTW-tarieven
3. Add a new BTW code for each destination country

Example for Germany:

• Name: OSS Duitsland
• Type: 40 (OSS)
• Percentage: 19%
• Land: DE

Common EU VAT rates:

Tip: Only create BTW codes for countries you actually sell to. You only need to set up what you'll use.

Step 2: Configure VAT Rates in Magento

1. Go to Stores → Tax Zones and Rates
2. Add each EU destination country with their local VAT rate
3. Go to Stores → Tax Rules
4. Create tax rules that apply the correct rates based on the destination country

Make sure the percentages in Magento match exactly what you entered in Yuki. Yuki matches on the exact VATPercentage value.

Step 3: Enable OSS in Magento

1. Go to Stores → Configuration → Accounting → Yuki
2. Navigate to Advanced Settings → One Stop Shop (OSS)
3. Set Enable OSS to Yes
4. In OSS Countries, select the EU countries you want to apply OSS for
5. Click Save Config

Important: Only select countries for which you have created BTW codes in Yuki (Step 1). If Yuki can't find a matching BTW code, the invoice sync will fail with an error.

Step 4: Verify Configuration

1. Place a test order from an EU country (not NL) as a consumer (B2C, no VAT number)
2. Create the invoice for the order
3. Sync to Yuki via manual push from the grid, or wait for the next cron run
4. Go to Accounting → Synchronisation Logs → Invoice and check for success
5. Verify in Yuki that the invoice was created with VATType 40 and the correct country code

How OSS Invoices Are Processed

When an invoice is synced, the module checks each line item:

1. Is OSS enabled?
2. Does the item have tax > 0%?
3. Is the shipping country in the OSS countries list?

If OSS applies:

• VATType is set to 40 (OSS)
• VATPercentage is the item's tax percentage
• VATCountry is set to the destination country code
• Yuki resolves the matching BTW code automatically

If OSS does not apply, the module falls back to standard rules:

• B2B sales with 0% tax → Intra-community (ICP) rules (ExportBinnenEU, type 7)
• Same country (NL) → Normal domestic VAT
• Outside EU → Export rules
• Country not in OSS list → Normal tax rules

B2B vs B2C

OSS only applies to B2C (consumer) sales. The module determines this based on the tax percentage on the invoice line:

Items with 0% tax are never treated as OSS, regardless of the destination country.

Troubleshooting

"Active sales taxcode with percentage X and type 40 cannot be found"

OSS not being applied

OSS applied to the wrong country

External Resources

• Yuki support on OSS
• Belastingdienst OSS

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team