pixi Connect

Die Installation des pixi Connect Addons 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.

Vorbereitungen

Achtung!
Für die Verwendung des pixi-Addons ist eine GREYHOUND-Version 4.2.7 build 1642 oder höher notwendig. Eine gegebenenfalls installierte frühere Erweiterung sollte über den Client unter Funktionen > Erweiterungen entfernt werden, damit es beim Anwender nicht zu Verwechslungen kommt.

Damit pixi Connect auf die pixi Daten zugreifen darf, muss GREYHOUND Zugriff auf die pixi API haben, die entsprechenden Zugangsdaten sind beim pixi Kundenbetreuer zu erfragen.

pixi Connect dem GREYHOUND Vertrag hinzubuchen

Das Produkt pixi 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 mit Weiter bestätigen

  • Änderungen überprüfen und übernehmen

Wichtig: Kunden im Eigenbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren (-> Anleitung siehe hier). Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.

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

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

Verbindungseinstellungen

Neben einer optionalen Bezeichnung müssen hier derAPI Endpunkt, der API Benutzer und das entsprechende Kennwort eingetragen werden.
In dem Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in pixi 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 pixi-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.

Ebenso kann man im Feld “Absender ignorieren” Absender-Mail-Adressen angeben, bei denen nicht nach Auftragsdaten in pixi gesucht werden soll. Pro Zeile ist in dem dafür vorgesehen Feld eine Mailadresse erlaubt, man kann auch hier mit dem Sternchen als Platzhalter arbeiten.

Das Feld Artikelnummer bietet im Dropdown-Menü einige Optionen zur Auswahl, bei denen die passende zu wählen ist. Zu Artikeln können in pixi nämlich unterschiedliche Felder für Artikelnnummern verwendet werden – hier lässt sich auswählen, welche dieser Felder das pixi Connect Addon in GREYHOUND anzeigen soll.

In der nächsten Zeile kann man festlegen, ob der Lagerbestand aus pixi mit abgerufen und im Connect Addon angezeigt werden soll – will man dies nicht, ist bei “Lagerbestand” der Haken bei “nicht abrufen” zu setzen. Tipp: Braucht man den Lagerbestand in GREYHOUND nicht unbedingt, sollte der Lagerbestand nicht abgerufen werden (also ein Haken gesetzt werden), da diese Funktion keine unerheblichen Auswirkungen auf die Performance des Addons hat.

Setzt man den Haken bei “Lieferantenbestellungen abrufen“, werden auch die Lieferantenbestellungen für die Artikel in den Auftragsposititionen angezeigt. Tipp: Braucht man die Lieferantenbestellungen in GREYHOUND nicht unbedingt, sollten diese nicht abgerufen werden (also keinen Haken setzen), da diese Funktion keine unerheblichen Auswirkungen auf die Performance des Addons hat.

Globale Einstellungen

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen pixi-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.
  • Feld für Kundennummer
    Sofern bereits ein benutzerdefiniertes Feld in GREYHOUND angelegt wurde, kann dieses Feld hier ausgewählt werden. Alternativ kann dieses hier angelegt werden. Sofern keine automatische Kontaktsynchronisierung in GREYHOUND eingerichtet wurde, sind hier keine Angaben notwendig.

Erweiterte Einstellungen

  • Timeout
    Bei besonders großen pixi-Systemen kann es notwendig sein, den Timeout-Wert anzuheben, damit Verbindungsdaten angezeigt werden.
  • 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 Antworten 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.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.Sex.Number]Rechnungsanschrift: Geschlecht (“0” = unbekannt, “1” = männlich, “2” = weiblich)
[$BillingAddress.Sex.Name]Rechnungsanschrift: Geschlecht (“Unbekannt”, “Männlich”, “Weiblich”)
[$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.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.Sex.Number]Lieferanschrift: Geschlecht (“0” = unbekannt, “1” = männlich, “2” = weiblich)
[$ShippingAddress.Sex.Name]Lieferanschrift: Geschlecht (“Unbekannt”, “Männlich”, “Weiblich”)
[$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.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)
[$ShippingAddress.Email]Lieferanschrift: E-Mail Adresse
[$ShippingAddress.Phone]Lieferanschrift: Telefonnummer
[$ShippingAddress.Fax]Lieferanschrift: Faxnummer


[$Payment.Method]Zahlungsart
[$Payment.Date]Zahlungsdatum (Tag.Monat.Jahr)
[$Payment.DateInfo.D]Zahlungsdatum (Tag, z.B. “01”)
[$Payment.DateInfo.M]Zahlungsdatum (Monat, z.B. “02”)
[$Payment.DateInfo.Y]Zahlungsdatum (Jahr, z.B. “2013”)
[$Payment.DateInfo.Day.DE]Zahlungsdatum (Tag auf deutsch, z.B. “Montag”)
[$Payment.DateInfo.Day.EN]Zahlungsdatum (Tag auf englisch, z.B. “Monday”)
[$Payment.DateInfo.Day.ES]Zahlungsdatum (Tag auf spanisch, z.B. “Lunes”)
[$Payment.DateInfo.Day.FR]Zahlungsdatum (Tag auf französisch, z.B. “Lundi”)
[$Payment.DateInfo.Month.DE]Zahlungsdatum (Monat auf deutsch, z.B. “Januar”)
[$Payment.DateInfo.Month.EN]Zahlungsdatum (Monat auf englisch, z.B. “January”)
[$Payment.DateInfo.Month.ES]Zahlungsdatum (Monat auf spanisch, z.B. “Enero”)
[$Payment.DateInfo.Month.FR]Zahlungsdatum (Monat auf französisch, z.B. “Janvier”)
[$Payment.DateInfo.Timestamp]Zahlungsdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)


[$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.Date]Lieferdatum (Tag.Monat.Jahr)
[$Shipping.DateInfo.D]Lieferdatum (Tag, z.B. “01”)
[$Shipping.DateInfo.M]Lieferdatum (Monat, z.B. “02”)
[$Shipping.DateInfo.Y]Lieferdatum (Jahr, z.B. “2013”)
[$Shipping.DateInfo.Day.DE]Lieferdatum (Tag auf deutsch, z.B. “Montag”)
[$Shipping.DateInfo.Day.EN]Lieferdatum (Tag auf englisch, z.B. “Monday”)
[$Shipping.DateInfo.Day.ES]Lieferdatum (Tag auf spanisch, z.B. “Lunes”)
[$Shipping.DateInfo.Day.FR]Lieferdatum (Tag auf französisch, z.B. “Lundi”)
[$Shipping.DateInfo.Month.DE]Lieferdatum (Monat auf deutsch, z.B. “Januar”)
[$Shipping.DateInfo.Month.EN]Lieferdatum (Monat auf englisch, z.B. “January”)
[$Shipping.DateInfo.Month.ES]Lieferdatum (Monat auf spanisch, z.B. “Enero”)
[$Shipping.DateInfo.Month.FR]Lieferdatum (Monat auf französisch, z.B. “Janvier”)
[$Shipping.DateInfo.Timestamp]Lieferdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$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”)