Händlerbund
Haendlerbund im Backend
Die Haendlerbund-Anbindung verwaltet Rechtstexte, Dokument-Synchronisation und das Kaefersiegel fuer Bewertungsuebertragungen.
Bereiche der Seite
Die Backendseite hat zwei interne Reiter. Rechtstexte ruft Dokumente vom Haendlerbund ab und ordnet diese Shopseiten zu. Kaefersiegel speichert Zugangsdaten und legt fest, bei welchem Bestellstatus Bewertungsdaten uebertragen werden.
- Rechtstexte: AccessToken, Multishop-Auswahl, Dokumenttabelle, Zielseiten und manuelle Synchronisation.
- Kaefersiegel: API-Zugangsdaten, ShopId und Ausloese-Status fuer Bestelluebermittlung.
- Voraussetzungen: Das Backend prueft das Haendlerbund-Recht und das aktive Haendlerbund-Modul. Fehlt eine Voraussetzung, wird die Konfiguration nicht angezeigt.
Rechtstexte einrichten
Im Reiter Rechtstexte wird zuerst der Multishop gewaehlt. Danach laedt das Backend den Haendlerbund-Datensatz dieser Shop-Instanz oder erstellt ihn beim Speichern neu.
| Backend-Feld | Zweck | Wirkung |
|---|---|---|
hb_shop_id | AccessToken des Haendlerbund-Kontos. | Wird als AccessToken an die Haendlerbund-API uebergeben. Ist der Token ungueltig, fuehrt der Abruf zu einem Verarbeitungsfehler. |
multishop_id | Shop-Zuordnung aus der Shop-Auswahl. | Entscheidet, welcher Haendlerbund-Datensatz, welche statische Impressumsseite und welche Bestellbestaetigungs-Mailvorlage betroffen sind. |
auto | Datenfeld fuer automatische Uebernahme. | In der aktuellen sichtbaren Backendseite nicht als Formularfeld vorhanden. |
auto_intervall | Datenfeld fuer ein automatisches Intervall. | In der aktuellen sichtbaren Backendseite nicht als Formularfeld vorhanden. |
Nach dem Speichern ruft das Backend die Dokumentliste ab. Neue Dokumente werden als Zeilen angelegt. Bei vorhandenen Dokumenten wird die MD5-Pruefsumme verglichen; bei Abweichung wird new_version gesetzt.
Dokumenttabelle
Die Dokumentliste ist eine BsTable ohne setNoSetup. Spalten koennen deshalb ueber das Tabellen-Setup angepasst werden.
| Spalte | Backend-Felder | Bedeutung |
|---|---|---|
| Aktiv | id, status | Checkbox je Dokument. Ein Klick schaltet den Status per Ajax direkt um. Nur aktive Dokumente werden bei der Synchronisation uebernommen. |
| Bezeichnung | type | Dokumentname, zum Beispiel Impressum, AGBs, Widerrufsbelehrung oder weitere Haendlerbund-Dokumenttypen. |
| Zielseite | site, type | Auswahl der Zielseite. Bei Impressum ist nur Impressum waehlbar. Andere Dokumente koennen einer dynamischen Inhaltsseite zugeordnet werden. |
| Letzte Synchronisation | last_time, synchro_status | Zeigt den letzten Abrufzeitpunkt und ein Statussymbol. Gruen steht fuer erfolgreiche Synchronisation, rot fuer nicht erfolgreiche Synchronisation. |
| Optionen | id, new_version | Enthaelt die Aktion Synchronisieren. Bei neuer Version erscheint zusaetzlich ein gelbes Warnsymbol. |
Zielseiten und Dokumentstatus
Die Zielseiten-Auswahl wird als Formular abgesendet und speichert die Zuordnung direkt am HaendlerbundDocument-Datensatz.
- Impressum: Schreibt in den statischen Impressumsbereich des ausgewaehlten Shops.
- AGBs und Widerruf: Schreiben HTML in die gewaehlte dynamische Inhaltsseite und erzeugen zusaetzlich PDF-Anhaenge fuer die Bestellbestaetigungs-Mail.
- Weitere Dokumenttypen: Schreiben HTML in die gewaehlte dynamische Inhaltsseite.
- Keine Zielseite: Das Dokument bleibt in der Tabelle sichtbar, wird aber nicht in eine Inhaltsseite geschrieben.
Synchronisieren
Die Zeilenaktion Synchronisieren ruft das einzelne Dokument anhand von hb_type ab. Das Backend prueft zuerst den Aktiv-Status der Zeile.
- Ist das Dokument deaktiviert, wird kein Import ausgefuehrt.
- Ist der Haendlerbund-Abruf nicht erfolgreich, wird zurueck auf die Seite mit Fehlerhinweis geleitet.
- Bei Erfolg werden Inhalte in die Zielseite geschrieben,
last_timeaktualisiert,md5gespeichert,new_versionzurueckgesetzt undsynchro_statusgesetzt. - Bei AGBs und Widerrufsbelehrung erstellt das Backend PDF-Dateien und verknuepft diese mit der Bestellbestaetigungs-Mailvorlage des Shops.
Kaefersiegel einrichten
Der Reiter Kaefersiegel legt fehlende Konfigurationswerte automatisch an und zeigt danach ein Formular mit Zugangsdaten und Statusauswahl.
| Backend-Feld | Zweck | Wirkung |
|---|---|---|
api_user | API-Benutzer fuer das Kaefersiegel. | Wird vor der Authentifizierung per MD5 gehasht und an den Dienst uebergeben. |
api_passwort | API-Passwort fuer das Kaefersiegel. | Wird ebenfalls per MD5 gehasht und zusammen mit api_user verwendet. |
shop_id | ShopId fuer das Kaefersiegel. | Wird als Konfigurationswert gespeichert, im aktuellen Uebertragungscode aber nicht direkt in den Requestdaten aufgebaut. |
orderstatus | Bestellstatus fuer die Uebermittlung. | Nur wenn eine Bestellung diesen Status erreicht, startet die Kaefersiegel-Uebertragung. |
Uebermittlung an das Kaefersiegel
Beim Statuswechsel einer Bestellung ruft das Backend die Kaefersiegel-Uebertragung auf. Wenn der konfigurierte orderstatus nicht dem aktuellen Bestellstatus entspricht, passiert nichts.
- Zuerst wird eine Authentifizierung mit gehashtem API-Benutzer und gehashtem API-Passwort gestartet.
- Danach werden Bestelldaten uebertragen: E-Mail, Kundenname, Bestellnummer, Kaufdatum, Waehrung, Bestellsumme und Sprache.
- Zusaetzlich werden Produktdaten uebergeben: Artikel-ID, Name, Menge, Einzelpreis und ein leeres Bildfeld.
- Nach der Uebertragung wird die Authentifizierung wieder geloescht.
Pruefschritte nach Einrichtung
- Richtigen Multishop auswaehlen und AccessToken speichern.
- Dokumentliste auf neue oder geaenderte Versionen pruefen.
- Aktiv-Status und Zielseite je Dokument kontrollieren.
- Ein Dokument testweise synchronisieren und Zielseite sowie Mailanhaenge pruefen.
- Kaefersiegel-Zugangsdaten speichern und den ausloesenden Bestellstatus mit einer Testbestellung pruefen.