# AIVEE — Developer Documentation (Full)

Technische Dokumentation fuer die Integration mit AIVEE.

---

## Technische Anbindung

> SFTP-basierter Datenaustausch — Bestands- und Verkaufsdaten importieren, Preisempfehlungen exportieren.

> **Note:**
Wenn Sie eines der folgenden Warenwirtschaftssysteme verwenden, bietet AIVEE eine **native Integration** an — kein manueller CSV-Import nötig:

- [**advarics**](https://advarics.net)
- [**prohandel**](https://prohandel.de)
- [**REMIRA**](https://remira.com)
- [**HILTES**](https://hiltes.com)

Kontaktieren Sie uns unter support@michelberger.digital für die Einrichtung.

Falls Sie ein anderes System nutzen, kommen Sie gerne auf uns zu bezüglich einer Connector-Anbindung. Alternativ ist auch immer eine Anbindung über **SFTP/API** möglich (siehe unten).

AIVEE kommuniziert über **SFTP** mit dem Quellsystem. Bestands- und Verkaufsdaten werden als CSV-Dateien importiert, Preisempfehlungen als CSV-Dateien exportiert.

## Datenfluss

```
┌──────────────────┐          SFTP           ┌──────────────────┐          SFTP           ┌──────────────────┐
│                  │  ──────────────────────▶ │                  │ ──────────────────────▶ │                  │
│   Quellsystem    │   /stock  (Bestände)     │      AIVEE       │   /prices  (Preise)     │   Quellsystem    │
│   (ERP/WaWi)     │   /sales  (Verkäufe)     │   Pricing Engine │                         │   (ERP/WaWi)     │
│                  │  ──────────────────────▶ │                  │                         │                  │
└──────────────────┘                          └──────────────────┘                         └──────────────────┘
      Upload                                   Verarbeitung                                     Download
   täglich/stündlich                           täglich 05:00 UTC                              täglich/stündlich
```

## Ablauf einer typischen Integration

```
Tag 1                  Tag 2                  Tag 3                  Laufend
┌────────────────┐     ┌────────────────┐     ┌────────────────┐     ┌────────────────┐
│ SFTP-Zugang    │     │ Erster         │     │ Erste          │     │ Automatischer  │
│ einrichten     │────▶│ Vollimport     │────▶│ Preisdateien   │────▶│ täglicher      │
│                │     │ (Stock+Sales)  │     │ verfügbar      │     │ Datenaustausch  │
└────────────────┘     └────────────────┘     └────────────────┘     └────────────────┘
```

## SFTP-Verbindung

```
sftp {Account ID}@sftp.aiv.ee
```

- **Account ID** (Benutzername) und **API Key** (Passwort) werden von AIVEE bereitgestellt
- Kontakt: support@michelberger.digital

### Verbindung testen

```
# Terminal (Linux/macOS)
sftp {Account ID}@sftp.aiv.ee
pwd
put testfile.txt
```

Alternative SFTP-Clients: WinSCP, Cyberduck, FileZilla.

---

## API

AIVEE bietet eine REST-API. Die Authentifizierung laeuft ueber einen
Account-API-Key im Header `x-api-key`; Keys werden pro Konto unter
Einstellungen -> API-Clients verwaltet.

Die vollstaendige OpenAPI-3.1-Referenz geben wir zusammen mit den
Zugangsdaten heraus. Anfragen ueber /contact.