# Schnittstelle E-Guma

<p class="callout info">Laut Schnittstellendokumentation können Kunden oder Firmen nicht explizit abgeholt werden. Kundendaten sind immer Bestandteil einer Bestellung..  
  
**Die Schnittstellen-Integration ist nach diesem Kriterium "fragwürdig"**</p>

- Gutscheinbestellungen können zeitlich gefiltert abgerufen werden.
- Einzelne Bestellungen können abgerufen werden.
- Neue Gutscheinbestellungen können angelegt werden.
- Für neu erstellte Bestellungen existiert ein Webhook.
- Kundendaten sind Bestandteil einer Bestellung.
- Es sind **keine öffentlich dokumentierten, eigenständigen CRUD-Endpunkte für Kunden oder Firmen** ersichtlich.

#### Realisierbarkeit

<table id="bkmrk-gew%C3%BCnschte-entit%C3%A4t-r" style="width: 100%;"><thead><tr><th style="width: 29.6623%;">Gewünschte Entität</th><th align="right" style="width: 21.6356%;">Realisierbarkeit</th><th style="width: 48.7021%;">Empfohlene Richtung</th></tr></thead><tbody><tr><td style="width: 29.6623%;">Accounts</td><td align="right" style="width: 21.6356%;">Teilweise, nur über Bestellung

<span style="background-color: rgb(248, 202, 198);">nicht sinnvoll weil keine eindeutige Kennung vorhanden ist</span>

</td><td style="width: 48.7021%;">e-guma → Sage Sales Management</td></tr><tr><td style="width: 29.6623%;">Kontakte</td><td align="right" style="width: 21.6356%;">Teilweise, nur über Bestellung  
<span style="background-color: rgb(248, 202, 198);">nicht sinnvoll weil keine eindeutige Kennung vorhanden ist</span>  
</td><td style="width: 48.7021%;">e-guma → Sage Sales Management</td></tr><tr><td style="width: 29.6623%;">Sales</td><td align="right" style="width: 21.6356%;">Gut möglich</td><td style="width: 48.7021%;">e-guma → Sage Sales Management</td></tr><tr><td style="width: 29.6623%;">Aufträge</td><td align="right" style="width: 21.6356%;">Gut möglich</td><td style="width: 48.7021%;">e-guma → Sage Sales Management; optional Sage → e-guma</td></tr><tr><td style="width: 29.6623%;">Gutschein-/Produktstammdaten</td><td align="right" style="width: 21.6356%;">Möglich</td><td style="width: 48.7021%;">e-guma → Sage Sales Management</td></tr><tr><td style="width: 29.6623%;">Marketing-Einwilligung</td><td align="right" style="width: 21.6356%;">Möglich</td><td style="width: 48.7021%;">e-guma → Sage Sales Management</td></tr></tbody></table>

Die Integration ist unidirektional theoretisch möglich

## Accounts und Kontakte

Die e-guma-Bestellungen enthalten ein eingebettetes `customer`-Objekt mit:

- Kunden-ID
- Anrede
- Vorname
- Nachname
- Firma
- Adresse
- E-Mail
- Telefon
- Marketing-Einwilligung
- Zeitpunkt des Double-Opt-ins

Diese Informationen können in Sage Sales Management als Accounts und Contacts erstellt beziehungsweise aktualisiert werden.

## Zeitschätzung

### Minimaler sinnvoller Umfang

Enthalten:

- e-guma → Sage Accounts
- e-guma → Sage Contacts
- e-guma → Sage Sales
- Polling
- Datenbanktabellen
- Mapping
- Logging
- Basis-Tests

**Schätzung: 90–135 Stunden**

### Empfohlener produktiver Umfang

Zusätzlich:

- Aufträge und Positionen
- Webhook
- Stornierungen
- robuster Delta-Abgleich
- umfassende Testfälle
- Monitoring und bessere Fehlerbehandlung

**Schätzung: 130–195 Stunden**

### Erweiterter Umfang

Zusätzlich:

- Sage → e-guma Gutscheinbestellungen
- Verarbeitung von Gutscheincodes/PDF-URLs
- erweiterte Konfigurationsoberfläche
- Initialimport-Assistent
- manuelles Replay fehlgeschlagener Datensätze

**Schätzung: 160–235 Stunden**

## **Geschätzte Entwicklung gesamte Anbindung mit allem: 380 - 565 Stunden**