# VIESAC — Autonomous EU VAT & Customs EORI Validation Infrastructure

> Enterprise-grade statutory VAT validation, customs EORI compliance, audit trails, and official SOAP XML evidence for the European Union, United Kingdom, Switzerland, Norway, Turkey, and Serbia.

VIESAC (https://viesac.eu) provides automated B2B cross-border tax compliance infrastructure. It verifies VAT and EORI registration numbers directly against official government registries, resolves corporate identity via AI-assisted multi-source enrichment, generates tamper-evident audit certificates, and preserves cryptographically timestamped evidence required by European tax authorities for Article 138 (Directive 2006/112/EC) zero-rate VAT audits.

## Primary Documentation & Machine Discovery

- [Machine Discovery Index (llms.txt)](https://viesac.eu/llms.txt): Core sitemap, capabilities, and quickstart for LLMs and agents.
- [Full Context Documentation (llms-full.txt)](https://viesac.eu/llms-full.txt): Comprehensive API reference, schemas, country specifications, and error models for large context windows.
- [AI Agent Integration Guide (agents.md)](https://viesac.eu/agents.md): Tool definitions, MCP server configuration, and autonomous agent workflows.
- [OpenAPI 3.0 Specification](https://viesac.eu/openapi.yaml): Full OpenAPI / Swagger schema for API client generation.
- [Human-Readable API Documentation](https://viesac.eu/api-docs): Interactive documentation, sandbox instructions, and web dashboard guides.
- [Agentic Discovery Sitemap](https://viesac.eu/sitemap_agentic_discovery.xml): XML sitemap optimized for LLM crawler ingestion.

## Core Capabilities

1. **Multi-Jurisdiction VAT Validation**:
   - **European Union (27 Member States)**: Direct VIES SOAP integration with multi-source fallback (EC European Commission REST, French DGFiP/Sirene, German BZSt, Czech ARES, Slovenian FURS, and Spanish AEAT).
   - **United Kingdom (GB)**: HMRC VAT API (live lookups and consultation proofs).
   - **Switzerland (CH)**: Federal Tax Administration (ESTV) UID registry for CHE MwSt/TVA/IVA.
   - **Norway (NO)**: Brønnøysund Register Centre (BRREG) for MVA verification.
   - **Turkey (TR)**: Revenue Administration (GİB) VKN taxpayer registry.
   - **Serbia (RS)**: Tax Administration (PURS) PDV / PIB registry.
2. **Customs EORI Validation**:
   - Validates Economic Operators Registration and Identification (EORI) numbers directly through EU Customs EOS (Economic Operators System) databases.
3. **Hybrid VAT + EORI Audits**:
   - Single-call validation and consolidated audit trail for entities requiring simultaneous fiscal and customs clearance.
4. **Statutory Tax Audit Protection**:
   - Generates immutable PDF audit certificates and preserves raw, cryptographically timestamped government XML responses satisfying EU Tax Directive 2006/112/EC requirements for burden of proof.
5. **AI Company & Address Enrichment**:
   - Automatically enriches missing company names and addresses using official national registries, Serper web extraction, and LLMs (Kimi, OpenAI, Gemini) when VIES masks corporate details for GDPR reasons.
6. **Periodic Monitoring & Webhooks**:
   - Automated recurring scheduled checks (daily, weekly, monthly, quarterly, yearly) with webhook notifications upon corporate status changes or VAT cancellations.
7. **Global VAT Rates Catalog**:
   - Free, unmetered access to official standard, reduced, super-reduced, parking, and regional VAT rates across all supported European territories.

## REST API (v1) Reference

- **Base URL**: `https://viesac.eu/api/v1`
- **Authentication**: `Authorization: Bearer <YOUR_API_KEY>` (generate in `/app` dashboard).
- **Format**: `application/json`

### Key Endpoints

| Method | Endpoint | Description | Quota Cost |
|---|---|---|---|
| `GET` | `/rates` | Full VAT rates catalog (standard, reduced, special territories) | Free (0 credits) |
| `GET` | `/rates/{country}` | VAT rates for specific ISO country code | Free (0 credits) |
| `GET` | `/validate` | Fast VAT status lookup (cache/VIES) without creating an audit record | 1 check |
| `GET` | `/eori/validate` | Fast EORI status lookup without creating an audit record | 1 check |
| `POST` | `/audits` | Create full statutory audit record (type: `vat`, `eori`, `vat_eori`) | 1–2 credits |
| `GET` | `/audits` | List and search audit records with pagination and filters | Free (0 credits) |
| `GET` | `/audits/{ref}` | Retrieve single audit details, statuses, and certificate links | Free (0 credits) |
| `PUT` | `/audits/{ref}` | Update metadata (order number, invoice number, customs ref, comments) | Free (0 credits) |
| `GET` | `/audits/{ref}/certificate` | Download PDF statutory tax audit certificate | Free (0 credits) |
| `GET` | `/audits/{ref}/certificate/xml` | Download raw official SOAP/XML evidence timestamped by tax authorities | Free (0 credits) |
| `GET` | `/account` | Check active subscription plan, billing cycle, and remaining audit credits | Free (0 credits) |
| `GET` | `/partners/check` | Instant duplicate / relationship lookup across historical audits | Free (0 credits) |

### Fast VAT Validation Example (cURL)

```bash
curl -X GET "https://viesac.eu/api/v1/validate?vat=DE811128124" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Create Statutory Audit Example (cURL)

```bash
curl -X POST "https://viesac.eu/api/v1/audits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "type": "vat",
    "country_code": "DE",
    "vat_number": "811128124",
    "order_number": "ORD-2026-9812",
    "invoice_number": "INV-44021"
  }'
```

## Public Web Tools (Browser UI)

- [All VAT & EORI Tools](https://viesac.eu/tools)
- [EU VAT Validator Hub](https://viesac.eu/tools/eu-vat-validator)
- [EU Customs EORI Validator](https://viesac.eu/tools/eori-validator)
- [Turkish GİB VKN Validator](https://viesac.eu/tools/turkish-vat-validator)
- [Swiss UID VAT Validator](https://viesac.eu/tools/swiss-vat-validator)
- [Serbian PURS PDV Validator](https://viesac.eu/tools/serbian-vat-validator)
- [Australian ABR ABN & GST Validator](https://viesac.eu/tools/australian-abn-gst-validator)
- [Norwegian BRREG MVA Validator](https://viesac.eu/tools/norwegian-vat-validator)
- [UK HMRC VAT Validator](https://viesac.eu/tools/uk-vat-validator)

## Pre-Built Integrations

- [Make / Integromat Apps](https://viesac.eu/extensions/make)
- [WooCommerce EU VAT Extension](https://viesac.eu/extensions/woocommerce)
- [Shopify B2B Exemption](https://viesac.eu/extensions/shopify)
- [Google Sheets Add-on](https://viesac.eu/extensions/google-sheets)
- [Microsoft Power Automate](https://viesac.eu/extensions/microsoft)
- [SAP ERP Connector](https://viesac.eu/extensions/sap)

## Contact & Compliance

- **Headquarters & Service**: VIESAC EU Tax Compliance Infrastructure
- **Website**: https://viesac.eu
- **Status & Uptime**: https://viesac.eu/up
- **Terms & Legal**: https://viesac.eu/terms-of-service | https://viesac.eu/privacy-policy