Integration CLI

Integration CLI ist ein Kommandozeilenclient zur Validierung von USt-IdNrn. aus CSV-Dateien oder aus einem Ordner, der automatisch CSV-Dateien empfängt.

Ihr ERP kann keine API anbinden? Kein Problem. Mit Integration CLI können Sie die USt-IdNr.-Prüfung automatisch und ohne Entwicklungsaufwand in jedes System integrieren.

Exportieren Sie Ihre Daten als CSV und die CLI erledigt den Rest: USt-IdNrn. prüfen, Unternehmensdaten validieren, Unternehmensdatensätze anreichern, Abweichungen erkennen und Korrekturen zurückgeben.

Nach der Einrichtung läuft alles automatisch im Hintergrund. Bei Fragen wenden Sie sich an den Optimus Support.

Verwenden Sie es, wenn Sie Folgendes benötigen:

• Eine einzelne CSV-Datei validieren und eine Ergebnis-CSV schreiben.
• Standard- oder qualifizierte USt-IdNr.-Prüfungen ausführen.
• Ausgewählte lokale Spalten, etwa Kundennummern, in der Ergebnisdatei behalten.
• PDF-Berichte speichern, wenn angefordert.
• Einen mailbox-ähnlichen Ordner mit inbox, processing, done, error und results verarbeiten.
• Unterbrochene Validierungsoperationen fortsetzen, ohne doppelte API-Arbeit zu starten.

Der Name der ausführbaren Datei ist optimus. Der aktuelle öffentliche Befehl ist:

optimus check <path>

<path> kann eine CSV-Datei oder ein Ordner sein.

Empfohlene Einrichtung

Legen Sie stabile Einstellungen wie Spaltenzuordnung, Trennzeichen, Ausgabespalten, PDF-Defaults und Folder-Mode-Optionen in mapping.yml ab. Verwenden Sie Kommandozeilenflags für einmalige Entscheidungen wie --env test, --dry-run, --out oder --verbose.

Aufbau Der Dokumentation

• Starten Sie mit Getting started für den kürzesten funktionierenden CSV-Ablauf.
• Verwenden Sie AI Agent Docs, um CLI-only llms.txt-Dateien für Coding-Assistenten und interne Agenten herunterzuladen.
• Verwenden Sie Authentication, um Tokens und API-Ziele zu konfigurieren.
• Verwenden Sie Check command für Befehlssyntax und Optionen.
• Verwenden Sie Mapping file für YAML-Konfiguration.
• Verwenden Sie Result CSV, um Ausgabespalten und Statuswerte zu verstehen.
• Verwenden Sie Folder mode für automatisierte Ordnerverarbeitung.
• Verwenden Sie Troubleshooting, wenn ein Lauf fehlschlägt.

Von Einem Lauf Erzeugte Dateien

Je nach Optionen kann ein Lauf erzeugen:

Datei	Zweck
customers_result.csv	Ergebnis-CSV für eine einzelne Eingabedatei, wenn --out nicht gesetzt ist.
customers.csv.optimus-state.json	Gespeicherter Validierungszustand für Resume-Verhalten.
logs/optimus-check-*.log	Datenschutzfreundliches Support-Log für den Lauf.
*.pdf	USt-IdNr.-Validierungsbericht, wenn PDF-Ausgabe aktiviert ist.
error/*.err	Folder-Mode-Fehlerdetails für Dateien, die nicht verarbeitet werden können.