EU OSS / One-Stop-Shop VAT for Magento 2

核心功能

Destination-country VAT applied to cross-border B2C EU orders via a plugin (interceptor) around Magento's tax calculation, applied at quote, invoice, and credit-memo time without overwriting your existing tax_calculation_rule setup

Per-country EU VAT rate table stored in a dedicated module table, editable from a dedicated admin grid and exposed through a service contract (OssRateRepositoryInterface)

Automatic EUR 10,000 OSS threshold tracking: a cron job accumulates rolling cross-border B2C turnover and raises an admin notification as you approach the limit

Scheduled rate auto-update: cron refreshes standard/reduced VAT rates per member state so you are not hand-editing tax_calculation_rate rows

OSS quarterly return export (CSV/XML to your agreed format) summarizing net and VAT per destination country for the filing period

Per-destination-country tax breakdown report in the admin, drillable to individual orders, invoices, and credit memos

B2B vs B2C handling: valid VAT-ID intra-community orders (reverse charge) are excluded from OSS accumulation; configurable VIES-style validation hook

REST and GraphQL endpoints so headless/PWA Studio and Hyva storefronts get correct destination VAT and can read OSS rate data

Admin ACL resource (Ecosire_EuOssVat::oss) so only authorized roles can edit rates, view reports, and run exports

Store-view and website scope aware: rates and OSS configuration respect Magento's multi-store/multi-website scoping for sellers running several EU storefronts

Multi-currency aware: VAT computed on the order's presentment currency with base-currency totals stored for OSS reconciliation

Configurable VAT-exempt and reduced-rate product mapping by attribute so books, food, or zero-rated SKUs use the correct member-state rate

按需定制，全程代劳

无需自行搭建——由 ECOSIRE 构建、安装并提供支持的可用应用。

您下单

以一次性构建价格开始。我们在启动时与您共同确定范围。

我们构建与安装

ECOSIRE 在您的 Magento 2 上构建、配置并安装。

上线 + 支持

约 2–4 周内上线，并提供上线后的支持期。

关于此产品

Since July 2021, an EU B2C seller crossing EUR 10,000 in annual cross-border distance sales must charge the VAT rate of the customer's destination country and remit it through a single One-Stop-Shop (OSS) quarterly return. Magento Open Source and Adobe Commerce ship a flexible but origin/manual tax engine — tax_calculation_rate and tax_calculation_rule tables driven by zip/region rules. They have no native concept of an OSS threshold, no destination-rate library, and no OSS return export. Merchants end up hand-maintaining dozens of rate rows and reconciling returns in spreadsheets.

This is a build-to-order extension. ECOSIRE designs, builds, installs, and supports it on your Magento install — it is not an instant Adobe Commerce Marketplace download. We deliver a proper module under app/code/Ecosire/EuOssVat that hooks Magento's tax subsystem the right way: a plugin (interceptor) around Magento\Tax\Model\Calculation\Rate plus an observer on tax_rate_data_fetch/sales events so destination VAT is applied at quote and invoice time without overwriting your existing rules. Rates are stored in a dedicated table, exposed through a service contract (Api/OssRateRepositoryInterface), and surfaced over REST and GraphQL for headless/PWA storefronts.

A cron job keeps the per-country rate table current and accumulates cross-border B2C turnover so the store flags when you approach EUR 10,000. An admin grid (with its own Ecosire_EuOssVat::oss ACL resource) shows tax broken down per destination country, and a one-click export produces an OSS quarterly return file your accountant or tax portal can consume.

Scope, edge cases (mixed B2B/B2C carts, VAT-exempt SKUs, marketplace deemed-supplier rules), and your exact reporting format are agreed up front. Honest delivery: a working build on a staging copy of your store, then production install and a support window — see the FAQs for lead time.

你得到什么

A custom Magento 2 module (Ecosire_EuOssVat) under app/code with composer.json, registration.php, module.xml, di.xml, and acl.xml — installable via setup:upgrade

Database schema (db_schema.xml) for the OSS rate table and turnover-accumulation table, with declarative upgrade-safe migrations

Installation on a staging copy of your store first, then production deployment, including setup:di:compile and static content deploy verification

Admin configuration: OSS rate grid, threshold settings, country/rate mapping, and the destination tax breakdown report wired to the ACL resource

Cron jobs (crontab.xml) for rate refresh and threshold accumulation, plus the OSS quarterly export action

REST and GraphQL coverage (webapi.xml / schema.graphqls) for destination VAT and OSS rate data, documented for your storefront team

A short admin runbook: how to read the per-country breakdown, run the quarterly export, and update rates when EU rates change

A defined post-delivery support window for bug fixes and Magento patch-compatibility (scope agreed before build)

这是给谁的

Cross-border EU DTC brand owner

Sells direct-to-consumer across multiple EU countries on Magento Open Source, has crossed (or is about to cross) the EUR 10,000 distance-sales threshold, and needs destination VAT charged correctly so OSS returns are defensible rather than reconstructed from spreadsheets.

Finance / VAT compliance lead

Responsible for filing the OSS quarterly return. Wants net and VAT totals broken down per destination country directly from the store of record, with an export that maps to the tax portal or the accountant's template — not manual extraction from Magento reports.

Magento developer or agency lead

Maintains the merchant's Adobe Commerce or Open Source install and wants destination-VAT logic delivered as a clean, upgrade-safe module (plugins, service contracts, ACL, GraphQL) that survives Magento patch cycles rather than core hacks or fragile tax-rule sprawl.

EU OSS / One-Stop-Shop VAT for Magento 2 如何比较

标准	伊科西尔	定制建造	竞争对手	Magento 2 原生
Charges destination-country VAT on cross-border B2C EU orders	包含	部分支持	包含	不包括在内
Automatic EUR 10,000 OSS threshold tracking with alerts	包含	部分支持	部分支持	不包括在内
OSS quarterly return export in your agreed format	包含	部分支持	部分支持	不包括在内
Auto-updating per-country EU VAT rate table (cron)	包含	不包括在内	包含	不包括在内
Built, installed, and supported on your specific store	包含	包含	不包括在内	不包括在内
Tailored to your exact B2B/B2C, exempt-SKU and reporting edge cases	包含	包含	部分支持	不包括在内
Instant self-service download / immediate availability	不包括在内	不包括在内	包含	包含
REST + GraphQL coverage for headless/PWA storefronts	包含	部分支持	部分支持	不包括在内

关于EU OSS / One-Stop-Shop VAT for Magento 2的常见问题

How long does delivery take, since this is build-to-order?

After a short scoping call we confirm your VAT edge cases (B2B/B2C mix, exempt SKUs, currencies, store scopes) and reporting format. A typical build is delivered on a staging copy of your store within about 2 to 4 weeks, followed by production install once you've signed off. We give you a firm date in writing after scoping — this is not an instant Adobe Commerce Marketplace download; it is a module we build and install on your specific Magento environment.

What ongoing support and updates are included?

Each build includes a defined post-delivery support window (agreed before we start) covering bug fixes and compatibility with Magento security patches released during that window. EU VAT rates change periodically; the cron-based rate refresh keeps the per-country table current, and we can provide a longer maintenance agreement to track legislative changes and Magento version upgrades beyond the initial window.

Does this work on both Magento Open Source and Adobe Commerce?

Yes. The module targets standard Magento 2 APIs — service contracts, plugins, observers, db_schema.xml, REST/GraphQL — that are identical across Magento Open Source and Adobe Commerce, so it installs on either. On Adobe Commerce we also account for B2B company accounts and shared-catalog scenarios during scoping if they apply to your store.

Will it conflict with my existing tax rules or another tax extension?

It is designed not to. The extension uses a plugin (interceptor) and observers to apply destination VAT for qualifying cross-border B2C orders rather than rewriting your tax_calculation_rate and tax_calculation_rule data, so your domestic and B2B rules keep working. If you run another tax engine such as a third-party automation service, we review the interaction during scoping and define a clear order of precedence.

Does it generate the actual OSS return I submit to the tax authority?

It produces an OSS-ready quarterly export — net and VAT totals broken down per destination country in the format we agree (CSV or XML) — sourced directly from your orders, invoices, and credit memos. That file is built to drop into your OSS portal submission or your accountant's template. ECOSIRE builds the data export and the per-country reconciliation; we do not file the return on your behalf or act as your tax advisor.

How does the EUR 10,000 threshold tracking actually work?

A cron job accumulates your rolling cross-border B2C distance-sales turnover (excluding domestic sales and valid reverse-charge B2B orders) and stores it in a dedicated table. The admin shows current progress toward the EUR 10,000 EU-wide threshold and raises a notification as you approach it, so you can register for OSS and switch to destination VAT at the right time instead of discovering the crossing after the fact.