pFlex

# PrestaShop Sync für PROFFIX

Synchronisiert Artikel inkl. Bilder und Zusatzfelder sowie Bestellungen zwischen PROFFIX und PrestaShop

alt text

# Features

  • Synchronisiert Produkte, Artikel mit Zusatzfeldern und Bildern sowie Bestellungen zwischen PROFFIX und PrestaShop
  • Unabhängige Benutzerverwaltung (keine PROFFIX Benutzer nötig)
  • Verwendet aktuellste Schnittstellen (PROFFIX REST API, Presta Webservice API)
  • Einfache Konfiguration direkt im WebUI
  • Kann lokal oder auf Server als kleiner Dienst installiert werden
  • Erstellen von Synchronisations-Tasks für vollautomatische Synchronisation ohne Benutzereingriff
  • Plattformunabhängig. Siehe auch Installation

# Konfiguration

Die Konfiguration kann direkt im WebUI erfolgen.

alt text

# Benutzer

Es können beliebig viele Benutzer mit unterschiedlichen Berechtigungen konfiguriert werden.

alt text

# Tasks / Aufgaben

Die unterschiedlichen Synchronisationen können als Tasks definiert werden. Diese laufen vollautomatisch in definierbaren Intervallen durch.

alt text

Sämtliche Aufgaben laufen ansynchron in einem separaten Prozess - d.h. der Benutzer muss zu keinem Fall auf ein Ergebnis warten.

Der jeweilige Status wird live in der Kopfzeile angezeigt:

alt text

(im obigen Beispiel läuft 1 Synchronisationsaufgabe, 5 neue Logeinträge sind vorhanden)

# Artikelbilder

Artikelbilder werden synchronisiert, sofern der Haken Webshop beim Bild in PROFFIX gesetzt ist.

alt text

TIP

Die Bildpfade müssen in der PROFFIX REST-API korrekt konfiguriert werden. Bitte dazu u.a. die Anleitung für die PROFFIX REST-API (opens new window) beachten.

WARNING

Bei einer Synchronisation werden bestehende Artikelbilder in PrestaShop vollständig ersetzt.

# Zusatzfelder

Auf dem Artikel definierte Zusatzfelder können in PrestaShop synchronisiert werden.

Das Tool erstellt dabei sämtliche Definitionen und Zuweisungen in PrestaShop vollautomatisch und verlinkt diese auch untereinander (d.h. die Werte des Zusatzfeldes Z_Farbe sind dann z.B. in PrestaShop filter- und sortierbar)

Die Felder müssen dazu einmalig unter Einstellungen angegeben werden.

alt text

Mittels Klick auf den Button Zusatzfelder synchronisieren wird die interne Definition sowie die Definition in Presta neu aufgebaut.

TIP

Bestehende Features (=Zusatzfelder in PrestaShop) werden bei der Synchronisation nur überschrieben, wenn das Zusatzfeld denselben Namen trägt. Ansonsten werden sämtliche Werte beibehalten.

# Synchronisation

Das Tool verwendet möglichst intelligente Synchronisationsabläufe. Grundsätzlich orientiert es sich dabei an den Zeitstempeln Geändert Am in PROFFIX bzw. Last Changed in Prestashop.

Bei Problemen mit der Synchronsation, kann diese für die jeweiligen Prozesse zurückgesetzt werden.

alt text

Auch das komplette Löschen von internen Presta Produkten bzw. PROFFIX Artikeln ist möglich (hat keinen Einfluss auf Artikel in PROFFIX oder in PrestaShop!)

# Logs

Sämtliche Synchronisationsvorgänge werden geloggt und können jederzeit überprüft werden.

alt text

TIP

Verwenden Sie den Task Logeinträge automatisch bereinigen um Logs z.B. nach 3 Tagen automatisch zu löschen (kritische Logs bleiben erhalten)

# Installation

Das Tool / Webservice besteht aus einer einzigen, kompilierten Datei und muss grundsätzlich nicht installiert sondern kann auch einfach ausgeführt werden.

Für den produktiven Einsatz empfiehlt sich die Installation als Service (Windows / Linux / Mac).

# Erstinstallation

Beim erstmaligen Öffnen erstellt das Tool automatisch folgende Dateien:

In der Standardkonfiguration ist das App dann unter http://127.0.0.1:1323 (opens new window) erreichbar. Die Anmeldedaten für den erstmaligen Login sind admin mit dem Passwort 123456

# Installation als Service

  1. Neuen Ordner erstellen (z.B. C:\PrestaSync)
  2. Tool hineinkopieren. Evtl. vorgängig erstellte cfg.json / prestaproffix.db mitkopieren
  3. Die Kommandozeile als administrativer Benutzer öffnen und das Tool mit dem Parameter -install installieren
  4. Das Tool ist nun als Dienst installiert und kann z.B. über die Windows Diensteverwaltung gestartet / gestoppt werden

TIP

Bei Änderungen an der Konfiguration (z.B. neuer Port, neues SSL-Zertifikat) muss der Dienst neu gestartet werdens

# Konfiguration Webservice

Beim Start / Installation wird im Ordner der ausführbaren Datei automatisch ein cfg.json erstellt.

{
  "Port": 1323,
  "SSLCert": "",
  "SSLKey": "",
  "LetsEncrypt": false
}
Parameter Typ Bemerkung
Port int Port des Webapps
SSLCert string Pfad zum .crt - File des SSL - Zertifikats (fakultativ)
SSLKey string Pfad zum .key - File des SSL - Zertifikats (fakultativ)
LetsEncrypt bool Wenn aktiv wird automatisch ein LetsEncrypt - Zertifikat generiert.

Um automatisch ein LetsEncrypt Zertifikat zu generieren, muss der Aufruf via DNS - Adresse und nicht via IP - Adresse erfolgen.

  • ❌ 192.168.1.189:1323
  • ❌ 127.0.0.1:1323
  • ✅ demo.mycompany.ch:1323

TIP

Um sämtliche Features des Webapps (PWA / progressives Webapp) zu nutzen, muss SSL konfiguriert werden!

# Demoversion

Eine Demoversion dieses Tools kann einfach und unkompliziert automatisch bezogen werden. Details dazu finden Sie unter Demo

← Theoretischer Lagerbestand Proffix →