AGB HOSTING-SERVICE EINBINDUNG (Version 3)

Transkript

1 AGB HOSTING-SERVICE EINBINDUNG (Version 3) Mit dieser Schnittstellen-Beschreibung zum AGB HOSTING-SERVICE der janolaw AG können die auf der janolaw Website erzeugten juristischen Dokumente in jedem beliebigen Shopsystem verwendet werden. Front End Wir empfehlen für jedes Dokument, AGB, Widerrufsbelehrung, Datenschutzerklärung, Impressum und auch für das Muster-Widerrufsformular eine Webseite mit einem deutlich beschrifteten Link anzulegen, damit die vom Gesetzgeber vorgegebene leichte Auffindbarkeit gegeben ist. Back End / Auftragsbestätigung Die Dokumente, AGB, Widerrufsbelehrung, Muster-Widerrufsformular und ab Mai 2018 die Datenschutzerklärung, müssen per Auftragsbestätigung oder spätestens mit dem Warenversand dem Kunden zugeschickt werden. Datei-Namen Wir bieten folgende Dateien zum Einbinden in das Shopsystem an: AGB: Impressum Widerrufsbelehrung: Datenschutzerklärung: Muster-Widerrufsformular: terms legaldetails revocation datasecurity model-withdrawal-form NEU!!! Datei-Typen _include.html Bei den Include Dateien handelt es sich um HTML-Snippets, die nur den eigentlichen Body der Datei zwischen zwei DIV-Tags (<div class="janolaw-body">...</div) enthalten, jedoch keine komplette HTML-Struktur. Die Include-Dateien enthalten zudem keine Überschrift, da diese i.d.r. von den Shopsystemen zur Verfügung gestellt wird..html Sollten Dateien mit einer kompletten HTML-Struktur und einer Überschrift gewünscht werden, so können die oben genannten Dateinamen ohne _include verwendet werden (z.b. terms.html) janolaw AG Telefon: Telefax: [email protected] 1

2 .txt Für die Einbindung der oben genannten Inhalte in eine (z.b. Widerrufsbelehrung, Muster- Widerrufsformular, AGB), bieten wir diese auch als Text-Dokumente (ohne eine HTML-Struktur) an. Diese Text-Dokumente haben dann das Suffix.txt, also z.b. revocation.txt..pdf NEU!!! Alternativ können die Texte auch als Anhang in die Auftragsbestätigung eingebunden werden. (z.b. Widerrufsbelehrung, Muster-Widerrufsformular, AGB) bzw. zusätzlich auf den Webseiten. Formatierung und CSS Klassen Derzeit verwenden wir folgende DIV-Tags, die Sie sich entsprechend (per CSS) konfigurieren können. Wenn Sie den Style ändern wollen, ist es nötig, dass Sie die zur Verfügung gestellte CSS-Datei auf Ihrem Server ablegen um sie dort zu modifizieren (Die standardmäßig zur Verfügung gestellte CSS- Datei können Sie hier herunterladen): janolaw-footer: für die Fußzeile unseres Dokumentes; hierin befindet sich ein Link auf unsere Seite. janolaw-paragraph: Bezeichnet einen eigenen Paragrafen. Innerhalb dieser Dokumentklassen werden entsprechende Untertags (meist <b> und <br>, aber auch <ul> und <li>) verwendet. Pfad zu den Dokumenten Um die Seiten aufrufen zu können, benötigen Sie zwei IDs, die auf unserem System zur Identifikation genutzt werden. Das sind zum einen die Kundennummer (USER-ID) und zum anderen die Shopnummer (SHOP-ID). Diese beiden IDs bekommt der Kunde nach dem Kauf des AGB HOSTING- SERVICE mitgeteilt. Weiterhin wird noch der Sprachcode für das Land, für das die Dokumente angezeigt werden sollen, benötigt. Wir nutzen hier den ISO Länder-Code der einzelnen Länder, also z.b. DE für Deutschland, GB für England und FR für Frankreich (siehe dazu auch Mit diesen Daten können Sie dann die URL zu den entsprechenden Dokumenten (AGB etc.) aufbauen: NAME><DATEI-FORMAT> janolaw AG Telefon: Telefax:

3 Schnittstellen Versionen Die bisherigen Schnittstellen Versionen des AGB Hosting-Service im Vergleich: Neu ab Version 3 Version 1 Version 2 Version 3 Datei-Namen Impressum impressum legaldetails legaldetails AGB agb terms terms Widerrufsbelehrung widerrufsbelehrung revocation revocation Datenschutzerklärun g datenschutzerklaerung datasecurity datasecurity Muster- Widerrufsformular - - model-withdrawal-form Datei-Typen.html.html.html _include.html _include.html _include.html.txt.txt.txt - -.pdf Pfad für Speicherung service/shops/<user- ID>/<SHOP-ID>/<DATEI- NAME><DATEI- FORMAT> service/shops/<user- ID>/<SHOP- ID>/<LÄNDERCODE>/<D ATEI-NAME><DATEI- FORMAT> service/shops/<user- ID>/<SHOP- ID>/<LÄNDERCODE>/<D ATEI-NAME><DATEI- FORMAT> Länderordner ISO angebotene Sprachversionen Nein Ja Ja deutsch oder deutsch deutsch deutsch - - englisch - - französisch Tester Kennungen Deutsch: USER-ID: SHOP-ID: Deutsch: USER-ID: SHOP-ID: Mehrsprachig: USER-ID: SHOP-ID: janolaw AG Telefon: Telefax: [email protected] 3

4 Versionsprüfung Für die Versionsüberprüfung empfiehlt es sich folgende Prüfroutine zu entwickeln: Version 2 USER-ID: SHOP-ID: prüft auf Verfügbarkeit von: Version 3 USER-ID: SHOP-ID: prüft auf Verfügbarkeit von: Version 3 Mehrsprachigkeit USER-ID: SHOP-ID: prüft auf Verfügbarkeit von: Wenn es sich um die alten Versionen 1 oder 2 handelt, dann dürfen die Optionen für die PDF Einbindung bzw. Mehrsprachigkeit nicht angezeigt werden. Ein Hinweistext den Service neu zu generieren bzw. die mehrsprachige Version zu erwerben sollte hinterlegt und angezeigt werden. Bitte prüfen Sie, ob Sie die Texte neu generiert haben und für die optionale mehrsprachige Version den Service bei janolaw gebucht haben. Kontaktieren Sie dazu janolaw unter [email protected] oder unter / janolaw AG Telefon: Telefax: [email protected] 4

5 Usability / Einbindung der Dokumente Auftragsbestätigung Den Shopbetreibern sollte eine Auswahloption zur Verfügung gestellt werden, welche Sprachen genutzt werden sollen. Ebenso sollte dem Administrator die Option angeboten werden, dass die folgenden Dokumente Widerrufsbelehrung, Muster-Widerrufsformular, AGB und ab Mai 2018 die Datenschutzerklärung in den Kontext der eingebunden werden können oder dass die Rechtstexte mittels PDF Anhang eingebunden werden können. Wenn die PDF Dokumente als Anhang in der Auftragsbestätigung verwendet werden sollen, dann müssen diese mit dem jeweiligen Ländernamen im Shopsystem abgespeichert werden, da nur die englische Bezeichnung der Dokumente standardmäßig zur Verfügung steht. Dokumenten- Bezeichnung Länderordner Deutsch Englisch Französisch legaldetails Impressum Imprint Mentions légales terms AGB General Terms and Conditions Conditions Générales de Vente revocation Widerrufsbelehrung Instructions on withdrawal Informations standardisées sur la rétractation datasecurity Datenschutzerklärung Data privacy policy Déclaration quant à la protection des données model-withdrawal-form Muster-Widerrufsformular Model withdrawal form Modèle de formulaire de rétractation Webseiten Optional sollte dem Shopbetreiber angeboten werden, dass er die Rechtstexte zusätzlich als PDF auf die jeweiligen Webseiten bzw. in den Warenkorbprozess einbinden kann. Für diese Optionen sollte eine Versionsprüfung (vgl. S. 4) erfolgen. Sind keine PDF Dokumente verfügbar (Version 1 und 2), dann sollten die oben beschriebenen Auswahlfelder bzw. Optionen nicht angeboten bzw. grau hinterlegt werden und ein Hinweistext den Service neu zu generieren bzw. die mehrsprachige Version bei janolaw zu erwerben angezeigt werden. janolaw AG Telefon: Telefax: [email protected] 5

6 Deutschsprachige Texte Für einen Shop mit Deutscher Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum NEU!!! AGB NEU!!! Widerrufsbelehrung NEU!!! Datenschutzerklärung NEU!!! Muster-Widerrufsformular KOMPLETT NEU!!! janolaw AG Telefon: Telefax:

7 Englischsprachige Texte KOMPLETT NEU!!! Für einen Shop mit Englischer Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum AGB Widerrufsbelehrung Datenschutzerklärung Muster-Widerrufsformular janolaw AG Telefon: Telefax:

8 Französischsprachige Texte KOMPLETT NEU!!! Für einen Shop mit Französischer Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum AGB Widerrufsbelehrung Datenschutzerklärung Muster-Widerrufsformular janolaw AG Telefon: Telefax:

9 Kompatibilität mit alten Schnittstellen (Version 1) In einer Übergangszeit wird die Default-Sprache (meist: de) in das bisherige Verzeichnis mit den bisherigen Dokumentnamen kopiert, so dass auch ältere Plugins funktionieren. Hier sieht dann die URL wie folgt aus: FORMAT> Datei-Namen Bei Verwendung der Version 1 beschränkt sich das Datei-Angebot auf folgende Dokumente: AGB: Impressum: Widerrufsbelehrung: Datenschutzerklärung: agb impressum widerrufsbelehrung datenschutzerklaerung Datei-Typen Bei Verwendung der Version 1 werden nur folgende Datei-Typen angeboten: _include.html Bei den Include Dateien handelt es sich um HTML-Snippets, die nur den eigentlichen Body der Datei zwischen zwei DIV-Tags (<div class="janolaw-body">...</div) enthalten, jedoch keine komplette HTML-Struktur. Die Include-Dateien enthalten zudem keine Überschrift, da diese i.d.r. von den Shopsystemen zur Verfügung gestellt wird..html Sollten Dateien mit einer kompletten HTML-Struktur und einer Überschrift gewünscht werden, so können die oben genannten Dateinamen ohne _include verwendet werden (z.b. agb.html).txt Für die Einbindung der oben genannten Inhalte in eine (z.b. Widerrufsbelehrung), bieten wir diese auch als Text-Dokumente (ohne eine HTML-Struktur) an. Diese Text-Dokumente haben dann das Suffix.txt, also z.b. agb.txt. janolaw AG Telefon: Telefax: [email protected] 9

10 Pfad zu den Dokumenten Beispielhaft sieht das bei Verwendung der Version 1 wie folgt aus: Impressum AGB Widerrufsbelehrung Datenschutzerklärung janolaw AG Telefon: Telefax: [email protected] 10

11 Überblick über schon bestehende Schnittstellen janolaw AG Telefon: Telefax: