SoftENGINE ERP Connect

Die Installation des Addons SoftENGINE ERP Connect ist mit wenigen Handgriffen erledigt. Das Addon kann bequem dem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Achtung! 
Für die Verwendung des SoftENGINE ERP Connect Addons ist eine GREYHOUND-Version 5.0.78 build 2847 oder höher notwendig. Außerdem sind die SoftENGINE Webservices Grundvoraussetzung für die Nutzung des Addons.

SoftENGINE ERP Connect” dem GREYHOUND Vertrag hinzubuchen

Das Produkt SoftENGINE ERP Connect im GREYHOUND Control Center (GCC) dem bestehenden Vertrag hinzubuchen:

  • Nach dem Login unter Verträge den Vertrag auswählen und bearbeiten:

  • Unter den Vertragsinhalten auf Produkte ändern klicken:

  • Das gewünschte Addon hinzubuchen:


  • Änderungen überprüfen und übernehmen:

  • Nun muss der GREYHOUND Server einmal angewiesen werden, das neu gebuchte Addon abzurufen und zu installieren. Dies geschieht automatisch beim Neustart des Servers, kann aber auch manuell im laufenden Betrieb erfolgen (-> Anleitung siehe hier). Nach einem Neustart des GREYHOUND Clients ist das Addon dann anschließend auch dort verfügbar.

Wichtig: Kunden im Eigenbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren (-> Anleitung siehe hier).

SoftENGINE ERP Connect in GREYHOUND einrichten

Standardmäßig ist ein neues Addon immer für alle in GREYHOUND angelegten Benutzergruppen sichtbar. Wir empfehlen nach der Installation die Sichtbarkeit des SoftENGINE Einstellungsdialogs und ggf. des Hilfedialogs zu konfigurieren. Informationen über Benutzergruppen gibt es an dieser Stelle im Handbuch.

Nachdem das Addon dem Vertrag hinzugebucht wurde, erscheint im GREYHOUND Client ein neuer Menüeintrag Erweiterungen > SoftENGINE ERP Connect – Einstellungen. Darin werden einmalig die individuellen Verbindungsdaten zu SoftENGINE sowie einige globale Einstellungen konfiguriert.

Verbindungseinstellungen

  • Neben einer optionalen Bezeichnung sind hier die Daten des SoftEINGINE-Servers einzutragen. Sprich: Die Server-URL, unter der die SoftENGINE ERP Webservices erreichbar sind sowie der Port, über den der Server von außen erreichbar ist.
  • Im Feld Anwendungs ID ist die Anwendungs-ID aus den SoftENGINE ERP Webservices einzutragen. Die Zugangsnummer zu den Webservices sowie auch die Anwendungs-Revision sind normalerweise 1.
  • Im Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in SoftENGINE nach Auftragsdaten suchen soll. Sollen alle Mails durchsucht werden, ist der Platzhalter “*” einzugeben. Das Feld darf nicht leer bleiben!

Es ist sinnvoll, bei den Empfängern nur die E-Mail-Adressen einzutragen, an die SoftENGINE-Kunden auch Nachrichten schreiben. Beispielsweise “kundenservice@meinefirma.de”. So vermeidet man, dass das Addon auch bei eingehenden Lieferanten-E-Mails an einkauf@meinefirma.de unnötig nach Kundendaten sucht.

Bevor man weiter macht, ist die Verbindung einmal über den Button “Verbindung testen” zu prüfen. Sobald alles passt, kann man sich dem Bereich Workflow-Skripte widmen:

Dieser Bereich ist relevant für alle, die in SoftENGINE ERP ein oder mehrere Workflow-Skript(e) hinterlegt haben. Nutzt man ein Workflow-Skript, das beispielsweise Kundendaten anzeigen kann, ist entsprechend im Feld “Kunden” die zugehörige Workflow-ID in das Feld einzutragen. Die Kundennummern werden dann in GREYHOUND mit einem Link hinterlegt, über den sich der entsprechende Workflow in SoftENGINE ERP aufrufen und so z. B. der entsprechende Kunde anzeigen lässt. Gleiches Prinzip gilt auch für:

  • Belegnummer / Auftragsnummern (Feld: Beleg). Die Belegnummern werden dann mit einem Links hinterlegt, über den sich der entsprechende Workflow in SoftENGINE ERP aufrufen und so z. B. der entsprechende Beleg anzeigen lässt.
  • CRM-Masken mit (Feld: CRM). Das Addon zeigt dann neben der Telefonnummer des Kunden einen Link an, mit dem der entsprechende Workflow in SoftENGINE ERP aufgerufen werden kann.
  • Über das Feld Sonstiges kann die Workflow-ID eines frei wählbaren weiteren SoftENGINE ERP Workflow-Skripts hinterlegt werden. Aktuell wird die ID vom Addon noch nicht genutzt.

Mehrere Mandanten / Shops anbinden

Selbstverständlich lassen sich auch mehrere Mandaten / Shops mit dem Addon anbinden. Dazu legt man einfach im Reiter „Verbindung“ über das grüne Plus-Icon unten links eine neue, weitere Verbindung an und trägt die Daten des zusätzlichen Shops entsprechend ein:

Globale Einstellungen

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen SoftENGINE-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.
  • Vorgansnummern automatisch zuordnen
    Wenn diese Option aktiviert ist, werden die Vorgangsnummern von Nachrichten, zu denen ein SoftENGINE-Auftrag gefunden wird, automatisch dem Auftrag zugeordnet. Ist die Option deaktiviert, so kann diese Zuordnung nur manuell erfolgen.
  • Schnellzugriff für Textbausteine
    Hier kann der Basistextbaustein ausgewählt werden, welcher direkt über das Addon erreichbar sein soll. Damit entfällt das Wechseln des Karteireiters zwischen Addon und Textbausteinen.
  • CC an Auftrags-E-Mail
    Wenn diese Option aktiviert ist, wird beim Antworten immer eine Kopie (CC) der Nachricht an die E-Mail-Adresse des Kunden geschickt, die im SoftENGINE-Auftrag steht.

Erweiterte Einstellungen

  • Administration
    Normalerweise ist der Einstellungsdialog des Addons nur für Administratoren sichtbar und bearbeitbar. Dies hängt von der Berechtigung “Erweiterungen bearbeiten” im Profil ab. Wenn die Option “Einstellung für alle Benutzer bearbeitbar machen” im SoftENGINE-Addon aktiviert wird, dann können alle Benutzer, also auch solche, die dieses Profilrecht nicht besitzen, die Einstellungen des Addons sehen und bearbeiten. Die Option sollte unter normalen Umständen nicht aktiviert werden, weil sie die normale Berechtigungsstruktur aushebelt.
  • Timeout
    Bei besonders großen SoftENGINE-Systemen kann es notwendig sein, den Timeout-Wert anzuheben, damit der Datenabgleich nicht abgebrochen wird.
  • Debug-Modus
    Zu besseren Fehleranalyse kann der Debugmodus aktiviert werden. Damit werden dann detailliertere Informationen bei Problemen angezeigt. Zusätzlich wird damit eine Option aktiv mit der Informationen direkt an den GREYHOUND Kundenservice gesendet werden können.

Variablen für Textbausteine

Beim Beantworten oder Verfassen einer Nachricht über die Buttons in der Seitenleiste des Addons stellt das Addon einige Variablen bereit, die im Text der Nachricht oder in eingefügten Textbausteinen ersetzt werden. Der Inhalt der Variablen hängt von den Auftrags- und Kundendaten ab, die das Addon ermittelt hat. So können z. B. Variablen wie die Lieferanschrift leer sein, wenn in den Auftragsdaten keine separate Lieferanschrift übermittelt wurde. Wie üblich kann die Vorschaufunktion beim Verfassen der Nachricht genutzt werden, um zu überprüfen, durch welche Daten die Variablen ersetzt werden.

Es folgt eine Auflistung der Variablen und ihres Inhalts:

[$Order.OrderNumber]Bestellnummer
[$Order.CustomerNumber]Kundennummer
[$Order.Date]Bestelldatum (Tag.Monat.Jahr)
[$Order.DateInfo.D]Bestelldatum (Tag, z.B. “01”)
[$Order.DateInfo.M]Bestelldatum (Monat, z.B. “02”)
[$Order.DateInfo.Y]Bestelldatum (Jahr, z.B. “2013”)
[$Order.DateInfo.Day.DE]Bestelldatum (Tag auf deutsch, z.B. “Montag”)
[$Order.DateInfo.Day.EN]Bestelldatum (Tag auf englisch, z.B. “Montag”)
[$Order.DateInfo.Day.ES]Bestelldatum (Tag auf spanisch, z.B. “Lunes”)
[$Order.DateInfo.Day.FR]Bestelldatum (Tag auf französisch, z.B. “Lundi”)
[$Order.DateInfo.Month.DE]Bestelldatum (Monat auf deutsch, z.B. “Januar”)
[$Order.DateInfo.Month.EN]Bestelldatum (Monat auf englisch, z.B. “January”)
[$Order.DateInfo.Month.ES]Bestelldatum (Monat auf spanisch, z.B. “Enero”)
[$Order.DateInfo.Month.FR]Bestelldatum (Monat auf französisch, z.B. “Janvier”)
[$Order.DateInfo.Timestamp]Bestelldatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Order.Status]Status des Auftrags
[$Order.TotalAmount]Gesamtbetrag des Auftrags inkl. Währung
[$Order.TotalAmountInfo.Value]Gesamtbetrag des Auftrags (Zahl mit Dezimalpunkt)
[$Order.TotalAmountInfo.Currency]Gesamtbetrag des Auftrags (Währung in drei Buchstaben)
[$Order.OpenAmount]Offener Betrag des Auftrags inkl. Währung
[$Order.OpenAmountInfo.Value]Offener Betrag des Auftrags (Zahl mit Dezimalpunkt)
[$Order.OpenAmountInfo.Currency]Offener Betrag des Auftrags (Währung in drei Buchstaben)
[$BillingAddress.Company]Rechnungsadresse: Firma
[$BillingAddress.Salutation]Rechnungsadresse: Anrede
[$BillingAddress.Sex.Number]Rechnungsadresse: Geschlecht
[$BillingAddress.Name]Rechnungsadresse: Name
[$BillingAddress.Firstname]Rechnungsadresse: Vorname
[$BillingAddress.Lastname]Rechnungsadresse: Nachname
[$BillingAddress.Letter.Identifier]Rechnungsadresse: Adresse
[$BillingAddress.Letter.Street]Rechnungsadresse: Straße
[$BillingAddress.Letter.AdditionalInfo]Rechnungsadresse: Zusatzinfo
[$BillingAddress.Letter.ZipCode]Rechnungsadresse: Postleitzahl
[$BillingAddress.Letter.City]Rechnungsadresse: Stadt
[$BillingAddress.Letter.Country]Rechnungsadresse: Land
[$BillingAddress.Letter.CountryInfo.ISO2]Rechnungsadresse: Land (ISO3166 Länderkürzel: zwei Buchstaben)
[$BillingAddress.Letter.CountryInfo.ISO3]Rechnungsadresse: Land (ISO3166 Länderkürzel: drei Buchstaben)
[$BillingAddress.Letter.CountryInfo.DE]Rechnungsadresse: Land (deutsche Schreibweise, z.B. “Deutschland”)
[$BillingAddress.Letter.CountryInfo.DE_UC]Rechnungsadresse: Land (deutsche Schreibweise, Blockbuchstaben, z.B. “DEUTSCHLAND”)
[$BillingAddress.Letter.CountryInfo.EN]Rechnungsadresse: Land (englische Schreibweise, z.B. “Germany”)
[$BillingAddress.Letter.CountryInfo.EN_UC]Rechnungsadresse: Land (englische Schreibweise, Blockbuchstaben, z.B. “GERMANY”)
[$BillingAddress.Letter.CountryInfo.ES]Rechnungsadresse: Land (spanische Schreibweise, z.B. “Alemania”)
[$BillingAddress.Letter.CountryInfo.ES_UC]Rechnungsadresse: Land (spanische Schreibweise, Blockbuchstaben, z.B. “ALEMANIA”)
[$BillingAddress.Letter.CountryInfo.FR]Rechnungsadresse: Land (französische Schreibweise, z.B. “Allemagne”)
[$BillingAddress.Letter.CountryInfo.FR_UC]Rechnungsadresse: Land (französische Schreibweise, Blockbuchstaben, z.B. “ALLEMAGNE”)
[$BillingAddress.Letter.Country.ISO2]Rechnungsadresse: Ländercode
[$BillingAddress.Email]Rechnungsadresse: E-Mail Adresse
[$BillingAddress.Phone]Rechnungsadresse: Telefonnummer
[$BillingAddress.Fax]Rechnungsadresse: Faxnummer
[$ShippingAddress.Company]Lieferadresse: Firma
[$ShippingAddress.Salutation]Lieferadresse: Anrede
[$ShippingAddress.Sex.Number]Lieferadresse: Geschlecht
[$ShippingAddress.Name]Lieferadresse: Name
[$ShippingAddress.Firstname]Lieferadresse: Vorname
[$ShippingAddress.Lastname]Lieferadresse: Nachname
[$ShippingAddress.Letter.Identifier]Lieferadresse: Adresse
[$ShippingAddress.Letter.Street]Lieferadresse: Straße
[$ShippingAddress.Letter.AdditionalInfo]Lieferadresse: Zusatzinfo
[$ShippingAddress.Letter.ZipCode]Lieferadresse: Postleitzahl
[$ShippingAddress.Letter.City]Lieferadresse: Stadt
[$ShippingAddress.Letter.Country]Lieferadresse: Land
[$ShippingAddress.Letter.CountryInfo.ISO2]Lieferadresse: Land (ISO3166 Länderkürzel: zwei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.ISO3]Lieferadresse: Land (ISO3166 Länderkürzel: drei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.DE]Lieferadresse: Land (deutsche Schreibweise, z.B. “Deutschland”)
[$ShippingAddress.Letter.CountryInfo.DE_UC]Lieferadresse: Land (deutsche Schreibweise, Blockbuchstaben, z.B. “DEUTSCHLAND”)
[$ShippingAddress.Letter.CountryInfo.EN]Lieferadresse: Land (englische Schreibweise, z.B. “Germany”)
[$ShippingAddress.Letter.CountryInfo.EN_UC]Lieferadresse: Land (englische Schreibweise, Blockbuchstaben, z.B. “GERMANY”)
[$ShippingAddress.Letter.CountryInfo.ES]Lieferadresse: Land (spanische Schreibweise, z.B. “Alemania”)
[$ShippingAddress.Letter.CountryInfo.ES_UC]Lieferadresse: Land (spanische Schreibweise, Blockbuchstaben, z.B. “ALEMANIA”)
[$ShippingAddress.Letter.CountryInfo.FR]Lieferadresse: Land (französische Schreibweise, z.B. “Allemagne”)
[$ShippingAddress.Letter.CountryInfo.FR_UC]Lieferadresse: Land (französische Schreibweise, Blockbuchstaben, z.B. “ALLEMAGNE”)
[$ShippingAddress.Letter.Country.ISO2]Lieferadresse: Ländercode
[$ShippingAddress.Email]Lieferadresse: E-Mail Adresse
[$ShippingAddress.Phone]Lieferadresse: Telefonnummer
[$ShippingAddress.Fax]Lieferadresse: Faxnummer
[$Payment.Method]Zahlungsart
[$Payment.TransactionID]Transaktions-ID der Zahlung
[$Payment.TermOfPayment]Zahlungsziel
[$Shipping.Provider]Versanddienstleister
[$Shipping.Costs]Versandkosten inkl. Währung
[$Shipping.CostsInfo.Value]Versandkosten (Zahl mit Dezimalpunkt)
[$Shipping.CostsInfo.Currency]Versandkosten (Währung in drei Buchstaben)
[$Shipping.Date]Versanddatum (Tag.Monat.Jahr)
[$Shipping.DateInfo.D]Versanddatum (Tag, z.B. “01”)
[$Shipping.DateInfo.M]Versanddatum (Monat, z.B. “02”)
[$Shipping.DateInfo.Y]Versanddatum (Jahr, z.B. “2013”)
[$Shipping.DateInfo.Day.DE]Versanddatum (Tag auf deutsch, z.B. “Montag”)
[$Shipping.DateInfo.Day.EN]Versanddatum (Tag auf englisch, z.B. “Montag”)
[$Shipping.DateInfo.Day.ES]Versanddatum (Tag auf spanisch, z.B. “Lunes”)
[$Shipping.DateInfo.Day.FR]Versanddatum (Tag auf französisch, z.B. “Lundi”)
[$Shipping.DateInfo.Month.DE]Versanddatum (Monat auf deutsch, z.B. “Januar”)
[$Shipping.DateInfo.Month.EN]Versanddatum (Monat auf englisch, z.B. “January”)
[$Shipping.DateInfo.Month.ES]Versanddatum (Monat auf spanisch, z.B. “Enero”)
[$Shipping.DateInfo.Month.FR]Versanddatum (Monat auf französisch, z.B. “Janvier”)
[$Shipping.DateInfo.Timestamp]Versanddatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Shipping.Tracking.Code]Sendungsnummer
[$Shipping.Tracking.Codes]Alle Sendungsnummern
[$Shipping.Tracking.URL]Sendungsverfolgungs-URL
[$Shipping.Tracking.URLs]Alle Sendungsverfolgungs-URLs
[$Shipping.Tracking.Count]Anzahl der Sendungsnummern
[$Shipping.Tracking.Code1]Erste Sendungsnummer
[$Shipping.Tracking.URL1]Erste Sendungsverfolgungs-URL
[$Shipping.Tracking.Code2]Zweite Sendungsnummer
[$Shipping.Tracking.URL2]Zweite Sendungsverfolgungs-URL
[$Shipping.Tracking.Code3]Dritte Sendungsnummer
[$Shipping.Tracking.URL3]Dritte Sendungsverfolgungs-URL