VARIO ERP

Die Installation des Addons ist mit wenigen Handgriffen erledigt. Das Addon kann bequem dem bestehenden Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon nach der Zubuchung im Vertrag vollautomatisch. Kunden im Eigenbetrieb müssen die neue Seriennummer im GREYHOUND Admin aktualisieren.

Notwendige Vorbereitungen in VARIO

Damit in GREYHOUND Daten aus der ERP von VARIO 8 angezeigt werden können, sind einige vorbereitende Handgriffe nötig. Und zwar:

  1. Der API Dienst von VARIO muss eingerichtet werden.
  2. Der Port für eingehende Nachrichten muss in der Firewall freigegeben werden.
  3. In VARIO ERP muss ein Benutzer für den Zugriff durch GREYHOUND angelegt werden.

Im Folgenden ist beschrieben, was man genau tun muss:

1. API-Dienst von VARIO konfigurieren

Um GREYHOUND an VARIO ERP anbinden zu können, muss man den API-Dienst von VARIO einmalig einrichten. Dazu gibt es ein Tool, das nennt sich VarioDienstConfig.exe und liegt im VARIO-Installationsverzeichnis unter VARIO/Software/VARIO8:

  • Aktive Module: Hier muss die Option “REST Server (VARIO API)” ausgewählt werden.
  • REST-Server: Hier muss eingestellt werden, wie die API von außen erreichbar sein soll, also ob mit SSL/TLS und auf welchem Port.

Das sieht dann also z.B. so aus:

  • Sobald die Daten eingetragen sind, ist neben der URL auf den Button “Registrieren” zu klicken.
  • Anschließend sind die Einstellungen mit einem Klick auf den großen Button unten “Konfiguration speichern” zu sichern.
  • Nun sollte man oben noch auf “Installieren” klicken. Das sorgt dafür, der der API-Dienst als Windows-Dienst installiert wird und beim Systemstart mit gestartet wird. Um nun direkt mit dem API-Dienst weiter arbeiten zu können, muss man einmal oben manuell auf “Starten” klicken, um den Dienst erstmalig direkt zu starten.

2. Port-Freigabe in der Firewall

Nachdem der API-Dienst erfolgreich eingerichtet ist, muss man in der Windows-Firewall den Port freigeben, den man dort eingetragen hat (in unserem Beispiel Port 443) – und zwar für eingehend, also für eingehende Nachrichten.

3. Benutzer in der ERP von VARIO anlegen

Nun ist in VARIO ein dedizierter Benutzer für GREYHOUND einzurichten. Dazu geht man in der ERP in die Benutzerverwaltung und wählt “Neu” aus.

  • Wichtig: Bei dem anzulegenden Benutzer muss unbedingt die Option “Darf API nutzen” angehakt werden.
  • Der Benutzername (das oberste Feld “Benutzer” – im Beispiel “NEU”) und das Kennwort sind dann die Zugangsdaten, die später im GREYHOUND Addon eingetragen werden (siehe unten).

VARIO ERP Connect dem Vertrag hinzufügen

Das Produkt VARIO ERP Connect im GREYHOUND Control Center (GCC) in den bestehenden Vertrag hinzubuchen:

  1. Nach dem Login unter Verträge den Vertrag auswählen und bearbeiten

  2. Unter den Vertragsinhalten auf Produkte ändern klicken

  3. Das gewünschte Addon hinzubuchen durch Anhaken

  4. Änderungen mit Weiter bestätigen

  5. Änderungen überprüfen und übernehmen

Kunden im Eigenbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren und ggf. die Seriennummer erneuern (Anleitung hier). Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.

VARIO 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 VARIO Einstellungsdialogs als auch des Addons selber zu konfigurieren. Informationen über Benutzergruppen gibt es an dieser Stelle im GREYHOUND Handbuch.

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

Verbindungseinstellungen

  • Neben einer optionalen Bezeichnung müssen hier die Zugangsdaten zur ERP von VARIO eingetragen werden.
  • Danach muss die API URL eingetragen werden. Das ist die, unter der der VARIO Server erreichbar ist. Entsprechend mit https oder http und dem Port, der in der VarioDienstConfig.exe (siehe oben) festgelegt wurde.
  • Als Benutzer ist der dedizierte für GREYHOUND in VARIO angelegte Benutzer sowie das dazugehörige Kennwort einzutragen.
  • Standardmäßig wird das SSL-Zertifikat, das bei VARIO hinterlegt ist, durch das GREYHOUND Connect Addon validiert, also auf Gültigkeit geprüft. Bei Bedarf kann die Validierung des SSL Zertifikats abgeschaltet werden, indem der Haken entfernt wird.
  • In dem Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in der ERP 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 VARIO-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.

Globale Einstellungen

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen VARIO-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.
  • Vorgangsnummern automatisch zuordnen
    Wenn diese Funktion aktiviert ist, werden die Vorgangsnummern von Nachrichten, zu denen ein VARIO-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.

Erweiterte Einstellungen

  • Timeout
    Bei besonders großen ERP-Systemen kann es notwendig sein den Timeout-Wert anzuheben, damit Verbindungsdaten angezeigt werden.
  • Debug-Modus
    Zu besseren Fehleranalyse kann der Debug-Modus 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.

Sind alle Daten korrekt hinterlegt, kann man das Addon VARIO ERP Connect nutzen.

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:

Variable
Beschreibung
[$Order.OrderNumber]Bestellnummer
[$Order.InvoiceNumber]Rechnungsnummer
[$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. “Monday”)
[$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.Platform]Verkaufsplattform
[$Order.PlatformUsername]Benutzername/ID auf der Verkaufsplattform
[$Order.TotalAmount]Gesamtbetrag des Auftrags inkl. Währung
[$Order.TotalAmountInfo.Value]Gesamtbetrag des Auftrags (Zahl mit Dezimalpunkt)
[$Order.TotalAmountInfo.Currency]Währung des Gesamtbetrags (drei Buchstaben)


[$BillingAddress.Company]Rechnungsanschrift: Firma
[$BillingAddress.Title]Rechnungsanschrift: Titel
[$BillingAddress.Name]Rechnungsanschrift: Vorname und Nachname
[$BillingAddress.Firstname]Rechnungsanschrift: Vorname
[$BillingAddress.Lastname]Rechnungsanschrift: Nachname
[$BillingAddress.Letter.Identifier]Rechnungsanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$BillingAddress.Letter.Street]Rechnungsanschrift: Straße und Hausnummer
[$BillingAddress.Letter.AdditionalInfo]Rechnungsanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$BillingAddress.Letter.ZipCode]Rechnungsanschrift: Postleitzahl
[$BillingAddress.Letter.City]Rechnungsanschrift: Stadt
[$BillingAddress.Letter.Country]Rechnungsanschrift: Land
[$BillingAddress.Letter.CountryInfo.ISO2]Rechnungsanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$BillingAddress.Letter.CountryInfo.ISO3]Rechnungsanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$BillingAddress.Letter.CountryInfo.DE]Rechnungsanschrift: Land (deutsche Schreibweise)
[$BillingAddress.Letter.CountryInfo.DE_UC]Rechnungsanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.EN]Rechnungsanschrift: Land (englische Schreibweise)
[$BillingAddress.Letter.CountryInfo.EN_UC]Rechnungsanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.ES]Rechnungsanschrift: Land (spanische Schreibweise)
[$BillingAddress.Letter.CountryInfo.ES_UC]Rechnungsanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.FR]Rechnungsanschrift: Land (französische Schreibweise)
[$BillingAddress.Letter.CountryInfo.FR_UC]Rechnungsanschrift: Land (französische Schreibweise, Blockbuchstaben)
[$BillingAddress.Email]Rechnungsanschrift: E-Mail Adresse
[$BillingAddress.Phone]Rechnungsanschrift: Telefonnummer
[$BillingAddress.Fax]Rechnungsanschrift: Faxnummer


[$ShippingAddress.Company]Lieferanschrift: Firma
[$ShippingAddress.Title]Lieferanschrift: Titel
[$ShippingAddress.Name]Lieferanschrift: Vorname und Nachname
[$ShippingAddress.Firstname]Lieferanschrift: Vorname
[$ShippingAddress.Lastname]Lieferanschrift: Nachname
[$ShippingAddress.Letter.Identifier]Lieferanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$ShippingAddress.Letter.Street]Lieferanschrift: Straße und Hausnummer
[$ShippingAddress.Letter.AdditionalInfo]Lieferanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$ShippingAddress.Letter.ZipCode]Lieferanschrift: Postleitzahl
[$ShippingAddress.Letter.City]Lieferanschrift: Stadt
[$ShippingAddress.Letter.Country]Lieferanschrift: Land
[$ShippingAddress.Letter.CountryInfo.ISO2]Lieferanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.ISO3]Lieferanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.DE]Lieferanschrift: Land (deutsche Schreibweise)
[$ShippingAddress.Letter.CountryInfo.DE_UC]Lieferanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.EN]Lieferanschrift: Land (englische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.EN_UC]Lieferanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.ES]Lieferanschrift: Land (spanische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.ES_UC]Lieferanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.FR]Lieferanschrift: Land (französische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.FR_UC]Lieferanschrift: Land (französische Schreibweise, Blockbuchstaben)


[$Payment.Method]Zahlungsart


[$Shipping.Provider]Versanddienstleister
[$Shipping.Costs]Versandkosten inkl. Währung
[$Shipping.CostsInfo.Value]Versandkosten (Zahl mit Dezimalpunkt)
[$Shipping.CostsInfo.Currency]Währung der Versandkosten (drei Buchstaben)
[$Shipping.Tracking.Code]Sendungsnummer / Tracking-Code
[$Shipping.Tracking.URL]Sendungsverfolgungs-Link / Tracking-URL


[$Addon.Name]Name des Addons
[$Addon.Version]Version des Addons (z.B. “1.2.3 build 456”)
[$Addon.VersionInfo.Number]Versionsnummer des Addons (z.B. “1.2.3”)
[$Addon.VersionInfo.Build]Build-Nummer des Addons (z.B. “456”)