Version vom 19. April 2023, 13:56 Uhr

Um Personen in den brShop24 übertragen zu können, müssen in den Personendaten bestimmte Einstellungen erfolgen. Um wenigstens einen vollen Satz Daten im Shop anzulegen, benötigen Sie im OBS-Personestamm folgende Daten:

Person mit Ansprechpartner(n)
mindestens einen Ansprechpartner der Person hat:
- E-Mail-Adresse hinterlegt (Eingabemaske Ansprechpartner, Reiter Stammdaten)
- Benutzername und Passwort (Eingabemaske Ansprechpartner, Reiter Internet)
- Eigenschaft 9013 SHOP Kundenlogin hinterlegt (Liste Ansprechpartner, F6)
- Shop-Zuordnung zur brShop24-Schnittstelle (Liste Ansprechpartner, F10 + S)
Eintrag für die Schnittstelle in den weitere Funktionen Punkt Q1 - Webshop-Einstellungen mit einer Kundengruppe

ACHTUNG: Die Schnittstelle legt Benutzer nur aus Ansprechpartnern an! Die aufgelisteten Punkte müssen für jeden Ansprechpartner erfüllt sein, der als Person mit eigenem Konto im Shop angelegt werden soll.

Kostenstellen

Zugehörige Person ist für den Shop-Export vorbereitet (siehe vorangehenden Punkt 1.1.1 Kunden mit Logins und Adressen)

Als "zugehörige Person" gilt die im Feld Personen-Nr. referenzierte Person. Sollte dieses Feld leer sein, gilt die Personennummer der die Kostenstellen hinterlegt ist (Anzeige Person rechts oben in der Eingabemaske Kostenstelle).

ACHTUNG: Ist eine Personennummer als Kostenstelle bei einer anderen Person als sich selbst referenziert, so muss der Export über die entsprechende Person erfolgen.

Zugehörige Person wird mit einer eigene Kundengruppe übertragen. Das heißt die Kundengruppe liegt nicht innerhalb der Systemstruktur Standard Kundengruppen.
Kostenstelle muss der Schnittstelle zugeordnet sein.

Die Datensätze benötigen im brShop24 meistens einen eindeutigen Bezeichner. Dieser kann in der Kostenstelle im Feld Eindeutiger Bezeichner eingegeben werden. Ist beim Export kein eindeutiger Bezeichner angegeben, so wird automatisch ein Bezeichner generiert und in der Kostenstelle eingetragen.

HINWEIS: Soweit bekannt, verwendet Büroring in der Auftragsdatei die Bezeichnung als Referenz. Sie sollten daher sicherstellen, dass die Bezeichnung der Kostenstelle eindeutig ist, da beim Auftragsimport sonst die falsche Kostenstelle gezogen werden kann.

HINWEIS: Es können auch Kostenstellen ohne eingetragener Kundennummer in den Shop übertragen werden. Für diese Kostenstellen wird dann die Kundennummer der Person selbst verwendet.

ACHTUNG: Aktuell steht noch keine Funktionalität für die Angabe von Budgets in der API zur Verfügung. Budgets werden daher nicht übertragen!

HINWEIS: Um die Vorraussetzungen für einen Datenexport besser nachvollziehen zu können, haben Sie die Möglichkeit die aktuell im OBS gepflegten Daten für Ansprechpartner und Kostenstellen über die Webshop-Einstellungen einzusehen. In den Reitern Ansprechpartner und Kostenstellen finden Sie die entsprechenden Informationen in tabellarischer Darstellung.

Optional

HINWEIS: Die unter Optional aufgeführten Punkte sind keine Vorraussetzungen, um grundsätzlich einen Kunden in den Shop zu exportieren. Es wird jedoch empfohlen diese Punkte ebenfalls zu berücksichtigen, da dies bei der Datenpflege aus OBS helfen kann (z. B. Anreden zu Personen im Shop korrekt zu hinterlegen).

reelle Personen

Shop-Anreden wurden über die Konfiguration den OBS-Anreden zugeordnet

Kostenstelle einem Benutzer zuordnen

Damit Kostenstellen von einem Benutzer im Shop verwendet werden können, müssen diese im Shop den Benutzern hinterlegt werden. Dies können Sie im OBS umsetzen, indem Sie über die Kostenstellen die jeweiligen Ansprechpartner zuordnen.

Personenstamm Webshop-Einstellungen

Die Webshop-Einstellungen sind für den Shop-Export entscheidend, möchten Sie eine Personen übertragen. In den Webshop-Einstellungen können Sie zum Einen bestimmte Vorgaben für den Export des Kunden (z. B. Kundentyp) machen, erhalten andererseits aber auch Informationen zum aktullen Status des Kunden im Shop oder zugeordneter Daten, die ebenfalls in den Shop übertragen werden können oder gar erforderlich sind. Um die unter Vorraussetzungen genannten Daten für die Übertragung prüfen zu können, gibt es in dieser Maske die beiden Reiter Ansprechpartner und Kostenstellen.

Maske

Tasten und Schaltflächen

F4 Ansp Öffnet die Kontakte (Ansprechpartner) der Person.
F5 Kost Öffnet die Kostenstellenvewaltung der Person.
HINWEIS: Setzt die Bürofa-Verwaltung für Kostenstellen voraus.
F6 Import Import die aktuellen Daten aus dem Shop neu. Dies dient nur zur Anzeige des aktuellen Status in Reiter 1.
F7 Export Personen übertragen
F8 Preise Preise übertragen
HINWEIS: Setzt voraus, dass Kunde als "im Shop vorhanden" erkannt wird!
F9 Vorlage Shoppinglisten übertragen
HINWEIS: Setzt voraus, dass Kunde als "im Shop vorhanden" erkannt wird!

Reiter 1: Status

Dieser Reiter zeigt Ihnen den aktuellen Status des Kunden im Shop mit folgenden Angaben:

Kunde vorhanden

Zeigt mit Ja/Nein an, ob der Kunde im Shop existiert.

Typ

Zeigt Ihnen die Bezeichnung des Kundentypen an. Ist der Wert identisch mit dem im OBS unter Reiter 2 eingestellten Typ, so wird der Text in grün dargestellt. Bei Abweichung erscheint die Bezeichnung in rot. Konnte der Status des Kunden im Shop nicht ermittelt werden bzw. wurden die Daten noch nicht exportiert, so steht hier nur ein Fragezeichen.

HINWEIS: Damit die Anzeige funktioniert, müssen die Definitionen zuvor importiert worden sein. Dies können Sie über das Shopmenü mit Punkt W manuell starten.

Klassifizierung

Zeigt Ihnen die Bezeichnung der Kundenklassifizierung an. Ist der Wert identisch mit der im OBS unter Reiter 2 eingestellten Klassifizierung, so wird der Text in grün dargestellt. Bei Abweichung erscheint die Bezeichnung in rot. Konnte der Status des Kunden im Shop nicht ermittelt werden bzw. wurden die Daten noch nicht exportiert, so steht hier nur ein Fragezeichen.

HINWEIS: Damit die Anzeige funktioniert, müssen die Definitionen zuvor importiert worden sein. Dies können Sie über das Shopmenü mit Punkt W manuell starten.

Reiter 2: Einstellungen

In diesem Reiter können Sie Einstelleungen für den Export vornehmen. Aktuell stehen Ihnen folgende Einstellungsmöglichkeiten zur Verfügung:

Shop-Kundengruppe

Kundengruppe, in der die Benutzer angelegt werden sollen. Die Kundegruppe muss zuvor in der Schnittstelle angelegt worden sein. Die Verwaltung für die Kundengruppen lässt sich mit F9 aus der Suchliste aufrufen.

Kundentyp

Ermöglicht die Angabe, ob ein Kunden z. B. B2B oder B2C ist. Überschreibt die Vorgabe aus der Gruppe im Benutzer.

Klassifizierung

Beinhaltet die Angabe, ob ein Kunden z. B. Neu- oder Stammkunde ist. Überschreibt die Vorgabe aus der Gruppe im Benutzer.

HINWEIS: Damit die Auswahlfelder Kundentyp und Klassifizierung verwendet werden können, müssen die Definitionen zuvor importiert worden sein. Dies können Sie über das Shopmenü mit Punkt W manuell starten.

Reiter 3: Ansprechpartner

Dieser Reiter zeigt Ihnen die Ansprechpartner des Kunden mit den wichtensten Informationen zur Datenübertragung und den Mindestanforderungen an die Datenpflege im OBS, um einen Ansprechpartner im Shop als reele Person mit einem Benutzer anzulegen. In der Tabelle finden Sie folgende Angaben:

Name

Name des Ansprechpartners

Vorname

Vorname des Ansprechpartner

E-Mail

Die E-Mail-Adresse des Ansprechpartner

Benutzer

Zeigt den im Ansprechpartner hinterlegten Benutzername

B-St

Steht für Benutzer-Status und zeigt Ihnen an, ob ein Benutzername im Ansprechpartner hinterlegt wurde und dieser für die Schnittstelle eindeutig ist.
Fehlt = Keine Benutzername eingetragen
Dpl = Benutzername ist eingetragen, aber doppelt für Schnittstelle vorhanden
Ok = Benutzername vorhanden und eindeutig

HINWEIS: Die Eindeutigkeit kann nur auf Basis der Daten im OBS ermittelt werden. Unabhängig davon kann der Benutzername im Shop bereits existieren, sollte ein Benutzer nicht aus OBS angelegt worden sein.

P-St

Steht für Passwort-Status und zeigt Ihnen an, ob ein Passwort im Ansprechpartner hinterlegt wurde.

E-St

Steht für Eigenschaft-status und zeigt Ihnen an, ob dem Ansprechpartner die Eigenschaft 9013 (SHOP Kundenlogin) hinterlegt wurde.

Z-St

Steht für Zuordnung-Status und zeigt Ihnen an, ob die Zuordnung des Ansprechpartner zur Shop-Schnittstelle gesetzt wurde.

Reiter 3: Tasten und Schaltflächen

Eingabemaske Hinzufügen eines Ansprechpartners

Ret Ändern Öffnet die Eingabemaske des Ansprechpartners zum Datensatz.
Einfg Hzf Fügt den Ansprechpartner der Schnittstelle hinzu. Dabei wird die Zuordnung zur Shop-Schnittstelle gesetzt, die Eigensschaft 9013 hinterlegt und eine Eingabemaske für die drei Angaben E-Mail, Benutzername und Passwort aufgerufen. In der Eingabemaske können Sie die Angabe zum Ansprechpartner anpassen.
Entf entf Entfernt die Zuordnung zur Shop-Schnittstelle.
P Pwd gen Generiert Passworte und Benutzernamen für alle Ansprechpartner des Kunden. Es werden dabei nur Werte generiert, die noch nicht gesetzt sind.

Reiter 4: Kostenstellen

HINWEIS: Dieser Reiter setzt die Bürofa-Verwaltung für Kostenstellen voraus. Ist diese nicht aktiv, wird Ihnen dieser Reiter nicht angezeigt.

Dieser Reiter zeigt Ihnen die Kostenstellen des Kunden mit den relevanten Angaben für den Export. Aktuell werden Ihnen dafür folgenden Informationen in der Tabelle angezeigt:

Nummer

Die Nummer der Kostenstelle

Person

Die in der Kostenstelle hinterlegte/verknüfte Person

Bezeichnung

Die Bezeichnung der Kostenstelle

eind. Bezeich.

Der eindeutige Bezeichner einer Kostenstelle. Wenn eine Kostenstelle auch als Kostenstelle im Shop angelegt werden soll, muss der eindeutige Bezeichner gefüllt sein.

Zuord.

Zeigt mit Ja und Nein, ob die Zuordnung zur Shop-Schnittstelle gesetzt wurde.

Shop-Ansp.

Zeigt die Anzahl der gültigen Shop-Ansprechpartner an. "Gültig" bedeutet, dass die Ansprechpartner soweit gepflegt sind, dass aus Ihnen beim Export eine Person und ein Benutzer angelegt werden können.

Reiter 4: Tasten und Schaltflächen

Ret Ändern Öffnet die Eingabemaske der Kostenstellenvewaltung zum Datensatz.
Einfg Hzf Fügt die Kostenstelle der Schnittstelle hinzu. Dabei wird die Zuordnung zur Shop-Schnittstelle gesetzt und ein eindeutiger Bezeichner abgefragt, sollte noch keiner eingetragen sein.
Entf entf Entfernt die Zuordnung zur Shop-Schnittstelle.

Daten übertragen

Die Daten übertragen Sie aus den Webshop-Einstellungen einer Person mit F7.

ACHTUNG: Daten wie Adressen können in der Kundengruppe "verteilt" werden oder nur mit einer Person/benutzer verknüpft sein. Dies ist abhängig von der Art der Kundengruppe. Wird ein Kunde in eine Sammelgruppe übertragen, so wird die Adresse nur der Person/Benutzer zugeordnet, aber nicht der Kundengruppe. Standardgruppen des Shops werden immer als Sammelgruppe für verschiedene Kunden/Personen angesehen. Für eigene Kundengruppen muss das Häkchen Sammelgruppe in den Einstellungen der Kundengruppe gesetzt werden. In der Liste sind die Kundengruppen einfach an der Spalte Info mit den Werten System und Sammel zu erkennen.

HINWEIS: Die Schnittselle ist langsamer als die VShop4-Schnittstelle. Im Test dauerte die Anlage/Aktualisierung eines Kunden mit mit drei verknüpften Kunden, fünf Adressen, zwei Kostenstellen und insgesamt sieben Ansprechpartnern, jeweils aufgeteilt in Benutzerkonto und Person, rund 105 Sekunden für die insgesamt 25 Datensätze. Rechnen Sie mit etwa 3,5 bis 7 Sekunden pro Datensatz.

Datenstruktur/Zuordnung im Shop

Aufbau eines Kunden im brShop24

Die Struktur des Shops unterscheidet sich etwas von OBS. Im Shop werden die Daten folgendermaßen aufgeteilt:

Customer

Enthält die Kunden(-gruppen). Hier ist die Kundennummer und einige Standard-Definitionen wie die Sprache oder der Kundentyp (z. B. B2B) gespeichert.

Address

Das Addressbuch des Shops enthält alle Addressen zum Kunden.

HINWEIS: Die Angabe von Straße und Hausnummer erfolgt hier getrennt!

Person

Enthält eine reelle Person mit Anrede, Titel, Namen und zusätzlichen Daten wie Abteilung, Geburtstag oder Geschlecht.

ACHTUNG: Anrede ist ein Pflichtfeld bei der Anlage. Da nicht alle Ansprechpartner mit Anreen gepflegt sind, gibt es für die API einen Schalter, welcher die Übermittlung ohne Angabe ermöglicht. Sollten Sie bei der Übertragung einer Person den Fehler Field "createPerson" argument "data" requires type SalutationEnum, found none bekommen oder ab OBS-Version 004275 den Protokoll-Eintrag Fehler: Person <Vorname + Name> ohne gültige Angabe für Anrede so ist sehr wahrscheinlich der API-Schalter nicht aktiviert. Wenden Sie sich in diesem Fall bitte an den Support vom Büroring. Alternativ tragen Sie bei allen Ansprechpartnern eine für den Shop gültige Anrede ein.

User

Enthält den eigentlichen Benutzer, über den sich ein Kunde im Shop anmeldet, mit Benutzernamen, E-Mail und Passwort.

costCenter

Hier werden die Kostenstellen gespeichert.

Welche Daten werden von OBS übertragen?

OBS versucht die Struktur so gut wie möglich zu befüllen. Dabei werden die Stammdaten aus OBS wie folgt verwendet:

OBS-Personenstamm
- Adressen

HINWEIS: Die Angabe "Straße" ist im Shop getrennt nach Straßenname und Nummer zu speichern. OBS trennt dies beim Export automatisch.

HINWEIS: Adressen haben im brShop24 einen Vornamen, Nachnamen und zwei Felder für eine "Firmenbezeichnung". Bei der Übertragung aus OBS werden diese Felder unterschiedlich gefüllt, abhängig vom Feld Vorname wird eine Adresse als privat oder geschäftlich eingestuft. Ist Vorname gefüllt werden die Daten aus Vorname und Name in die entsprechenden Felder des Shops übertragen. Ohne Vorname werden die Daten aus Name und Zusatz 1 in die "Firmenbezeichnung" geschrieben. Für Adressen ohne Trennung von Vor- und Nachname (z. B. Kostenstellen) werden die Daten aus Name 1 und Name 2 immer in die Firmendaten übertragen.
Um einen Datenverlust zu vermeiden, werden Adressen mit einer gefüllten dritten Adresszeile (Zusatz 2 bzw. Zusatz bei Versandadressen/Kostenstellen) standardmäßig nicht exportiert. Dies kann jedoch in der Schnittstelle aktiviert werden, indem Sie Export.Person.Adr.OhneZeile3 auf N stellen. Dies deaktiviert die Prüfung auf Zeile 3 und die Adressen werden auch mit gepflegter dritter Adresszeile übertragen.

die Adresse von Reiter 1 "Adresse" wird in Address übertragen, als "Hauptadresse" übertragen.
Der hinterlegte Rechnungsempfänger (Adresse zu Kundennummer aus Feld Re-Empfänger) wird als "Rechnungsadresse" im Shop angelegt.
Der in Reiter 2 hinterlegte Warenempfänger wird als "Lieferandresse" im Shop angelegt.
Die Adressen aus Kostenstellen werden als "Lieferadresse" im Shop angelegt.

Anprechpartner
- E-Mail-Adresse und Benutzer mit Passwort (Reiter "Internet") werden in User übertragen
- Anrede, Name und Vorname wird nach Person exportiert
verknüpfte Personen (OBS Kostenstellen)
- Einträge mit Personennummern werden übertragen, sofern die verknüpfte Person über einen entsprechenden Eintrag in den Webshop-Einstellungen verfügt.
- Es wird eine Kostenstelle angelegt, sofern der zugehörige Kunde im Shop angelegt werden konnte und der eindeutige Bezeichner in der Kostenstelle gepflegt wurde (manuell oder automatisch). Den in der Kostenstelle zugewiesenen Ansprechpartner wird die Kostenstelle danach im jeweiligen Benutzer hinterlegt, Ist kein Ansprechpartner hinterlegt, so wird die Kostenstelle allen Benutzern des zugehörigen Kunden zugewiesen.

@@ Zeile 129: / Zeile 129: @@
 ===Person===
 Enthält eine reelle Person mit Anrede, Titel, Namen und zusätzlichen Daten wie Abteilung, Geburtstag oder Geschlecht.
+{{Achtung|Anrede ist ein Pflichtfeld bei der Anlage. Da nicht alle Ansprechpartner mit Anreen gepflegt sind, gibt es für die API einen Schalter, welcher die Übermittlung ohne Angabe ermöglicht. Sollten Sie bei der Übertragung einer Person den Fehler ''Field "createPerson" argument "data" requires type SalutationEnum, found none'' bekommen oder ab OBS-Version 004275 den Protokoll-Eintrag ''Fehler: Person <Vorname + Name> ohne gültige Angabe für Anrede'' so ist sehr wahrscheinlich der API-Schalter nicht aktiviert. Wenden Sie sich in diesem Fall bitte an den Support vom Büroring. Alternativ tragen Sie bei allen Ansprechpartnern eine für den [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|Shop gültige Anrede]] ein.}}
 ===User===
 Enthält den eigentlichen Benutzer, über den sich ein Kunde im Shop anmeldet, mit Benutzernamen, E-Mail und Passwort.

Kostenpflichtige Module/Internet-Shop/brShop24/Personen übertragen: Unterschied zwischen den Versionen

Version vom 19. April 2023, 13:56 Uhr

Inhaltsverzeichnis

Vorbereitung