Integrationen

E-Gestor ERP verbinden und Kunden, Produkte und Verkäufe in das CRM holen

Verbinden Sie Ihr E-Gestor Konto mit einem persönlichen Token und übernehmen Sie Kunden, Lieferanten, Produkte, Dienstleistungen, Verkäufe und Finanzbuchungen in das CRM, ohne Dubletten anzulegen.

E-Gestor ist ein brasilianisches Cloud ERP. Nach dem Verbinden liest das CRM Ihr E-Gestor Konto und hält Kunden, Lieferanten, Produkte, Dienstleistungen, Verkäufe und Finanzbuchungen hier aktuell, verknüpft über den E-Gestor Code. Erneutes Synchronisieren legt nie Dubletten an: Es aktualisiert den bereits vorhandenen Datensatz.

Das Modell ist BYO ("bringen Sie Ihr eigenes Konto mit"): Sie nutzen Ihr eigenes E-Gestor Konto und Ihren eigenen persönlichen Token. Wir sehen Ihre Daten nie und es entstehen bei uns keine Kosten. Die Integration startet inaktiv: Es passiert nichts, bis Sie den Token einfügen und sie einschalten.

💡 Die Synchronisierung läuft in eine Richtung: von E-Gestor in das CRM. Nichts, was das CRM tut, schreibt in Ihr ERP. Verkäufe lassen sich über die E-Gestor API überhaupt nicht bearbeiten (die Dokumentation empfiehlt, sie zu löschen und neu anzulegen), und Datensätze von hier aus dort anzulegen würde Ihre Buchhaltung doppeln.

Voraussetzungen

Ein E-Gestor Konto. Es gibt keine Sandbox: Jedes Konto steht für sich. Legen Sie also ein kostenloses Testkonto an, wenn Sie die Verbindung prüfen möchten, bevor Sie sie auf Ihre echten Daten richten.
Den persönlichen Token, erzeugt in E-Gestor unter Einstellungen → API (Configurações → API).
In Sellio Administratorrechte (Berechtigung zum Verwalten der Einstellungen), um den Token unter Einstellungen → Integrationen zu speichern.

Schritt 1: den persönlichen Token in E-Gestor erzeugen

Melden Sie sich in E-Gestor an und öffnen Sie das Menü Einstellungen (Configurações).
Wechseln Sie zum Reiter API und erzeugen Sie den persönlichen Token.
Kopieren Sie den Token. Es ist ein langer Text (ein JWT) und die einzige langlebige Zugangsberechtigung: Das CRM erzeugt damit die kurzlebigen Zugriffstoken selbst.

Schritt 2: den Token in das CRM einfügen

Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte "E-Gestor ERP".
Fügen Sie den persönlichen Token ein und speichern Sie. Er wird verschlüsselt gespeichert und nie wieder angezeigt. Lassen Sie das Feld später leer, um den aktuellen Token zu behalten.
Klicken Sie auf "Verbindung testen". Dabei werden Ihre Firmendaten aus E-Gestor gelesen und der Kontoname angezeigt, damit Sie vor dem Einschalten die richtige Firma bestätigen können.
Wählen Sie unter "Was übernommen wird", welche der sechs Gruppen das CRM lesen soll. Kunden, Produkte und Verkäufe sind eingeschaltet, Dienstleistungen, Forderungen und Verbindlichkeiten sind ausgeschaltet.
Klicken Sie auf Aktivieren. Die erste Synchronisierung läuft im nächsten geplanten Zyklus oder sofort über "Jetzt synchronisieren".

Wo alles im CRM landet

Ein Kunde mit CNPJ (14 Stellen) wird zu einer Firma, mit CPF zu einem Kontakt. Wer nur als Lieferant oder Frachtführer erfasst ist, wird zu einem Lieferanten. Wer als Kunde und als Lieferant erfasst ist, kommt als Kunde herein.
Produkte und Dienstleistungen werden zu Produkten. Eine Dienstleistung erhält den Produkttyp "Dienstleistung".
Verkäufe werden zu Kundenaufträgen und werden mit dem Kunden verknüpft, sobald dieser bereits synchronisiert wurde. Status 10 (Angebot) wird zu Entwurf, 50 (Verkauf) wird zu Bestätigt, und ein stornierter Verkauf wird zu Storniert.
Forderungen und Verbindlichkeiten werden zu Notizen in der Chronik des Kunden oder Lieferanten, zu dem sie gehören.

Was nicht übernommen wird und warum

Lagerbestände. Das CRM hat ein eigenes Bestandsmodul mit einem Bewegungsjournal. Eine Zahl aus dem ERP hineinzuschreiben hieße, dass zwei Systeme denselben Bestand für sich beanspruchen.
Rechnungen (NF-e und NFS-e), Einkäufe, Preistabellen, Zahlungsarten und Kontenrahmen. Sie stehen in der E-Gestor API zur Verfügung, haben hier aber kein passendes Objekt, und für einen Konnektor eines zu erfinden würde das Produkt von außen verändern.
Benutzerdefinierte Felder Ihres E-Gestor. Der Konnektor liest die dokumentierten Felder jeder Ressource.
Der CPF einer Person hat kein Standardfeld im Objekt Kontakt und wird deshalb unter dem Namen tax_id geschrieben. Legen Sie im Kontakt ein benutzerdefiniertes Feld mit genau diesem Namen an, wenn Sie ihn im Datensatz sehen möchten. Firma und Lieferant haben dieses Feld bereits.

Aktualisierungen in Echtzeit (Webhook)

E-Gestor kann das CRM bei jeder Änderung eines Datensatzes aufrufen, damit Sie nicht auf die nächste geplante Synchronisierung warten müssen.

Kopieren Sie die Webhook URL, die auf der Karte in Sellio angezeigt wird.
Öffnen Sie in E-Gestor Einstellungen → API → Webhooks (Configurações → API → Webhooks) und tragen Sie diese URL ein, mit den Modulen Kontakte, Produkte und Verkäufe.
Klicken Sie in Sellio erneut auf "Verbindung testen": Dabei wird das Sicherheitstoken abgeholt, das E-Gestor für Ihren Webhook erzeugt hat, und verschlüsselt gespeichert. Von da an wird jeder Aufruf verworfen, der nicht genau dieses Token mitbringt.

💡 Die Webhook Module Benutzer und Finanzen werden bewusst nicht genutzt. Das Finanzereignis trägt nur einen Code und sagt nicht, ob dieser Code zu einer Forderung oder zu einer Verbindlichkeit gehört. Darauf zu reagieren könnte also den falschen Datensatz treffen. Diese Buchungen kommen weiterhin über die geplante Synchronisierung, die weiß, aus welcher Ressource jede Zeile stammt. Ein in E-Gestor gelöschter Datensatz wird im CRM ebenfalls nicht gelöscht: Ihr Team hat ihn hier meist angereichert.

Geschwindigkeit und Grenzen

E-Gestor erlaubt 60 Anfragen pro Minute und liefert 50 Datensätze pro Seite. Der Konnektor bleibt bewusst unter diesem Limit und hört vorher auf, damit der erste Import eines großen Kontos über mehrere Läufe abgeschlossen wird, statt auf halbem Weg zu scheitern. Jeder Lauf macht dort weiter, wo der vorherige aufgehört hat, und weil alles am E-Gestor Code verankert ist, aktualisieren sich überlappende Läufe, statt zu doppeln.

Fehlerbehebung

"E-Gestor hat den persönlichen Token abgelehnt": Der Token wurde im ERP widerrufen oder neu erzeugt. Erzeugen Sie unter Einstellungen → API (Configurações → API) einen neuen und fügen Sie ihn erneut ein.
Nach dem Einschalten erscheint nichts: Prüfen Sie, ob die erwartete Gruppe auf "Aus E-Gestor übernehmen" steht, und nutzen Sie "Jetzt synchronisieren", statt auf den täglichen Zyklus zu warten.
Der Webhook scheint nicht auszulösen: Prüfen Sie, ob die URL in E-Gestor mit den Modulen Kontakte, Produkte und Verkäufe eingetragen wurde und ob Sie danach auf "Verbindung testen" geklickt haben, damit das Sicherheitstoken übereinstimmt.
Zahlen wirken um eine Dezimalstelle verschoben: Das CRM speichert Preise als Dezimalzahlen, genau so, wie E-Gestor sie sendet. Ist ein Preis hier falsch, ist er es dort auch.

Diesen Artikel im System öffnen →