Die Salesforce-Schnittstelle überträgt Kunden, Ansprechpartner und Opportunities aus Salesforce nach ZEP. Salesforce ist dabei das führende System für alle importierten Datensätze.
Richtung Daten: Salesforce → ZEP
Produktlinienverfügbarkeit
Hinweis: Die Salesforce-Schnittstelle ist in ZEP Track, ZEP Control, ZEP Operations und ZEP Business enthalten. Eine Zubuchung ist nicht erforderlich. In ZEP Clock erscheint sie nicht im Schnittstellen Marktplatz, weil dort nur die Personalschnittstellen angeboten werden.
Die Einrichtung und Konfiguration ist Administratoren vorbehalten.
Voraussetzungen
Für die Einrichtung benötigen Sie:
Salesforce-Zugangsdaten für einen der beiden Anmeldewege. Für OAuth 2.0 (empfohlen) sind das My-Domain-URL (OAuth), Consumer-Schlüssel (OAuth) und Consumer-Geheimnis (OAuth), für die Legacy-Anmeldung (Token) Benutzername, Kennwort und Sicherheitstoken. Die Auswahl zwischen beiden Wegen erscheint nur, solange noch Legacy-Zugangsdaten gespeichert sind. Richten Sie die Schnittstelle neu ein oder ist die Umstellung auf OAuth abgeschlossen, zeigt ZEP ausschließlich die OAuth-Felder
Administrator-Zugang in ZEP
Zugang zu Administration > Schnittstellen > Schnittstellen Marktplatz
Vorsicht: Salesforce schränkt die Anmeldung per Benutzername, Kennwort und Sicherheitstoken schrittweise ein. Ab dem Salesforce-Release Winter ’27 braucht der verwendete Salesforce-Benutzer zusätzlich die Berechtigung Beliebige API-Authentifizierung verwenden, mit Sommer ’27 schaltet Salesforce diesen Anmeldeweg ganz ab. Das sind Releasenamen von Salesforce und keine Kalenderjahre, die Termine liegen also früher als die Jahreszahl vermuten lässt. Stellen Sie bestehende Verbindungen rechtzeitig auf OAuth 2.0 um, sonst bricht der Abgleich ab.
Schnittstelle einrichten
Öffnen Sie in ZEP Administration > Schnittstellen > Schnittstellen Marktplatz und wählen Sie den Anmeldeweg.
Für OAuth 2.0 (empfohlen) tragen Sie drei Werte ein:
My-Domain-URL (OAuth): die Adresse Ihrer Salesforce-Org in der Form https://firma.my.salesforce.com. Sie finden sie in Salesforce unter Setup > My Domain.
Consumer-Schlüssel (OAuth) und Consumer-Geheimnis (OAuth): beide stammen aus der External Client App, die Sie in Salesforce für ZEP anlegen.
In Salesforce muss diese App den Client Credentials Flow aktiviert haben und einen Benutzer hinterlegen, unter dem sie ausgeführt wird. Fehlt eines von beidem, lehnt Salesforce die Anmeldung ab und ZEP nennt genau diese beiden Punkte in der Fehlermeldung.
Für die auslaufende Legacy-Anmeldung (Token) tragen Sie stattdessen ein:
Benutzername: Ihr Salesforce-Benutzername
Kennwort: Ihr Salesforce-Kennwort
Token: Den Sicherheitstoken aus den Profilsicherheitseinstellungen Ihres Salesforce-Kontos
Speichern Sie die Einstellungen. Anschließend können Sie den Import starten.
Optionale Einschränkung des Importumfangs
Sie können steuern, welche Salesforce-Accounts nach ZEP übertragen werden: Legen Sie dazu in Salesforce ein benutzerdefiniertes Feld mit dem Namen „ZEP“ an. Nur Accounts, bei denen dieses Feld deaktiviert ist (Wert false), werden vom Import ausgeschlossen. Ist das Feld aktiviert oder leer, wird der Account importiert.
Salesforce erstellt beim Anlegen automatisch den API-Namen ZEP__c – dieser Name darf nicht geändert werden.
Datenübertragung
Die Salesforce-Schnittstelle überträgt verschiedene Datenobjekte zwischen beiden Systemen.
Accounts als Kunden
ZEP importiert folgende Felder aus Salesforce-Accounts in die ZEP-Kundenstammdaten:
Salesforce (Accounts) | ZEP (Kundendaten) |
Accountnummer | KNr |
IsDeleted | aktiv/inaktiv |
Accountname | Name |
Straße (Rechnungsanschrift), Bundesland | Adresszeilen |
PLZ (Rechnungsanschrift) | PLZ |
Stadt (Rechnungsanschrift) | Ort |
Land (Rechnungsanschrift) | Land |
Telefon | Telefon |
Fax | Fax |
Webseite | WWW |
Beschreibung | Bemerkung |
Hinweis: Salesforce ist das führende System. Importierte Kundendaten können in ZEP nicht geändert werden, solange die Verbindung zu Salesforce besteht. Zusätzlich wird die Lieferadresse synchronisiert. Die Standardadresse wird als Rechnungsadresse gesetzt.
Kontakte als Ansprechpartner
Salesforce-Kontakte werden als Kunden-Ansprechpartner in ZEP importiert. Die folgende Tabelle zeigt, welches Salesforce-Feld in welches ZEP-Feld übernommen wird. Felder, die Salesforce anders benennt als ZEP, sind dabei mitaufgeführt, damit Sie die Zuordnung nachvollziehen können:
Salesforce (Kontakte) | ZEP (Kunden-Ansprechpartner) |
Salutation | Anrede, aus den Werten Mr., Ms. und Mrs. abgeleitet |
Vorname | Vorname |
Nachname | Name |
Titel | Berufsbezeichnung |
Telefon | Tel |
Fax | Fax |
Mobiltelefon | Handy |
Beschreibung | Bemerkung |
Opportunities als Projekte
Salesforce-Opportunities können automatisch als Projekte in ZEP angelegt werden. Konfigurieren Sie dazu in den Schnittstelleneinstellungen, bei welchen Opportunity-Phasen ZEP ein Projekt erstellen soll.
Folgende Salesforce-Phasen stehen zur Auswahl:
Prospecting
Qualification
Needs Analysis
Value Proposition
Id. Decision Makers
Perception Analysis
Proposal/Price Quote
Negotiation/Review
Closed Won
Closed Lost
Aktivieren Sie die Phasen, bei deren Erreichen ZEP automatisch ein neues Projekt anlegen soll. Wird eine Opportunity in Salesforce in eine der ausgewählten Phasen verschoben, legt ZEP beim nächsten Import ein zugehöriges Projekt an.
Synchronisation einrichten
Die Synchronisation richtet sich in ZEP über Administration > System > Tasks ein. Legen Sie dort eine neue Task Salesforce-Import an, um den Import automatisch in regelmäßigen Abständen auszuführen.
Über die Einstellung Kunden Import legen Sie fest, was der nächste Import-Lauf überträgt:
Kompletter Import: Überträgt alle Datensätze aus Salesforce. Beim ersten Import ist nur diese Option verfügbar.
Nur Änderungen seit dem letzten erfolgreichen Lauf: Überträgt nur Datensätze, die seit dem letzten vollständigen Import geändert wurden. Steht erst nach einem ersten vollständigen Import zur Verfügung.
Den Import können Sie jederzeit manuell anstoßen: unter Administration > System > Tasks über die Aktion Task jetzt ausführen. Salesforce ist das führende System für alle importierten Daten. Änderungen nehmen Sie direkt in Salesforce vor.
Um die Verbindung eines Kunden zu Salesforce zu lösen, klicken Sie in den Kundenstammdaten auf Kennzeichnung als Salesforce Kunde entfernen. Die Verbindung lässt sich jederzeit über Aus Salesforce-Kunden importieren wiederherstellen.