# Integration CLI Documentation

> Give this URL to an AI assistant when it needs help with Integration CLI setup, CSV mappings, result files, folder mode, support logs, or troubleshooting.

Integration CLI validates VAT IDs from CSV files or mailbox-style folders. It is intended for ERP exports, scheduled jobs, and systems that cannot call an API directly.

This file is for CLI usage only. It does not document direct Integration API endpoints; use the Integration API reference when you are building an HTTP integration.

Prefer sharing the published URL for this file instead of uploading a downloaded copy. Downloaded copies can become outdated.

## Recommended Reading Order

- [Integration CLI](/cli/intro): What Integration CLI does, when to use it, and which files a run creates.
- [Getting Started](/cli/getting-started): First CSV validation flow from mapping file and token to result CSV.
- [Installation](/cli/installation): Runtime, operating system packages, network hosts, and update guidance.
- [Authentication](/cli/authentication): Personal Access Tokens, environments, base URLs, and authentication errors.
- [Check Command](/cli/commands/check): Command syntax, arguments, options, examples, and validation rules.
- [Mapping File](/cli/configuration/mapping-file): YAML mapping file structure for columns, defaults, filters, output, and folder mode.
- [CSV Input](/cli/configuration/csv-input): CSV header mode, no-header mode, delimiters, encodings, skipped records, and passthrough columns.
- [Result CSV](/cli/configuration/result-csv): Result CSV paths, columns, shortcuts, status values, and determined corrections.
- [Configuration Precedence](/cli/configuration/precedence): How command-line flags, YAML, environment variables, and defaults combine.
- [Dry Run](/cli/workflows/dry-run): Validate CSV parsing and mapping without calling the API.
- [Folder Mode](/cli/workflows/folder-mode): Mailbox-style folder processing with processing, done, error, results, and logs folders.
- [PDF Reports](/cli/workflows/pdf-reports): PDF report creation, signing, save locations, timestamps, and email options.
- [Resume And Idempotency](/cli/workflows/resume-and-idempotency): Saved validation state, automatic resume, force-new behavior, and idempotency keys.
- [Support Logs](/cli/workflows/support-logs): Support log locations, privacy guarantees, and what to share with support.
- [Exit Codes](/cli/reference/exit-codes): Process exit codes and how automation should handle them.
- [Troubleshooting](/cli/reference/troubleshooting): Common configuration, CSV, authentication, API, resume, and folder-mode problems.

## Complete CLI Context

- [llms-full.txt](/llms-full.txt): single-file CLI documentation bundle for AI agents. Share the URL when possible; download it only for offline or fixed-version work.

## Scope Notes

- Use these AI files for Integration CLI setup, configuration, and troubleshooting.
- Use the Integration API documentation for direct HTTP/API integrations.
- Authentication uses Optimus Personal Access Tokens.
- The public CLI command documented here is `optimus check <path>`.
- Do not place real `tok_optimus_` token values in prompts, logs, examples, or source code.