eu_vat_rates_data 2026.8.12 → 2026.8.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c47790e72d15ea55faa3e508c992e4a8a8a2634645583008abf4c6fa0bfb77e3
-  data.tar.gz: d038406c37195e9131cf66b5ef068e5e816492a0553ed6e7ae313edde45c158e
+  metadata.gz: 867e872a863f754240a5bc267436a0c980015a449506db8ee5617f3597334af3
+  data.tar.gz: 85a05ca031f7db5d96295f7017df4de7c1161ef97287d453a2242da0f044163a
 SHA512:
-  metadata.gz: 27fe5f4c8acb3b53f879174004f633e3a0e3f648d3c21acaf83b36da4b63dc7652e0867db7fedff5278e7c97bd5f324acc572906930209b4a5e56ad0769965a7
-  data.tar.gz: db87a46e550d0ec86719c570afcee6ff5ae9cf9c46843603a0619b13c2ad93810bde70baf66b2fa0d5fcd883aad5aabb721106e04bde476bcd851adce78c9e60
+  metadata.gz: 6e2042ba9b7dc8ab16fdf692c41bbaa11d332363dc43b24971d14f2bd0688c214661c5619a3b202e94717f1a221c0c0d18cee02c10abbd8c15c5c5e05a21bfc2
+  data.tar.gz: 03df437a6bde6839ce51c07bcb4c011b3191f8573f4587e4c814925be350f4c7eb931d219b3aaead9b75632e372557366b62eea3ef87328ce4c7dd733a728190

data/README.md

@@ -24,7 +24,7 @@ Also available in: [JavaScript/TypeScript (npm)](https://www.npmjs.com/package/e
 
 This package gives you VAT **rates** and **format checks** for free, offline, in your code. It does **not** call VIES — `valid_format?()` only checks the shape of a VAT number, not whether it actually exists.
 
-For **live VIES validation** — confirming a VAT ID is real, pulling the registered company name and address, and getting the VIES consultation number as your reference for the check — there's **[vatnode](https://vatnode.dev)**:
+For **live VIES validation** — confirming a VAT ID is real, pulling the registered company name and address, and getting the VIES consultation number as your reference for the check — there's **[vatnode](https://vatnode.dev?ref=rates-readme-rb)**:
 
 - Live VIES validation, with national-database fallback when VIES is down
 - Registered company name, address, registration date
@@ -38,7 +38,7 @@ curl https://api.vatnode.dev/v1/vat/IE6388047V \
   -H "Authorization: Bearer YOUR_API_KEY"
 ```
 
-[**Get a free API key →**](https://vatnode.dev/login?ref=rates-readme-rb)
+[**See what the API adds →**](https://vatnode.dev/vat-rates?ref=rates-readme-rb#beyond-rates) · [Get a free API key](https://vatnode.dev/login?ref=rates-readme-rb)
 
 ---
 
@@ -110,6 +110,43 @@ EuVatRatesData.flag("XX")  # => "" (empty string for unknown/invalid codes)
 
 ---
 
+## Example: charging VAT on an invoice
+
+Rates on their own rarely answer the question you actually have, which is what
+to put on the invoice. Two rules cover most of it: charge the buyer's domestic
+rate, unless the sale is cross-border B2B inside the EU, where the reverse
+charge applies and you invoice 0%.
+
+```ruby
+# Money in minor units (cents). Never floats.
+def invoice_total(net_cents, seller_country, buyer_country, buyer_vat_id = nil)
+  cross_border_b2b = buyer_country != seller_country &&
+                     !buyer_vat_id.nil? &&
+                     EuVatRatesData.valid_format?(buyer_vat_id)
+
+  return { vat_cents: 0, total_cents: net_cents, reverse_charge: true } if cross_border_b2b
+
+  rate = EuVatRatesData.get_standard_rate(buyer_country)
+  vat_cents = (net_cents * rate / 100.0).round
+
+  { vat_cents: vat_cents, total_cents: net_cents + vat_cents, reverse_charge: false }
+end
+
+# Domestic sale in Finland — 25.5%
+invoice_total(10_000, 'FI', 'FI')
+# => { vat_cents: 2550, total_cents: 12550, reverse_charge: false }
+
+# Finnish seller, German business buyer — reverse charge
+invoice_total(10_000, 'FI', 'DE', 'DE123456789')
+# => { vat_cents: 0, total_cents: 10000, reverse_charge: true }
+```
+
+`valid_format?` only checks the shape of the number. Applying the reverse charge
+requires the buyer to actually be VAT-registered, which is a VIES lookup — see
+above.
+
+---
+
 ## Data source & update frequency
 
 How the daily check works, and what changed when: [vatnode.dev/data](https://vatnode.dev/data?ref=rates-readme-rb).
@@ -149,22 +186,9 @@ No package needed — parse it with a single `fetch()` / `http.get()` / `file_ge
 
 ---
 
-## Need to validate VAT numbers?
-
-This package provides **VAT rates** only. If you also need to **validate EU VAT numbers** against the official VIES database — confirming a business is VAT-registered — check out [vatnode.dev](https://vatnode.dev), a simple REST API with a free tier.
-
-```bash
-curl https://api.vatnode.dev/v1/vat/FI17156132 \
-  -H "Authorization: Bearer vat_live_..."
-# → { "valid": true, "companyName": "Suomen Pehmeä Ikkuna Oy" }
-```
-
----
-
 ## Changelog
 
-### 2026-04-25
-- **fix:** Corrected Sweden (SE) VAT number regex — was `^SE\d{12}$`, now correctly requires the mandatory `01` suffix: `^SE\d{10}01$`.
+See [CHANGELOG.md](CHANGELOG.md).
 
 ---
 

data/data/eu-vat-rates-data.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-08-12",
+  "version": "2026-08-13",
   "source": "European Commission TEDB",
   "rates": {
     "AD": {

data/lib/eu_vat_rates_data/version.rb

@@ -1,3 +1,3 @@
 module EuVatRatesData
-  VERSION = "2026.8.12"
+  VERSION = "2026.8.14"
 end

data/lib/eu_vat_rates_data.rb

@@ -77,6 +77,9 @@ module EuVatRatesData
   # @return [Boolean]
   def self.valid_format?(vat_id)
     code = vat_id[0, 2].upcase
+    # Greek VAT numbers carry the VIES prefix EL, while the dataset keys Greece
+    # under its ISO code GR.
+    code = "GR" if code == "EL"
     rate = get_rate(code)
     return false unless rate && rate["pattern"]
     !!(vat_id.upcase =~ /\A#{rate["pattern"]}\z/)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eu_vat_rates_data
 version: !ruby/object:Gem::Version
-  version: 2026.8.12
+  version: 2026.8.14
 platform: ruby
 authors:
 - Iurii Rogulia
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-12 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies: []
 description: VAT rates (standard, reduced, super-reduced, parking) for 45 European
   countries — EU-27 plus Norway, Switzerland, UK, and more. Includes eu_member flag,
@@ -25,13 +25,15 @@ files:
 - data/eu-vat-rates-data.json
 - lib/eu_vat_rates_data.rb
 - lib/eu_vat_rates_data/version.rb
-homepage: https://github.com/vatnode/eu-vat-rates-data-ruby
+homepage: https://vatnode.dev/vat-rates?ref=rates-rubygems
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/vatnode/eu-vat-rates-data-ruby
+  homepage_uri: https://vatnode.dev/vat-rates?ref=rates-rubygems
   source_code_uri: https://github.com/vatnode/eu-vat-rates-data-ruby
   bug_tracker_uri: https://github.com/vatnode/eu-vat-rates-data-ruby/issues
+  changelog_uri: https://github.com/vatnode/eu-vat-rates-data-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/vatnode/eu-vat-rates-data-ruby#readme
 post_install_message:
 rdoc_options: []
 require_paths: