Settings

Overview

All settings live on a single tab at WooCommerce → One Stop Shop → Settings, organized into four sections: General settings, Notifications, Tools, and Advanced.

General settings

Home country

Read directly from your WooCommerce base location, with a Change in WooCommerce Settings link. The plugin deliberately has no separate home-country option — your store address is the single source of truth for classification, so the two can never disagree. (The setup wizard writes to the same place.) If your store country is not in the EU, a warning notes that OSS threshold tracking only applies to EU-based businesses.

OSS registration start date

Optional. Leave it empty if you register for OSS because you crossed the EUR 10,000 threshold: the plugin then applies OSS from the sale that crossed it, or from 1 January if you crossed it the previous year.

Fill it in if you registered for OSS voluntarily (below the threshold), or were already registered before you started using the plugin. Enter the date your registration took effect. From that date on, every cross-border B2C sale is treated as an OSS sale in the filing calendar and the quarterly reports, and destination VAT counts as required. When both apply, the earlier date wins. An invalid date is rejected with a warning and the stored value is kept.

B2C / B2B order classification

An informational box explaining exactly when an order is excluded from the threshold as B2B:

  • A structurally valid VAT number is present — entered in the plugin’s checkout field, or found in one of the common third-party meta keys (_oss_vat_number, _vat_number, _billing_vat_number, _billing_eu_vat_number, vat_number, _vat_id, _billing_vat).
  • The order meta is_vat_exempt is set to “yes”.

A malformed VAT number does not exclude the order — the sale keeps counting and the order is flagged for review. The box also lists honest limitations: a company name alone does not trigger B2B classification, WooCommerce’s native customer tax-exempt status is not checked, and the EU “2 of 3” location-evidence rule is not enforced.

VAT number field at checkout

Controls the B2B VAT-number field on classic and block checkout:

  • Auto — show unless another VAT plugin provides one (default)
  • Always show
  • Never show

Require VIES verification for B2B

A checkbox for strict mode: “Only exclude a B2B order from the threshold once its VAT number is VIES-verified.” Off (default), a structurally valid number excludes the order; on, only VIES-verified numbers do, and unverified ones keep counting — the safer, stricter choice. VIES verification requires the Pro add-on; with strict mode on but no Pro, orders carrying a VAT number keep counting.

Notifications

  • Email notifications — Enabled or Disabled.
  • Notification email address — one address; defaults to the site admin email. An invalid entry is rejected with a warning rather than saved.

Below the fields, a reference table lists each notification type, its trigger, and availability — Threshold reached (100%) and Rates no longer required are Free; the 70% and 90% alerts and the Monthly digest are Premium. See Email notifications.

Tools

Setup wizard

Re-run setup wizard reopens the guided setup to reconfigure your home country and re-scan existing orders.

Import VAT rates

One-click import of the latest EU VAT rates into your WooCommerce tax settings. This is a Pro feature — see VAT rate importer; without Pro the row shows the Premium note.

VAT data API URL

Optional: your own remote endpoint for EU VAT country data. Empty by default — when empty, the plugin uses the VAT-rate reference data bundled with it and makes no external requests at all. If you do configure a URL, it must be HTTPS, and a fetched update is accepted only if it covers exactly the 27 EU member states (with rates clamped to a plausible range) — a wrong or compromised feed can never alter which countries count toward the threshold. With a URL configured, the data is also refreshed weekly in the background.

A Use Sellinor’s maintained rates feed button below the field fills in the rates feed we keep current at sellinor.dev, so member-state rate changes reach your reports without waiting for a plugin update. This is entirely opt-in: the weekly fetch retrieves VAT rate data only, and nothing about your store is ever sent.

With a feed configured, every refresh is diffed against your active rates: a detected change — including future-dated ones announced ahead of their effective date — shows an admin notice, and rate lookups switch to the new rate automatically on the day it takes effect. With Pro, you also get an email alert, and if auto-apply is enabled your WooCommerce tax rates are re-imported automatically on the effective date.

Refresh VAT rates

A Refresh now button fetches the configured API URL immediately. The description below it shows whether you are currently using built-in rates or remote data (with country count and the last fetch time).

Advanced

Auto-apply VAT rates

With the Pro auto-rates module active, a Yes/No option to automatically import destination-country VAT rates into WooCommerce when the OSS threshold is exceeded. Without Pro, the row shows the Premium note.

Reduced VAT rates by product class

Disabled by default. When enabled, the plugin looks up reduced and super-reduced destination VAT rates per WooCommerce tax class instead of always using the standard rate. The plugin ships a verified, effective-dated dataset of member-state reduced rates, so historical quarters resolve to the rate that was in force at the time.

Below the toggle, a mapping table lists each of your WooCommerce tax classes with an OSS category selector:

  • Standard rate (default)
  • Reduced — higher/general rate
  • Reduced — lower rate (for countries with two reduced bands; equals the general reduced rate where there is only one)
  • Super-reduced (exists only in FR, ES, IT, LU, IE, CY — everywhere else it falls back to the standard rate)

Anything left unmapped simply uses the standard rate — the plugin never invents a rate. The mapping affects the Pro quarterly reports (per-rate report lines) and the Pro VAT rate importer (per-class WooCommerce tax rows).

Which of your products qualify for a reduced rate is a per-country legal question — confirm your mapping with a tax advisor before enabling this.