Quelltext der Seite Kostenpflichtige Module/Internet-Shop/brShop24/Personen übertragen

{{Vorlage:Kostenpflichtige Module}}
Die Übertragung von Kunden kann einzeln über den Personenstamm erfolgen.
=Vorbereitung=
==Voraussetzungen==
===Kunden mit Logins und Adressen===
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 [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|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 [[#Kunden_mit_Logins_und_Adressen|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!}}
<br />
<br />
{{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 [[OBS/Stammdaten/Personen/Weitere_Funktionen/Q_-_Webshop-Einstellungen#Reiter 3: Ansprechpartner|Ansprechpartner]] und [[OBS/Stammdaten/Personen/Weitere_Funktionen/Q_-_Webshop-Einstellungen#Reiter 4: Kostenstellen|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===
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|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 [[OBS/Stammdaten/Personen#Ansprechpartner_zuordnen|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 [[#Reiter 3: Ansprechpartner|Ansprechpartner]] und [[#Reiter 4: Kostenstellen|Kostenstellen]].
==Maske==
===Tasten und Schaltflächen===
*{{Key|F4 Ansp}} Öffnet die [[OBS/Stammdaten/Personen#F6_Kontakt|Kontakte (Ansprechpartner)]] der Person.
*{{Key|F5 Kost}} Öffnet die [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|Kostenstellenvewaltung]] der Person. {{Hinweis|Setzt die Bürofa-Verwaltung für Kostenstellen voraus.}}
*{{Key|F6 Import}} Import die aktuellen Daten aus dem Shop neu. Dies dient nur zur Anzeige des aktuellen Status in Reiter 1.
*{{Key|F7 Export}} [[Kostenpflichtige_Module/Internet-Shop/brShop24/Personen_übertragen#Welche_Daten_werden_von_OBS_.C3.BCbertragen.3F|Personen übertragen]]
*{{Key|F8 Preise}} [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen|Preise übertragen]]{{Hinweis|Setzt voraus, dass Kunde als "im Shop vorhanden" erkannt wird!}}
*{{Key|F9 Vorlage}} [[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoppinglisten übertragen]]{{Hinweis|Setzt voraus, dass Kunde als "im Shop vorhanden" erkannt wird!}}

===Reiter 1: Status===
[[Datei:Webshop_ps_br24_1v2.jpg|330px|thumb|right|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 [[Kostenpflichtige_Module/Internet-Shop/brShop24#Men.C3.BC|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 [[Kostenpflichtige_Module/Internet-Shop/brShop24#Men.C3.BC|Shopmenü]] mit Punkt W manuell starten.}}

===Reiter 2: Einstellungen===
[[Datei:Webshop_ps_br24_2v3.jpg|330px|thumb|right|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 [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|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.
<br />
{{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 [[Kostenpflichtige_Module/Internet-Shop/brShop24#Men.C3.BC|Shopmenü]] mit Punkt W manuell starten.}}

===Reiter 3: Ansprechpartner===
[[Datei:Webshop_ps_br24_3v3.jpg|330px|thumb|right|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.<br />''Fehlt'' = Keine Benutzername eingetragen<br />''Dpl'' = Benutzername ist eingetragen, aber doppelt für Schnittstelle vorhanden<br />''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====
[[Datei:Webshop_ps_br24_3einfg.jpg|330px|thumb|right|Eingabemaske Hinzufügen eines Ansprechpartners]]
{| class="wikitable"
|-
! Feld!! Erklärung
|-
| Tasten/Schaltflächen|| Erklärung
|-
| {{Key|Ret Ändern}}|| Öffnet die Eingabemaske des [[OBS/Stammdaten/Personen#F6_Kontakt|Ansprechpartners]] zum Datensatz.
|-
| {{Key|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.
|-
| {{Key|Entf entf}}|| Entfernt die Zuordnung zur Shop-Schnittstelle.
|-
| {{Key|M Mig Ben}}|| Öffnet die Liste der importierten Benutzer. In dieser Liste können Sie bereits im Shop vorhandene Benutzer den entsprechenden OBS-Ansprechpartnern zuordnen.
|-
| {{Key|P Pwd gen}}|| Generiert Passworte und Benutzernamen für alle Ansprechpartner des Kunden. Es werden dabei nur Werte generiert, die noch nicht gesetzt sind.
|-
| {{Key|S Sorti.}}|| Öffnet die Liste für die Definition des [[Kostenpflichtige_Module/Internet-Shop/brShop24/Definition_Sortiment|Sortiments]].
|}

===Reiter 4: Kostenstellen===
[[Datei:Webshop_ps_br24_4v3.jpg|330px|thumb|right|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====
{| class="wikitable"
|-
! Feld!! Erklärung
|-
| Tasten/Schaltflächen|| Erklärung
|-
| {{Key|Ret Ändern}}|| Öffnet die Eingabemaske der [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|Kostenstellenvewaltung]] zum Datensatz
|-
| {{Key|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.
|-
| {{Key|Entf entf}}|| Entfernt die Zuordnung zur Shop-Schnittstelle.
|}

=Daten übertragen=
Die Daten übertragen Sie aus den [[OBS/Stammdaten/Personen/Weitere_Funktionen/Q_-_Webshop-Einstellungen#brShop24|Webshop-Einstellungen]] einer Person mit {{Key|F7 Export}}.<br />
<br />
{{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 [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|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 [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|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 für den Export benötigten 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.
===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&nbsp;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.<br />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 [[OBS/Stammdaten/Personen/Weitere_Funktionen/Q_-_Webshop-Einstellungen|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 [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|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.