Zum Inhalt

Money S4/S5

Übernehmen Sie Kunden und eingegangene Bestellungen aus dem ERP-System Money S4/S5 in das Daktela-CRM – so wissen Agenten, wer anruft und was bestellt wurde, ohne Money zu öffnen.


Was die Integration kann und wann sie sich lohnt

Die Money-S4/S5-Integration importiert regelmäßig Daten aus Ihrer Money-Installation in eine Daktela-CRM-Datenbank:

  • Firmen (Firmy) werden zu Daktela-CRM-Konten.
  • Personen (Osoby) werden zu Daktela-CRM-Kontakten, jeweils mit ihrer Firma verknĂĽpft.
  • Eingegangene Bestellungen (PĹ™ijatĂ© objednávky) werden zu Daktela-CRM-Datensätzen eines Datensatztyps, den Sie wählen (Order pairing).

Die Daten fließen in eine Richtung, von Money zu Daktela. Money bleibt Ihr führendes System; Daktela hält eine aktuelle Kopie, mit der die Agenten arbeiten.

Typische Anwendungsfälle

  • Kunden erkennen. Ein eingehender Anruf, eine E-Mail oder ein Chat wird dem synchronisierten Kontakt zugeordnet, sodass der Agent sofort Namen und Firma des Kunden sieht.
  • Fragen zu Bestellungen beantworten. Fragt ein Kunde nach einer Bestellung, findet der Agent sie unter den CRM-Datensätzen des Kunden in Daktela, ohne im Backoffice nachzufragen.
  • Kontext fĂĽr Agenten. Agenten sehen die Firmen- und Bestelldaten, die Sie auswählen – Firmen-ID, Adresse, Bestellnummer – im CRM von Daktela.
  • Eine verlässliche Datenquelle. Ihr Team arbeitet weiter in Money; Ă„nderungen erreichen das Contact Center automatisch innerhalb einer halben Stunde.

Tip

Daktela bietet ähnliche Integrationen auch für andere Buchhaltungs- und ERP-Systeme, zum Beispiel Pohoda und Helios Green. Die vollständige Liste finden Sie unter CRM-Synchronisierungs-Integrationen.


Voraussetzungen und Einrichtung

Voraussetzungen

  • In Money: die fĂĽr Ihre Installation eingerichtete Money S5 API, ĂĽber HTTPS aus dem Internet erreichbar, und ein API-Client (Client ID und Client secret), dessen Rolle Firmen, Personen und eingegangene Bestellungen lesen darf. Die erste Einrichtung der API ĂĽbernimmt Ihr Money-Implementierungspartner – ist Daktela Ihre erste API-Integration, bitten Sie ihn darum.
  • In Daktela: ein Administratorkonto mit Zugriff auf Einstellungen → Integrationen und eine CRM-Datenbank, in die die Daten importiert werden.
  • Optional: ein CRM-Datensatztyp in Daktela, wenn Sie eingegangene Bestellungen importieren möchten.

Schritt 1: Money-API-Daten anfordern

Fordern Sie bei Ihrem Money-Implementierungspartner oder -Administrator Folgendes an:

  • die Basis-URL Ihrer Money S5 API – Sie tragen sie als URL-Instanz ein;
  • eine Client ID und ein Client secret fĂĽr Daktela (in Money S5 werden sie in den API-Einstellungen unter API-SchlĂĽssel erzeugt).

Stellen Sie sicher, dass die API aus dem Internet erreichbar ist, nicht nur aus Ihrem internen Netz – Daktela verbindet sich aus der Cloud.

Schritt 2: Money in Daktela verbinden

  1. Gehen Sie in Daktela zu Einstellungen → Integrationen und klicken Sie unter MoneyS4/S5 auf Konfigurieren.
  2. FĂĽllen Sie das Verbindungsformular aus:

    Feld Was Sie eingeben
    CRM-Datenbank Die Daktela-CRM-Datenbank, in die die Money-Daten importiert werden.
    CRM-Datensatztyp Optional. Der Datensatztyp fĂĽr eingegangene Bestellungen, die ĂĽber Order pairing importiert werden.
    URL-Instanz Die Basis-URL Ihrer Money S5 API, beginnend mit https:// (oder http://).
    Kunden-ID Die Client ID aus Schritt 1.
    Kundengeheimnis Das Client secret aus Schritt 1.
  3. Klicken Sie auf Autorisieren. Daktela prĂĽft, ob Money fĂĽr diese Zugangsdaten ein Zugriffstoken ausstellt.

Schritt 3: Felder zuordnen

  1. Eine Liste Ihrer Daktela-CRM-Felder wird geöffnet. Wählen Sie unter Contact pairing für jedes Kontaktfeld in Daktela das Money-Feld aus den Personen und für jedes Kontofeld das Feld aus den Firmen. Unter Order pairing tun Sie dasselbe für die Felder der CRM-Datensätze (aus den eingegangenen Bestellungen).

    Money-S4/S5-Feldzuordnung mit den Abschnitten Kontaktzuordnung und Bestellungen zuordnen

  2. Klicken Sie auf Aktivieren.

Die erste Synchronisation läuft innerhalb von 30 Minuten.


Technische Details

Thema Verhalten
Richtung Nur in eine Richtung: Money → Daktela. Nach Money wird nichts zurückgeschrieben.
Verbindung Daktela ĂĽbergibt die Zugangsdaten an den Daktela-Integrationsdienst, der in seinem Auftrag die Money S5 API aufruft. Die API muss aus dem Internet erreichbar sein; der Dienst wartet bis zu 10 Sekunden auf den Verbindungsaufbau und bis zu 60 Sekunden auf jede Antwort.
Authentifizierung OAuth 2.0 Client Credentials: Der Dienst holt ein Zugriffstoken von <URL-Instanz>/connect/token (Scope S5Api), speichert es und fordert ein neues an, wenn Money es als abgelaufen ablehnt.
API Der GraphQL-Endpunkt <URL-Instanz>/graphql. Die verfügbaren Abfragen und Felder werden aus <URL-Instanz>/graphql/schema gelesen. Ihre Money-Version muss seitenweise Abfragen für Personen (Person), Firmen (Company) und eingegangene Bestellungen (ReceivedOrder) anbieten; andernfalls schlägt das Laden der Feldzuordnung oder die Synchronisation mit einer entsprechenden Fehlermeldung fehl.
Zeitplan Alle 30 Minuten.
Inkrementelle Synchronisation Jeder Lauf fragt nur Datensätze ab, deren Änderungsdatum (Modify_Date) nach dem vorherigen Lauf liegt; bei Personen wird zusätzlich das Erstellungsdatum (Create_Date) geprüft. Die Zeit wird in UTC gesendet (ab Version 33.8.0). Der erste Lauf importiert alle Datensätze.
Seitengröße Datensätze werden in Seiten zu je 100 abgerufen, sortiert nach Money-ID.
Reihenfolge der Entitäten Zuerst Firmen (Konten), dann Personen (Kontakte), zuletzt eingegangene Bestellungen – damit ein Kontakt immer mit seiner Firma verknüpft werden kann.
Nicht unterstützt Andere Money-Belege (Rechnungen, ausgehende Bestellungen …). In Money gelöschte Datensätze werden in Daktela nicht gelöscht.
Mehrere Konfigurationen Sie können mehrere Money-Installationen verbinden oder in mehrere CRM-Datenbanken importieren. Jede Konfiguration hat eine eigene Kachel, benannt nach ihrer URL-Instanz.

Wie Datensätze zugeordnet werden

  • Jeder importierte Kontakt, jedes Konto und jeder Datensatz erhält in Daktela den eindeutigen Namen <Konfigurations-ID>_<Money-ID>. Daktela merkt sich diese Zuordnung, sodass spätere Ă„nderungen in Money denselben Daktela-Datensatz aktualisieren, statt ein Duplikat anzulegen.
  • Die Money-ID wird immer automatisch dem eindeutigen Namen zugeordnet und Nazev dem Titel von Kontakten und Konten; eingegangene Bestellungen erhalten immer ihre Belegnummer (CisloDokladu) als Titel. Alle anderen Felder folgen Ihrer Zuordnung aus Schritt 3.
  • Kontakt → Firma: Eine Person wird mit der Firma in ihrem Feld Parent_ID verknĂĽpft.
  • Eingegangene Bestellungen werden immer mit der Daktela-Phase OPEN importiert. Ordnen Sie den Kunden der Bestellung dem Feld Kontakt des Datensatzes zu (und seine Firma dem Feld Konto), um sie zu verknĂĽpfen. Bleibt eine Bestellung ohne Kontakt und hat sie eine Telefonnummer, sucht Daktela einen vorhandenen Kontakt mit derselben Telefonnummer oder E-Mail und verknĂĽpft die Bestellung mit ihm. Hat die Bestellung keine Telefonnummer oder passt kein Kontakt, legt Daktela aus den Bestelldaten einen neuen Kontakt an.
  • Feldliste: Die Zuordnungsliste bietet alle Felder des Money-Objekts an, einschlieĂźlich der Felder verknĂĽpfter Objekte bis zu drei Ebenen tief; Objekt- und Feldname werden mit Unterstrich verbunden (<Objekt>_<Feld>).
  • Wenn Sie einen importierten Datensatz in Daktela löschen, legt der nächste Lauf ihn nicht neu an, sondern meldet ihn als Fehler.

Testlauf und vollständige Synchronisation

  • Testlauf (ab Version 30.0.0): Sobald die Integration aktiv ist, öffnen Sie ihre Konfiguration und klicken auf Testlauf. Daktela importiert sofort die ersten fĂĽnf Datensätze jeder zugeordneten Entität, sodass Sie die Zuordnung prĂĽfen können, ohne auf den geplanten Lauf zu warten.
  • Vollständige Synchronisation: Wenn Sie eine aktive Konfiguration bearbeiten, sorgt die Option Vollständige Synchronisation dafĂĽr, dass der nächste Lauf alle Datensätze neu importiert, nicht nur die Ă„nderungen – nĂĽtzlich, nachdem Sie die Feldzuordnung geändert haben.

Synchronisationsfehler

Schlägt ein Lauf fehl – Money ist nicht erreichbar, lehnt die Zugangsdaten ab oder einige Datensätze lassen sich nicht speichern –, zeigt die Money-Kachel unter Einstellungen → Integrationen eine Warnung. Öffnen Sie sie, um eine Fehlerdatei (CSV) herunterzuladen, die jeden fehlgeschlagenen Datensatz mit Titel, eindeutigem Namen, Entitätstyp und Grund auflistet. Wenn die Verbindung fehlschlägt, erhalten die Administratoren außerdem eine E-Mail-Benachrichtigung – einmal, bis ein späterer Lauf wieder eine Verbindung herstellt.

Warnbanner bei einem Synchronisationsfehler der Integration

Häufige Meldungen des Integrationsdienstes:

Meldung Was Sie prĂĽfen sollten
Money ERP connection failed / timed out Die API ist unter URL-Instanz nicht aus dem Internet erreichbar oder antwortet zu langsam.
Money ERP authentication failed Client ID oder Client secret ist falsch, oder der API-Client wurde entfernt.
Money ERP returned an API error; check the query, mapped fields and API user permissions Die Rolle des API-Clients darf eines der zugeordneten Objekte oder Felder nicht lesen.
Money ERP mapped field is absent from the GraphQL schema Ein zugeordnetes Feld gibt es in Ihrer Money-Version nicht mehr – ordnen Sie ein anderes Feld zu.
Money ERP GraphQL schema does not expose a paginated … query Ihre Money-Version bietet die Abfrage nicht an, die Daktela braucht – fragen Sie Ihren Money-Implementierungspartner nach einem Update.