Sellsy PrestaShop Connector – Dokumentation

Überblick

Der Sellsy-Connector von DataFirefly verbindet Ihren PrestaShop-Shop mit Sellsy, der französischen SaaS-Lösung für CRM, Rechnungsstellung und Verwaltung. Er synchronisiert automatisch Ihre Kunden, Produkte, Bestellungen, Rechnungen, Zahlungen und Gutschriften von PrestaShop nach Sellsy über die Sellsy-API v2. Die Synchronisierung erfolgt in eine Richtung: PrestaShop → Sellsy.

Installation

1. Gehen Sie im PrestaShop-Backoffice zu Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und laden Sie die Datei dfsellsy.zip hoch.
3. Klicken Sie nach der Installation auf Konfigurieren.

Das Modul erstellt zwei Tabellen (dfsellsy_link für die Zuordnung PrestaShop ↔ Sellsy, dfsellsy_log für das Protokoll) und einen Reiter „Sellsy Connector“ im Modul-Menü.

API-Zugang in Sellsy erstellen

Der Connector verwendet die OAuth2-Authentifizierung (Client Credentials) der v2-API.

1. Öffnen Sie in Sellsy Menü > Einstellungen > Entwicklerportal.
2. Klicken Sie im Reiter API V2 auf API-Zugang erstellen.
3. Wählen Sie den mit dem Zugang verknüpften Mitarbeiter (vorzugsweise ein Administrator, um alle Rechte zu haben) und aktivieren Sie die erforderlichen Scopes (Kunden, Dokumente, Katalog, Zahlungen).
4. Speichern Sie und kopieren Sie die Client ID und das Client Secret.

Modulkonfiguration

Geben Sie auf der Konfigurationsseite des Moduls ein:

• Client ID und Client Secret: die in Sellsy erstellten OAuth2-Zugangsdaten. Lassen Sie das Secret-Feld leer, um den bereits gespeicherten Wert beizubehalten.
• Kunden synchronisieren: erstellt/aktualisiert einen Sellsy-Geschäftspartner bei Registrierung und Aktualisierung eines Kunden.
• Bestellungen synchronisieren: wandelt Bestellungen in Sellsy-Dokumente um.
• Sellsy-Dokumenttyp für Bestellungen: Rechnung oder Auftrag.
• Auslöser für die Bestellsynchronisierung: bei Zahlungsbestätigung oder bei Bestellvalidierung.
• Sellsy-Dokumente validieren: validiert Rechnungen und Gutschriften automatisch nach der Erstellung (andernfalls bleiben sie Entwürfe in Sellsy).
• Zahlungen erfassen: erfasst PrestaShop-Zahlungen auf der Sellsy-Rechnung (nur beim Typ Rechnung).
• Erstattungen als Gutschriften synchronisieren: erstellt für jede PrestaShop-Gutschrift eine Sellsy-Gutschrift und verknüpft sie mit der Ursprungsrechnung.
• Produkte synchronisieren: überträgt den Katalog in die Sellsy-Items.

Verwenden Sie die Schaltfläche API-Verbindung testen, um Ihre Zugangsdaten vor der Aktivierung der Synchronisierungen zu prüfen.

Kundensynchronisierung

Bei der Registrierung oder Aktualisierung eines Kunden erstellt oder aktualisiert das Modul einen Sellsy-Geschäftspartner. Kunden mit ausgefülltem Firmenfeld werden zu Sellsy-Unternehmen (mit SIRET, sofern verfügbar), die übrigen zu Privatpersonen. Eine E-Mail-Suche vermeidet Duplikate, und die Haupt-Rechnungsadresse wird bei der Erstellung übertragen.

Bestellsynchronisierung

Je nach gewähltem Auslöser wird eine validierte oder bezahlte Bestellung zu einem Sellsy-Dokument mit Produktzeilen, Versand und Warenkorbrabatten (als negative Zeile). Die PrestaShop-MwSt.-Sätze werden automatisch den Sellsy-Steuern zugeordnet. Jede Bestellung wird nur einmal synchronisiert (idempotent).

Rechnungen, Validierung und Zahlungen

Wenn der Dokumenttyp „Rechnung“ ist:

• wenn die Option Dokumente validieren aktiv ist, wird die Rechnung nach der Erstellung automatisch validiert;
• wenn die Option Zahlungen erfassen aktiv ist, wird jede PrestaShop-Zahlung ohne Duplikate auf der Rechnung erfasst, einschließlich Teil- oder Mehrfachzahlungen;
• wenn die Bestellung bei der Validierung erstellt wurde und die Zahlung später eintrifft, erfasst das Modul nur die neuen Zahlungen auf der bestehenden Rechnung.

Gutschriften bei Erstattung

Bei der Erstellung einer PrestaShop-Gutschrift erstellt das Modul eine Sellsy-Gutschrift aus den erstatteten Zeilen (Produkte und Versand), validiert sie, wenn die Option aktiv ist, und verknüpft sie mit der Ursprungsrechnung, wenn diese auf der Sellsy-Seite existiert.

Produktsynchronisierung

Die Produktsynchronisierung ist optional. Nach der Aktivierung werden Produkte bei Erstellung und Aktualisierung in den Sellsy-Katalog übertragen. Sie können auch eine Massensynchronisierung von der Seite „Sellsy Connector“ aus starten (Stapel von 20).

Geplante Aufgaben (Cron)

Ein integrierter Cron ermöglicht es, alles nachzuholen, was die Echtzeit-Hooks verpasst haben. Planen Sie die auf der Konfigurationsseite angezeigten URLs:

• .../module/dfsellsy/cron?token=IHR_TOKEN&job=orders
• ...&job=customers
• ...&job=products
• ...&job=retry (wiederholt fehlerhafte, noch nicht verknüpfte Entitäten)

Der Parameter limit (Standard 20, max. 100) steuert die Stapelgröße pro Ausführung.

Synchronisierungsprotokoll

Die Seite „Sellsy Connector“ zeigt ein filterbares Protokoll (nach Entität und Status) jedes Vorgangs mit der von Sellsy im Fehlerfall zurückgegebenen Meldung. Eine Schaltfläche Fehler erneut versuchen wiederholt Fehlschläge per Klick.

Fehlerbehebung

• „Verbindung fehlgeschlagen“: Prüfen Sie die Client ID / das Client Secret und ob die erforderlichen Scopes in Sellsy aktiviert sind.
• Ein Fehler bei einem Dokumentfeld (HTTP 422): Manche Sellsy-Konten haben besondere Anforderungen (E-Invoicing-Angaben, Pflichtfelder). Prüfen Sie die Protokollmeldung, um das betreffende Feld zu identifizieren.
• Doppelte Geschäftspartner: Das Modul sucht vor der Erstellung per E-Mail; stellen Sie sicher, dass die Kunden-E-Mail ausgefüllt ist.
• Es wird nichts synchronisiert: Prüfen Sie, ob die betreffenden Optionen aktiviert sind, und testen Sie die API-Verbindung.