# Clearvo

> Clearvo is a single API for all your global tax obligations — e-invoicing (32 countries, direct authority connections), tax calculation (76 countries), tax number validation, and compliance monitoring. Production API keys issued immediately at sign-up, no sales call required.

## API Documentation

- [API Overview](https://clearvo.io/docs): Getting started, authentication, base URL, webhooks, and quickstart guide. GET /v1/mandates lists every supported e-invoicing mandate with its authority, formats, and required payload fields (?id=IT-SDI for one mandate's full field list) — use it to validate invoices before calling /v1/send.
- [Tax Calculation API](https://clearvo.io/docs/tax-calculation): Calculate VAT, GST, and sales tax globally. Liability calculation, line-item breakdown, and supported-jurisdiction discovery across 76 countries (GET /v1/tax/jurisdictions is the live list).
- [Tax Number Validation API](https://clearvo.io/docs/tin-validation): Validate EU VAT numbers, UK UTR, US EIN, and more. Real-time authority lookup. 100 lookups/month free.
- [Sandbox Environment](https://clearvo.io/docs/sandbox): Test keys, per-country mock responses, authority simulation. IT/RO/HU records start PENDING and auto-resolve to ACCEPTED after 30s; PL/ES/GR/Peppol resolve immediately.
- [France e-Reporting](https://clearvo.io/docs/france-ereporting): DGFiP Flux 2 (B2C aggregate reporting) and Flux 3 (payment events) implementation guide.
- [Odoo Integration](https://clearvo.io/docs/odoo): Connect Clearvo to Odoo 16/17. E-invoicing, tax calculation, and tax number validation in one native module.
- [Data Query Tool](https://clearvo.io/openapi.json): POST /v1/query — filtered, paginated queries over your own e-invoicing and tax-calculation data (GET /v1/query/fields lists filterable fields, operators, and enum values). GET /v1/export also accepts the same canonical filter shape (dataset/filters/columns/from/to) to export a query's results as CSV or XLSX.
- [Client Tax Codes](https://clearvo.io/openapi.json): GET/POST /v1/tax/client-codes and PATCH/DELETE /v1/tax/client-codes/{id} — map your own ERP tax code (e.g. a SAP two-digit code) to a Tax Decision (movement, taxability, customerType, supplyType, reverseCharge, useTaxSelfAssessed, rateBand where applicable) for a country/region, with an optional sale/purchase direction. Reference one of your codes as `clientTaxCode` on a POST /v1/send line item instead of sending taxCode+rate directly; POST /v1/tax/calculate returns your matching code back in its response for ERP posting. The EN16931 taxCode and rate are always computed live from the Tax Decision fields, never request fields.

## AI and Agentic Use

- [Build AI Agents with Clearvo](https://clearvo.io/docs/agents): Full patterns for Anthropic tool_use and OpenAI function calling. Agentic loops for invoice submission, status polling, batch supplier validation, and sandbox testing.
- [Claude Code / MCP Setup](https://clearvo.io/docs/claude-code): Install the Clearvo MCP server in Claude Code, Cursor, Windsurf, and VS Code. Gives your LLM direct access to all Clearvo API tools. Includes a "Copy for LLM context" button to paste the full API surface into any AI assistant.

## Products

- [E-Invoicing](https://clearvo.io/e-invoicing): Submit invoices directly to SDI (Italy), KSeF (Poland), ANAF (Romania), myDATA (Greece), XRechnung (Germany), CIUS-PT (Portugal), and Peppol AP (14+ countries). 25 invoices/month free.
- [Tax Calculation](https://clearvo.io/tax-calculation): Calculate tax globally — VAT, GST, sales tax — across 76 countries. 1,000 calculations/month free.
- [Tax Number Validation](https://clearvo.io/tin-validation): Validate supplier and customer tax IDs in real time. 100 lookups/month free.
- [Compliance Radar](https://clearvo.io/compliance-radar): Monitor VAT and e-invoicing mandate changes. Get alerts when new obligations go live in your operating countries. Always free for up to 5 countries.
- [Peppol Access Point](https://clearvo.io/peppol): Certified 4-corner Peppol AP. Send and receive UBL 2.1 invoices across the Peppol network.

## Integrations

- [Odoo](https://clearvo.io/integrations/odoo): Native Odoo 16/17 module — e-invoicing, tax calculation, and tax number validation.
- [Xero](https://clearvo.io/integrations/xero): Sync invoices and tax data with Xero.
- [QuickBooks](https://clearvo.io/integrations/quickbooks): Connect Clearvo to QuickBooks Online.
- [Stripe](https://clearvo.io/integrations/stripe): E-invoicing and tax calculation for Stripe billing.

## Pricing

- [Pricing](https://clearvo.io/pricing): Separate E-Invoicing and Tax Calculation plans. Free tiers with no time limit: 25 invoices/month, 1,000 tax calculations/month, 100 TIN lookups/month.

## Country Guides

- [E-Invoicing by Country](https://clearvo.io/coverage): Full mandate coverage map — 32 live countries.
- Key markets: [Italy](https://clearvo.io/countries/it), [Poland](https://clearvo.io/countries/pl), [Germany](https://clearvo.io/countries/de), [France](https://clearvo.io/countries/fr), [Romania](https://clearvo.io/countries/ro), [Greece](https://clearvo.io/countries/gr), [Spain](https://clearvo.io/countries/es), [United States](https://clearvo.io/countries/us)