Datenimport

Shopdatenimport

Es gibt zwei Wege, Shopdaten in Customa zu importieren: die REST API und die Importer.

REST API (Push)

Mit Hilfe der REST API können Daten schnell und bei Bedarf in Customa importiert werden. Dabei gliedert sich der Prozess wie folgt:

Der Shop oder das ERP-System senden Anfragen an die REST API von Customa.
Die REST API von Customa schreibt die Daten in die Datenbank. Die Daten sind ab diesem Zeitpunkt verfügbar und können sofort danach via API danach ausgelesen oder durchsucht werden.
Im Hintergrund läuft ein Prozess an, welcher die Daten weiter aufbereitet und für die Statistiken indexiert. Dabei werden auch ggf. fehlende Daten, wie z.B. Einkaufspreise ergänzt.

---
title: Importprozess via REST API
---
sequenceDiagram
    autonumber
    actor Shop as Shop/ERP
    box Customa
        participant REST API
        participant Aufbereitung
        participant Datenbank
        participant Indexierung
    end
    Shop->>REST API: Push der Daten
    activate REST API
    REST API->>Datenbank: Basisdaten speichern
    REST API-)Aufbereitung: Aufbereitung anstoßen
    activate Aufbereitung
    REST API-->>Shop: API-Aufruf abschließen
    deactivate REST API
    Aufbereitung->>Aufbereitung: Daten aufbereiten
    Aufbereitung->>Datenbank: Aufbereitete Daten speichern
    Aufbereitung-)Indexierung: Indexierung anstoßen
    deactivate Aufbereitung

Vorteile

Daten sind schnell verfügbar
Push ist jederzeit möglich

Nachteile

Das Quellsystem muss eine Anbindung an die Customa-API besitzen, ggf. muss diese erst entwickelt werden

Importer (Pull)

Die Importer sind Teil von Customa und ermöglichen die Anbindung von unterstützen Shop- oder ERP-Systemen, ohne einen Client für die REST API implementieren zu müssen. Der Ablauf gestaltet sich nach folgendem Schema:

Der Importprozess wird seitens Customa zeitgesteuert angestoßen
Die Importer fragen die Shops oder ERP-Systeme über deren API nach Änderungen in den Produkten, Kunden und Belegen ab
Alle geänderten Daten landen in der Datenbank von Customa
Analog zur REST API wird ein Indexierungsprozess angestoßen, welcher die Daten aufbereitet

---
title: Importprozess via Importer
---
sequenceDiagram
    autonumber
    participant Shop as Shop/ERP
    box Customa
        actor Importer
        participant Aufbereitung
        participant Datenbank
        participant Indexierung
    end
    Importer->>Shop: Abfrage von Produkten/Kunden/Belegen
    activate Shop
    Shop-->>Importer: Antwort mit Produkten/Kunden/Belegen
    deactivate Shop
    activate Importer
    Importer->>Datenbank: Basisdaten speichern
    Importer-)Aufbereitung: Aufbereitung anstoßen
    deactivate Importer
    activate Aufbereitung
    Aufbereitung->>Aufbereitung: Daten aufbereiten
    Aufbereitung->>Datenbank: Aufbereitete Daten speichern
    Aufbereitung-)Indexierung: Indexierung anstoßen
    deactivate Aufbereitung

Vorteile

Es entfällt der Entwicklungsaufwand für eine Anbindung an die REST API

Nachteile

Die Unterstützung der Quellsysteme muss in Customa implementiert sein
Der Abruf der Daten erfolgt Zeitgesteuert, d.h. die Daten werden ggf. langsamer aktualisiert

Klardaten

In der Konfiguration des Importers gibt es die Option Klardaten zu importieren. Wenn der Import mit Klardaten aktiv ist, werden u.a. Name, Adresse, Ort, Telefonnummer und die E-Mailadresse des Kunden importiert. Alternativ werden Platzhalterwerte in Customa gespeichert. Diese Option bezieht sich nur auf den Import von neuen Daten, bereits in Customa importierte Daten bleiben davon unberührt. Des weiteren ist zu beachten, dass bei Änderung dieser Option die Zuordnung der Kunden und Belege sich je nach Importer ändert. Dies kann zu doppelten Daten nach dem Import führen, falls neue Daten z.B. aufgrund fehlender E-Mailadressen nicht mehr den bestehenden Daten zugeordnet werden können.