# Die Dokumentenschicht zwischen Ihrem ERP und Ihren Tools

Source: https://arhivix.com/de/developers

Zuletzt geprüft: 15. November 2026. Angaben geprüft anhand der App-Version dieses Tages.

Arhivix ist ein Dokumentenmanagement-System mit REST API v1, signierten Webhooks und einem MCP-Server, entwickelt von NOTIX DOO in Belgrad. Es empfängt Dokumente, liest sie mit OCR und KI, lässt die Werte, die Sie zur Prüfung markieren, von einem Menschen bestätigen und übergibt die Daten an Ihr ERP und Ihre Tools.

Gehostet wird es auf AWS in der EU (Frankfurt und Dublin). Einen neuen Geschäftsprozess richten Sie in der App als Dokumentarten, Workflows und Register ein. Ihr eigener Code bleibt dadurch klein: ein Empfangsdienst neben Ihrem ERP.

## Wo Arhivix steht, wenn Dokumente die Daten tragen

Lieferantenrechnungen, Lieferscheine, Bestellungen, Zertifikate und Verträge kommen als PDFs und Scans an, das ERP erwartet aber saubere Datensätze. Arhivix übernimmt die Dokumentenseite dieser Integration, in sechs Schritten.

1. **Dokumente kommen an.** Per Upload, aus E-Mail-Postfächern des Unternehmens über Gmail, Microsoft 365 oder IMAP, von einem Desktop-Scanner, über die Handykamera oder aus Ihrem eigenen Programm über die API. Arhivix übernimmt Dokumente außerdem aus OneDrive, SharePoint, Google Drive, einem Amazon S3 Bucket oder einem Azure Blob Container.
2. **Arhivix liest sie.** OCR wandelt Scans in Text um. Ein Sprachmodell erkennt die Dokumentart und schlägt die Felder vor: bei einer Rechnung Lieferant, Käufer, Steuernummern, Beträge, Umsatzsteuer, Datumsangaben und Nummern, bei einem Vertrag Vertragsparteien, Datumsangaben, Kündigungsfrist, Wert und Zahlungsbedingungen.
3. **Ein Mensch bestätigt.** Ein gelesener Wert bleibt ein Vorschlag, bis seine Prüfregel erfüllt ist. Für jedes Feld einer Dokumentart wählen Sie die Regel: Automatisch, Prüfung erforderlich oder Muss bestätigt werden. Prüfer vergleichen die Werte mit dem Original und bestätigen sie Feld für Feld.
4. **Der Vorgang läuft weiter.** Ein Workflow prüft Bedingungen, sendet das Dokument zur Freigabe an eine Person oder eine Rolle, legt es ab, fügt es einer Vorgangsakte hinzu und überwacht seine Frist.
5. **Ihr Code wird benachrichtigt.** Ein Workflow-Schritt sendet eine signierte Nachricht an Ihren Empfangsdienst, und dieser liest den Datensatz über die REST API. Uploads, neue Dokumente, Rechnungen und E-Mails kommen außerdem als signierte Webhook-Ereignisse und im Änderungsfeed an.
6. **Das ERP bleibt das führende System.** Ihr Empfangsdienst schreibt über den Import, den das ERP unterstützt, in das ERP. Braucht ein Workflow den Nachweis, dass das ERP den Datensatz übernommen hat, fordert er eine externe Bestätigung an und wartet auf Ihren signierten Callback.

**Die Integration auf einen Blick**

1. **Ihr ERP**
   - Bestands-ERP, Buchhaltungs- oder Fachanwendung
   - Bleibt das führende System
   - → Ihr Empfangsdienst: Der Import, den Ihr ERP unterstützt
2. **Ihr Empfangsdienst**
   - Prüft die Signatur
   - Liest den Datensatz über die API
   - Schreibt über den Import, den Ihr ERP unterstützt
   - → Arhivix: Signierte Webhooks und REST API
3. **Arhivix**
   - Erfassung
   - Auslesen mit OCR und KI
   - Bestätigung durch einen Menschen
   - Workflows und Freigaben
   - Vorgangsakten
   - Speicherung, Versionen und Audit-Log
   - → Tools und Assistenten: Webhooks, REST API und MCP
4. **Tools und Assistenten**
   - Benachrichtigungen in Microsoft Teams
   - Zapier, Make, n8n und Power Automate über ihre Webhook- und HTTP-Schritte
   - Claude, Claude Code und Codex über MCP

## Ein Bestands-ERP ohne API anbinden

Das ERP bleibt, wie es ist. Dokumente kommen weiterhin so an wie heute, und auf der ERP-Seite der Integration stehen Ihr Empfangsdienst und der Import, den Ihr ERP bereits unterstützt.

- E-Mail und Scans: Lieferanten senden weiterhin PDFs, und Arhivix liest sie aus dem Postfach, vom Scanner oder vom Handy.
- Ein kleiner Empfangsdienst, Ihre eigene Middleware neben dem ERP: Er nimmt signierte Webhooks an oder fragt `GET /events` ab, liest den Datensatz über die API und schreibt ihn über den Import, den das ERP selbst bereitstellt, etwa ein Austauschverzeichnis, eine Staging-Tabelle oder das SDK des Herstellers.
- SAP Business One: Sie verbinden es in den Einstellungen über den SAP Service Layer, und Arhivix liest daraus alle 15 Minuten Geschäftspartner, Artikel, Lager, Bestellungen, Wareneingänge und Rechnungen.
- Tools mit Webhook-Trigger und HTTP-Schritt wie Zapier, Make, n8n und Power Automate: Sie empfangen das Ereignis und lesen den Datensatz über die API.
- Microsoft Teams: Ein Kanal erhält eine Nachricht, wenn eine Rechnung erstellt, freigegeben oder abgelehnt wird, wenn eine Rechnungsfreigabe angefordert oder abgeschlossen wird und wenn eine Ausnahme erstellt wird.
- Die Gegenrichtung: Ein Workflow sendet eine signierte Nachricht an Ihr System und kann auf dessen signierte Bestätigung warten, bevor er fortfährt.
- E-Rechnungen über Peppol: Über das Konto Ihres Unternehmens bei Storecove, einem Peppol-Zugangspunkt, versendet Arhivix die Rechnungen, die Sie ausstellen (BIS Billing 3.0), und empfängt Lieferantenrechnungen.

Das ERP bleibt das führende System. Arhivix liest, prüft und leitet die Dokumente weiter, und Ihr Code übergibt die Ergebnisse.

## Was Sie bekommen, statt eine eigene Dokumenten-Pipeline zu bauen

Ein Sprachmodell auf ein PDF anzusetzen ist der kleine Teil. Eine Integration mit einem ERP braucht außerdem Erfassung, Bestätigung durch einen Menschen (human in the loop), Freigaben, einen Ort für das Original und einen Audit-Trail jeder Entscheidung. Diese Teile funktionieren in Arhivix heute.

**Teile der Integration und wo sie in Arhivix liegen**

| Teil der Integration | Was Arhivix tut | Wo Ihr Code ansetzt |
| --- | --- | --- |
| Erfassung | Upload, E-Mail-Postfächer des Unternehmens, Scanner, Handykamera und verbundene Quellen wie OneDrive, SharePoint, Google Drive, Amazon S3 und Azure Blob. | `POST /nodes/{id}/upload`: Multipart, bis 200 MiB. |
| Auslesen | OCR, vorgeschlagene Felder und 22 erkannte Dokumentarten. | `GET /nodes/{id}/metadata` liefert `ocr_status`, die Klassifizierung mit `doc_type`, eine Zusammenfassung und Tags sowie die extrahierten Rechnungsdaten. |
| Bestätigung | Die Smart Inbox zeigt einen vorgeschlagenen Ablageort und die KI-Konfidenz, und ein Mensch genehmigt oder lehnt ab. Gelesene Werte werden Feld für Feld nach der von Ihnen festgelegten Prüfregel bestätigt. | Registerwerte tragen einen Status wie `confirmed` oder `proposed`, und die Workflow-Bedingung „Ist bestätigt“ (Is confirmed) schützt die Schritte in ihrem Ja-Zweig. |
| Freigaben | Ketten aus bis zu fünf Personen oder Rollen, in fester Reihenfolge, mit Frist und Eskalation an eine Rolle. Wer die Verarbeitung gestartet hat und wer früher freigegeben hat, ist von späteren Stufen ausgenommen. | Innerhalb von Arhivix, in der Warteschlange Geschäftsfreigaben. Nach der Entscheidung läuft der Workflow von selbst weiter. |
| Geschäftsvorgang | Vorgangsakten mit einer Checkliste der erforderlichen Dokumente, verfolgten Objekten, erwarteten Dokumenten und Registern. | `POST /document-pipelines/registers/{id}/query` liefert die Zeilen eines Registers. Die Dokumente verfolgter Objekte lassen sich ebenfalls über die API lesen. |
| Speicherung und Audit-Trail | Versionen, Berechtigungen pro Arbeitsbereich und Ordner und ein Audit-Log, das API-Aktionen mit dem ausführenden Schlüssel erfasst. | `GET /nodes/{id}/versions` und `GET /nodes/{id}/download`. |

> Ihre eigenen Dokumentarten können 22 Werttypen nutzen, darunter Tabelle, Liste, Verknüpfter Datensatz und Berechneter Wert.

## Wie ein Geschäftsvorgang in Arhivix modelliert wird

Jeder Geschäftsprozess besteht aus denselben Teilen: einem Gegenstand mit Daten, Nachweisen, Regeln, einem Zustand und zulässigen Aktionen. In Arhivix ist das die Vorgangsakte, ein Case-Management-Modell, dessen Teile sehr unterschiedliche Prozesse abbilden.

**Ein Modell, zwei Prozesse**

| Teil des Vorgangs | In Arhivix | Lieferantenqualifizierung | Projektübergabe |
| --- | --- | --- | --- |
| Gegenstand | Eine Akte mit Art, Geschäftsschlüssel, Zeitraum, verantwortlicher Person und Fälligkeitsdatum. | Ein Lieferant. | Ein Projekt. |
| Nachweise | Dokumente, die anhand einer Checkliste angenommen werden. Jedes wird mit seinem Inhalts-Hash und seinem Gültigkeitsdatum erfasst. | Handelsregisterauszug, das geforderte Zertifikat und die Versicherung. | Bestandsdokumentation, Betriebsanleitungen, Garantien und Zertifikate, Prüf- und Abnahmeprotokolle. |
| Verknüpfungen | Felder vom Typ Verknüpfter Datensatz, Register und verfolgte Objekte: ein Partner, eine Anlage, eine Immobilie oder eine Art, die Sie selbst definieren. | Der Partner und seine Zertifikate. | Die Immobilie und ihre Anlagen. |
| Regeln | Pflichtpositionen mit Mindestanzahl und Ablaufprüfung, eine Prüfregel pro Feld und Workflow-Bedingungen mit 18 Operatoren. | Zertifikat und Versicherung müssen gültig sein. | Jede Gruppe braucht mindestens ein Dokument. |
| Zustand | Sammeln, Wartet auf Prüfung, Bereit für Abschlusspaket, Archiviert. | Dieselben vier Zustände. | Dieselben vier Zustände. |
| Aktionen | Fehlende Dokumente über einen sicheren Upload-Link anfordern, jedes Dokument annehmen oder ablehnen, die Sammlung bestätigen, zur Freigabe senden, benachrichtigen, Daten an ein anderes System senden. | Den Lieferanten um ein erneuertes Zertifikat bitten. | Den Auftragnehmer um die fehlenden Anleitungen bitten. |
| Ergebnis | Eine bestätigte Sammlung, ein Entscheidungsverlauf mit Aktion, Begründung und Person sowie ein abschließendes ZIP-Paket. | Ein qualifizierter Lieferant, mit Nachweis. | Ein Übergabepaket. |

> Beide Beispiele sind fertige Vorlagen in der App, neben Monatliche Mandantendokumente (Ausgangsrechnungen, Eingangsrechnungen und Kontoauszüge).

## Warum der nächste Prozess Konfiguration ist und kein neues Projekt

Zwischen dem ersten und dem zweiten Prozess bleibt die Engine dieselbe. Es ändern sich die Definitionen: Dokumentarten, Workflows und Register sowie die Aktenvorlage, der der Prozess folgt. Ihr Team legt sie in der App unter Dokumentenverarbeitung fest, und Ihr Empfangsdienst arbeitet unverändert weiter.

1. **Aufgabe wählen.** Der Einrichtungsassistent fragt, was Arhivix tun soll: Eingangsrechnungen aus E-Mails, Verträge und Fristen, Servicenachweise oder Ihr eigenes Dokument. Aktiviert wird erst, wenn Sie bestätigen.
2. **Beispiel zeigen.** Beschreiben Sie die Dokumentart oder legen Sie Beispieldokumente ab, und der Dokumentart-Assistent schlägt die Felder vor. Sie prüfen den Vorschlag, bevor etwas gespeichert wird.
3. **Testen, dann veröffentlichen.** Eine Dokumentart wird an einem Dokument mit bekannten Werten getestet, und nur die getestete Version wird veröffentlicht. Jede Version bleibt im Verlauf erhalten.
4. **Workflow zeichnen.** Der Workflow-Editor hat 24 Schritttypen: Freigabe, Bedingungen, Weiterleitung nach mehreren Regeln, Ablage, Labels, Akten, Benachrichtigungen, Fristen und Erinnerungen, Registerabfragen, parallele Pfade, Unter-Workflows, Daten an ein anderes System senden und eine externe Bestätigung anfordern.
5. **Einrichtung wiederverwenden.** Geschäftsvorlagen speichern die Definitionen von Dokumentart, Register, Ansicht und Widget als JSON-Datei, die Sie überall importieren, wo Sie dieselbe Einrichtung brauchen. Importierte Dokumentarten bleiben Entwürfe, bis sie an einem Beispiel geprüft sind.

### Was Arhivix sich merkt

- Wohin die Dokumente eines Lieferanten gehören: Hat ein Mensch Dokumente mit derselben Steuernummer des Lieferanten dreimal in dieselbe Archivgruppe abgelegt, werden neue Dokumente dieses Lieferanten automatisch dort abgelegt.
- Wie eine Dokumentart gelesen wird: „Für diese Dokumentart merken“ (Remember for this document type) speichert, wo ein Feld steht oder was es bedeutet, in einer neuen Version der Dokumentart. Diese gilt, sobald die Version getestet und veröffentlicht ist.
- Die Begriffe Ihrer Dokumente: eine Notiz pro Feld dazu, wo es steht und was es bedeutet, und gemerkte Formulierungen für Auswahloptionen.
- Die Regeln Ihrer Mitarbeitenden: Ablageregeln nach Lieferant, Dokumentart oder Kategorie, E-Mail-Regeln und Workflows.
- Jede Entscheidung: Korrekturen und Entscheidungen bleiben im Verlauf, mit Person und Begründung.

Dieses Wissen gehört Ihrem Unternehmen und wird als Regeln, Zuordnungen und Versionen von Dokumentarten gespeichert. Kundendaten werden nicht zum Training von KI-Modellen verwendet, und der Auftragsverarbeitungsvertrag hält das fest.

## REST API v1: Authentifizierung, Limits, Uploads und Fehler

- **Basispfad:** `/v1/api/v1`, wobei beide `v1` Teile zum Pfad gehören. Eine API für alle Regionen: Das Unternehmen ergibt sich aus dem Schlüssel.
- **Authentifizierung:** `Authorization: Bearer <key>` oder `X-API-Key: <key>`. Schlüssel beginnen mit `ak_live_`.
- **Schlüssel:** Ein Administrator oder die integrierte Rolle Entwickler erstellt sie unter Einstellungen, Developer API. Ein Schlüssel hat einen Namen, Berechtigungen pro Bereich, ein Rate Limit, ein optionales Ablaufdatum und eine optionale IP-Allowlist und wird nur einmal angezeigt.
- **Zugriffsmodell:** Ein Schlüssel ist eine eigene Dienstidentität. Berechtigungen begrenzen die Operationen, Unternehmensrollen bestimmen, welche Ressourcen der Schlüssel erreicht, und ein neuer Schlüssel startet ohne Zugriff auf Ressourcen, bis ein Mensch ihn prüft.
- **Rate Limit:** Pro Schlüssel 10 bis 10.000 Anfragen pro Minute, standardmäßig 1.000. Antworten enthalten `X-RateLimit-Limit`, `X-RateLimit-Remaining` und `X-RateLimit-Reset`.
- **Schreibzugriffe:** Jeder Schreibzugriff trägt einen `Idempotency-Key` Header. Ein abgeschlossenes Ergebnis wird sieben Tage lang erneut ausgeliefert, ein Retry ist also sicher.
- **Uploads:** `multipart/form-data`, bis 200 MiB, mit dem Header `X-Arhivix-Request-SHA256`: dem SHA-256 des exakten Request-Bodys. Ein Upload stellt OCR automatisch in die Warteschlange.
- **Ergebnisse:** `GET /nodes/{id}/metadata` liefert `ocr_status`, die Klassifizierung mit `doc_type`, Kategorie, eine Zusammenfassung und Tags sowie die extrahierten Rechnungsdaten. `GET /nodes/{id}/text` liefert den OCR-Text Seite für Seite.
- **Register:** `POST /document-pipelines/registers/{id}/query` liefert die Werte, die für Ihre eigenen Dokumentarten gelesen wurden. Jeder Wert trägt einen Status wie `confirmed` oder `proposed`, und ein Filter kann einen bestimmten Status abfragen.
- **Listen:** Keyset-Paginierung: `limit` von 1 bis 100 und der Cursor aus `meta.pagination.next_cursor`.
- **Änderungsfeed:** `GET /events` liefert Ereignisse, die ältesten zuerst, aus demselben Log, aus dem auch die Webhooks gespeist werden.
- **Suche:** `GET /search`, mit Filtern nach Dokumentart, Kategorie und Arbeitsbereich.
- **Fehler:** Ein einheitliches Format für jeden Fehler: `error`, `message` und `meta.request_id`. Senden Sie `X-Request-ID`, um Ihre Logs mit unseren abzugleichen.
- **Referenz:** Eine OpenAPI 3.1 Beschreibung, JSON Schemas für die Webhook-Ereignisse und Client-Beispiele in Go und JavaScript. Wir senden sie auf Anfrage.

Einen Scan hochladen und lesen, was Arhivix vorgeschlagen hat. `BASE_URL` endet auf `/v1/api/v1`.

```bash
# Upload a document into a folder. The digest covers the exact multipart body.
boundary="bridge-example-boundary"
body="$(mktemp)"
{
  printf -- '--%s\r\nContent-Disposition: form-data; name="file"; filename="invoice.pdf"\r\nContent-Type: application/octet-stream\r\n\r\n' "$boundary"
  cat invoice.pdf
  printf '\r\n--%s--\r\n' "$boundary"
} > "$body"

curl --fail-with-body -sS \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: invoice-4471-upload" \
  -H "X-Arhivix-Request-SHA256: $(sha256sum "$body" | awk '{print $1}')" \
  -H "Content-Type: multipart/form-data; boundary=$boundary" \
  --data-binary "@$body" \
  "$BASE_URL/nodes/$FOLDER_ID/upload"

# OCR and reading start by themselves. Read the result with the id from the response:
curl --fail-with-body -sS \
  -H "Authorization: Bearer $API_KEY" \
  "$BASE_URL/nodes/$NODE_ID/metadata"
```

## Signierte Webhooks

Eine Webhook-Adresse fügen Sie in der App unter Einstellungen, Developer API, Webhooks hinzu: eine öffentliche HTTPS-Adresse, mit allen Ereignissen oder nur den ausgewählten. Das Signing Secret wird nur einmal angezeigt. Soll Ihr System nur über bestätigte Daten benachrichtigt werden, setzen Sie im Workflow den Schritt „Daten an ein anderes System senden“ (Send data to another system) hinter die Bedingung „Ist bestätigt“.

- **Ereignisse:** `document.created`, `file.uploaded`, `email.received`, `invoice.created`, `invoice.updated`, `invoice.deleted`, `invoice.approved`, `invoice.rejected`, `invoice.storno`, `approval.requested`, `approval.completed`, `exception.created`, `exception.resolved`, `despatch_advice.created`, `despatch_advice.received`.
- **Aus einem Workflow:** Der Schritt „Daten an ein anderes System senden“ sendet eine signierte Nachricht mit dem Dokumentlink an das von Ihnen konfigurierte Ziel. „Externe Bestätigung anfordern“ (Request external confirmation) wartet auf einen signierten Callback Ihres Systems.
- **Payload:** Bewusst klein: Ereignis-ID, Ereignisname, Zeitpunkt, Unternehmen sowie ID, Typ und Name des Datensatzes. Der Empfangsdienst liest den Datensatz über die API.
- **Signatur:** `X-Arhivix-Signature` enthält `sha256=` und den HMAC-SHA256 über `X-Arhivix-Timestamp`, einen Punkt und den unveränderten Request-Body, mit Ihrem Secret als Schlüssel. Lehnen Sie einen Zeitstempel ab, der mehr als 300 Sekunden abweicht.
- **Zustellung:** Jede 2xx-Antwort gilt als Bestätigung. Eine fehlgeschlagene Zustellung wird nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 8 Stunden, 24 Stunden und 36 Stunden wiederholt: acht Versuche über etwa 70 Stunden.
- **Duplikate:** Die Zustellung erfolgt mindestens einmal. Deduplizieren Sie anhand der Ereignis-`id` oder von `X-Arhivix-Delivery`.
- **Zustellverlauf:** Jede Zustellung zeigt ihre Versuche, den HTTP-Code, die Payload und die letzte Antwort Ihres Endpunkts, mit Erneut versuchen und Erneut senden. Ein Testereignis senden Sie mit einem Klick.

Der Body eines `file.uploaded` Ereignisses.

```json
{
  "id": "evt_653a9632df26297d6d685aebb8e553fc779785cb260ed6002c4bd0d2d2e1556d",
  "event": "file.uploaded",
  "schema_version": 1,
  "schema": "https://arhivix.com/schemas/webhooks/v1/file.uploaded.schema.json",
  "occurred_at": "2026-08-10T09:00:00Z",
  "timestamp": "2026-08-10T09:00:00Z",
  "company_id": "company_example",
  "data": {
    "id": "node_example",
    "event_id": "workflow_occurrence_example",
    "target_type": "node",
    "name": "receipt.pdf",
    "triggered_by": "user_example"
  }
}
```

Signaturprüfung in Node.js. Prüfen Sie zuerst die unveränderten Bytes und parsen Sie danach das JSON.

```javascript
import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody:   the request body as a Buffer, captured before JSON parsing
// timestamp: header X-Arhivix-Timestamp
// signature: header X-Arhivix-Signature
export function verifyWebhook({ rawBody, timestamp, signature, secret }) {
  const now = Math.floor(Date.now() / 1000);
  const match = /^sha256=([a-f0-9]{64})$/.exec(signature ?? '');
  if (!/^[0-9]+$/.test(timestamp ?? '') || Math.abs(now - Number(timestamp)) > 300 || !match) {
    return false;
  }
  const expected = createHmac('sha256', secret)
    .update(timestamp, 'utf8')
    .update('.', 'utf8')
    .update(rawBody)
    .digest();
  const supplied = Buffer.from(match[1], 'hex');
  return supplied.length === expected.length && timingSafeEqual(supplied, expected);
}
```

## MCP: Assistenten und Agenten mit Ihren Unternehmensdokumenten

Arhivix betreibt einen gehosteten MCP-Server unter `https://mcp.arhivix.com/mcp`. Sie tragen die Adresse in Ihrem Client ein, melden sich im Browser bei Arhivix an und genehmigen den Zugriff für ein Unternehmen. Ein API-Schlüssel muss nicht kopiert werden.

- **Clients:** Claude als benutzerdefinierter Connector, Claude Code und Codex, mit fertigen Befehlen in der App.
- **Anmeldung:** OAuth mit PKCE und dynamischer Client-Registrierung.
- **Wer genehmigt:** Ein Administrator oder eine Person mit der Rolle Entwickler, jeweils für ein Unternehmen.
- **Lesen:** Suchen und Lesen sind immer enthalten: Dokumente, Metadaten, Rechnungen, Artikel, Partner, Automatisierungen und Benutzer, soweit die Rolle der genehmigenden Person es zulässt.
- **Änderungen:** „Änderungen erlauben“ (Allow changes) ist optional und umfasst Laufwerke, Ordner, Uploads, Artikel, Partner, Automatisierungen und Entwürfe. Ausstellen und Versenden bleiben Sache von Menschen.
- **Kontrolle:** Die Verbindung erhält einen eigenen Schlüssel mit begrenztem Zugriff, eigenem Anfragelimit und Ablaufdatum. Er erscheint unter Einstellungen, Developer API, API-Schlüssel, wo Sie ihn sofort widerrufen können.

Dieselbe Adresse funktioniert in jedem Client.

```bash
# Claude Code
claude mcp add --transport http --scope user arhivix "https://mcp.arhivix.com/mcp"

# Codex
codex mcp add arhivix --url "https://mcp.arhivix.com/mcp"
codex mcp login arhivix
```

## Hosting, Speicherung und Nutzung Ihrer Daten

- **Hosting:** AWS in der EU (Frankfurt und Dublin).
- **Verschlüsselung:** AES-256 im Ruhezustand und TLS bei der Übertragung.
- **KI und Ihre Daten:** Kundendaten werden nicht zum Training von KI-Modellen verwendet. Der Auftragsverarbeitungsvertrag hält das fest.
- **Ihr Bucket als Quelle:** Arhivix liest neue Dokumente aus Ihrem Amazon S3 Bucket, über eine Rolle mit reinem Lesezugriff in Ihrem AWS-Konto, oder aus Ihrem Azure Blob Container.
- **Ihr eigener Speicher:** Enterprise unterstützt Bring Your Own Storage: Der Bucket bleibt in Ihrem Konto, unter Ihren Schlüsseln und Ihrer Rechtsordnung, während Arhivix die Dokumente weiterhin über dieselbe API verarbeitet, indexiert und bereitstellt.
- **Isolation:** Das Unternehmen ergibt sich aus dem Schlüssel, ein Schlüssel erreicht also die Daten genau eines Unternehmens.
- **Audit-Trail:** API-Aktionen werden mit Dienstidentität und Schlüssel ins Audit-Log geschrieben, und das Log lässt sich exportieren.

Das vollständige Bild finden Sie auf der Seite [Sicherheit](https://arhivix.com/de/security).

## Fragen von Entwicklern

### Kann ich PDFs selbst an ein Sprachmodell senden, statt eine Dokumentenschicht zu nutzen?

Das können Sie, und der Modellaufruf ist der kleine Teil. Bevor ein Wert ins ERP gelangen darf, muss jemand das Dokument empfangen, das Gelesene bestätigen, es freigeben, das Original mit seinen Versionen aufbewahren und festhalten, wer was entschieden hat. Diese Teile übernimmt Arhivix, und Ihrem Code bleibt die ERP-Seite.

### Wie halte ich einen unbestätigten Wert aus dem ERP heraus?

Setzen Sie die Prüfregel des Felds auf Muss bestätigt werden und stellen Sie die Bedingung „Ist bestätigt“ vor den Schritt, der Daten an ein anderes System sendet. So benachrichtigt nur der bestätigte Zweig Ihren Empfangsdienst. Der Empfangsdienst liest die Werte dann aus einem Register, in dem jeder Wert seinen Status trägt, etwa `confirmed`.

### Welche Dokumente liest Arhivix?

Es erkennt 22 Dokumentarten, darunter Rechnungen, Verträge, Lieferscheine, Gutschriften, Kontoauszüge, Zertifikate, Garantien und Angebote. Für jedes andere Dokument, etwa eine Bestellung oder einen Servicenachweis, definieren Sie eine eigene Dokumentart und wählen ihre Felder.

### Lernt Arhivix aus Korrekturen, und wird ein Modell mit meinen Dokumenten trainiert?

Es merkt sich, was Ihre Mitarbeitenden bestätigen: wohin die Dokumente eines Lieferanten gehören, wo ein Feld in einer Dokumentart steht, welche Begriffe welche Option bedeuten. Dieses Wissen wird als Regeln und Versionen von Dokumentarten Ihres Unternehmens gespeichert. Kundendaten werden nicht zum Training von KI-Modellen verwendet, und der Auftragsverarbeitungsvertrag hält das fest.

### Was passiert, wenn mein Empfangsdienst nicht erreichbar ist?

Arhivix wiederholt eine fehlgeschlagene Zustellung nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 8 Stunden, 24 Stunden und 36 Stunden: acht Versuche über etwa 70 Stunden. Der Zustellverlauf speichert jeden Versuch, mit Erneut versuchen und Erneut senden, und über den Änderungsfeed `GET /events` holt Ihr Code Verpasstes nach.

### Wie vermeide ich, dasselbe Ereignis zweimal zu verarbeiten?

Die Zustellung erfolgt mindestens einmal, deduplizieren Sie also anhand der Ereignis-`id` oder von `X-Arhivix-Delivery`. Schreibzugriffe auf die API tragen einen `Idempotency-Key`, und ein abgeschlossenes Ergebnis wird sieben Tage lang erneut ausgeliefert.

### Können KI-Agenten mit unseren Dokumenten arbeiten?

Ja. Der gehostete MCP-Server unter `https://mcp.arhivix.com/mcp` verbindet Claude, Claude Code und Codex nach einer Anmeldung im Browser. Der Lesezugriff folgt der Rolle der Person, die die Verbindung genehmigt hat. Änderungen sind optional und enden vor dem Ausstellen und Versenden, die Sache von Menschen bleiben.

### Wo werden die Daten gespeichert?

Auf AWS in der EU (Frankfurt und Dublin), im Ruhezustand mit AES-256 verschlüsselt. Enterprise-Kunden können die Dokumente in ihrem eigenen S3-kompatiblen Bucket unter ihren eigenen Schlüsseln aufbewahren.

### Wie fange ich an?

Erstellen Sie ein Konto im kostenlosen Paket und fügen Sie einige echte Dokumente hinzu, um zu sehen, wie Arhivix sie liest. REST API v1 und signierte Webhooks sind in jedem kostenpflichtigen Paket enthalten, und Schlüssel erstellen Sie unter Einstellungen, Developer API. Fordern Sie die OpenAPI-Referenz an, wenn Sie Ihren ersten Schlüssel erstellen.
