Optimus Documentation
Use these docs to integrate Optimus VAT validation into file-based workflows, API-based systems, and AI assistant workflows.
CSV automationIntegration CLIValidate exported CSV files from ERP systems, scheduled jobs, and mailbox-style folders.JSON over HTTPSIntegration APICall VAT lookup and validation endpoints directly from your own application.AI assistantsOptimus MCPLet AI assistants resolve VAT IDs and run validations through hosted Optimus access.
Choose The Right Integration
| Choose | When |
|---|---|
| Integration CLI | Your ERP or back-office system can export CSV files but cannot call an API directly. |
| Integration API | Your application can send authenticated JSON requests over HTTPS. |
| Optimus MCP | An AI assistant should help users look up or validate VAT data during a conversation. |
Shared Concepts
All integration paths use the same Optimus VAT validation platform and return the same business concepts:
- Authentication uses Optimus-issued access tokens.
- VAT validation can be standard or qualified.
- Long-running validations are tracked as operations.
- Idempotency keys protect clients from duplicate work during retries.
- Result data can include VAT ID status, field match statuses, and PDF report metadata.
Recommended Starting Points
- Start with CLI Getting Started when your source data is CSV.
- Start with API Getting Started when your system works with JSON requests.
- Start with MCP Getting Started when you want an AI assistant to use Optimus.
- Use CLI Troubleshooting or API Errors when something fails.