Admin Panel

Shopify Admin dashboard built with Polaris. Four admin pages provide complete control over VAT validation configuration, monitoring, reporting, and billing.

Dashboard

app._index.tsx

The main landing page after authentication. Provides at-a-glance metrics, usage tracking, recent validations, per-surface breakdown, and quick navigation.

your-store.myshopify.com/admin/apps/vat-validator

VAT Validator Dashboard

VIES Calls
247
of 500 quota
Valid
189
VAT numbers
Invalid
58
VAT numbers
Success Rate
76%
overall
Tax Exempt
42
customers exempted
VIES API Usage 247 / 500 calls used (49%)
Warning will appear at 80% usage. Upgrade plan for more calls.
Recent Validations
VAT Number Country Status Company Date
DE123456789 🇩🇪 DE Valid Example GmbH 2024-01-15
FR12345678901 🇫🇷 FR Valid SARL Test 2024-01-15
NL000000000B01 🇳🇱 NL Invalid — 2024-01-14
Validations by Surface
Cart
156
validations
Checkout
45
validations
Thank You
32
validations
Account
14
validations
Quick Actions

Test Validation

/app/test

Settings

/app/settings

Settings

app.settings.tsx

Comprehensive configuration for all validation behavior, surface toggles, tax exemption rules, and reverse charge settings. All changes auto-save via Remix action.

your-store.myshopify.com/admin/apps/vat-validator/settings

Settings

General
Enable VAT Validation Master switch for all VAT validation functionality
Validation Behavior
Require VAT Number Make VAT number mandatory for EU customers
Show Company Information Display VIES-returned company name and address
DE × FR × NL × AT × IT × ES × BE × + 20 more
Surface Configuration
Cart Page Theme App Extension - App Block
Required VAT number must be provided before checkout
Block checkout if invalid Prevent checkout with invalid VAT (requires Function)
Cart Drawer Theme App Extension - App Embed
Checkout Plus Only Checkout UI Extension
Checkout UI Extensions are only available on Shopify Plus plans. This surface will be automatically disabled for non-Plus stores.
Thank You Page Post-checkout VAT collection
Customer Account VAT profile management in customer account pages
Auto-populate Pre-fill VAT from customer metafield on checkout
Tax Exemption
Enable automatic tax exemption Set customer.taxExempt = true when VAT is valid (requires login)
Same-country exemption Also exempt customers from seller's own country
Reverse Charge
Enable Reverse Charge notes Add reverse charge note to order metafields for B2B invoicing
Danger Zone
These actions are irreversible. Clearing validation history will permanently delete all validation records for this store.

Reports

app.reports.tsx

Filterable validation history with status and date range filters, detailed data table, pagination, and CSV export functionality for accounting and compliance.

your-store.myshopify.com/admin/apps/vat-validator/reports

Validation Reports

Status
Date Range
VAT Number Country Status Surface Company Order ID Date
DE123456789 🇩🇪 DE Valid cart Example GmbH #1001 2024-01-15 14:30
ATU12345678 🇦🇹 AT Valid checkout Test AG #1002 2024-01-15 13:15
FR00000000001 🇫🇷 FR Invalid thank_you — #1003 2024-01-14
NL123456789B01 🇳🇱 NL Valid cart Holding BV #1004 2024-01-14
ES12345678A 🇪🇸 ES Valid account Empresa SL — 2024-01-13
Showing 25 of 247 validations

CSV Export Specification

  • ● Columns: date, vat_number, country_code, company_name, is_valid, surface, source, order_id
  • ● Encoding: UTF-8 with BOM (Excel compatibility)
  • ● Maximum: 10,000 rows per export
  • ● Filename: vat-validations-{shop}-{YYYY-MM-DD}.csv

Billing

app.billing.tsx

Freemium pricing with four tiers. All paid plans include a 14-day free trial. Billing is managed entirely through the Shopify Billing API for seamless merchant experience.

your-store.myshopify.com/admin/apps/vat-validator/billing

Plans & Billing

Free
$0
per month
  • ✓ 50 VIES calls / month
  • ✓ Basic format validation
  • ✓ VIES verification
  • ✓ Email support
POPULAR
Starter
$9
per month
  • ✓ 500 VIES calls / month
  • ✓ Everything in Free
  • ✓ Validation reports
  • ✓ CSV export
Pro
$29
per month
  • ✓ 5,000 VIES calls / month
  • ✓ Everything in Starter
  • ✓ API access
  • ✓ Webhook notifications
  • ✓ Custom error messages
Enterprise
$99
per month
  • ✓ Unlimited VIES calls
  • ✓ Everything in Pro
  • ✓ Dedicated support
  • ✓ Custom integrations
  • ✓ SLA guarantee (99.9%)

Billing Details

  • ● 14-day free trial on all paid plans
  • ● Shopify Billing API integration (charged through Shopify invoice)
  • ● Usage-based overage billing (post-MVP): Starter $0.03/extra call, Pro $0.02/extra call
  • ● Annual pricing (post-MVP): 20% discount on all paid plans