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. 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).txt Für die Einbindung der oben genannten Inhalte in eine E-Mail (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 E-Mail Auftragsbestätigung eingebunden werden. (z.b. Widerrufsbelehrung, Muster-Widerrufsformular, AGB) bzw. zusätzlich auf den Webseiten. 1
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 Weiterhin wird noch der Sprachcode für das Land, für das die Dokumente angezeigt werden sollen, benötigt. Wir nutzen hier den ISO 3166-1-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 http://de.wikipedia.org/wiki/iso_3166). Mit diesen Daten können Sie dann die URL zu den entsprechenden Dokumenten (AGB etc.) aufbauen: 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. http://www.janolaw.de/agb-service/shops/<user-id>/<shop-id>/<ländercode>/<datei- NAME>>/<DATEI-FORMAT> 2
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 http://www.janolaw.de/agb- service/shops/<user- ID>/<SHOP-ID>/<DATEI- NAME>>/<DATEI- FORMAT> http://www.janolaw.de/agb- service/shops/<user- ID>/<SHOP- ID>/<LÄNDERCODE>/<D ATEI-NAME>>/<DATEI- FORMAT> http://www.janolaw.de/agb- service/shops/<user- ID>/<SHOP- ID>/<LÄNDERCODE>/<D ATEI-NAME>>/<DATEI- FORMAT> Länderordner ISO 3166-1 angebotene Sprachversionen Nein Ja Ja deutsch deutsch deutsch - - englisch - - französisch Tester Kennungen USER-ID: 100181773 SHOP-ID: 299899 USER-ID: 100270996 SHOP-ID: 777701 USER-ID: 100284901 SHOP-ID: 761296 3
Versionsprüfung Für die Versionsüberprüfung empfiehlt es sich folgende Prüfroutine zu entwickeln: 1. Schritt) Prüfung ob es das Dokument model-withdrawal-form gibt Wenn ja, dann handelt es sich um Version 3 2. Schritt) Wenn nein, dann Prüfung ob es weitere Dokumente mit englischer Bezeichnung gibt Wenn ja, dann handelt es sich um Version 2 Wenn nein, dann handelt es sich um Version 1 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 support@janolaw.de oder unter 06196 / 77 22 777 Alternativ kann im Rahmen der Versionsprüfung aber auch geprüft werden ob in den jeweiligen.html bzw. _include.html Dateien ein Meta Tag Version3 enthalten ist. Beispielhaft ein Screenshot für die englischen Version 4
Synchronisation Die oben genannten Dateien sollten regelmäßig mit einer Zeitspanne von zwei bis maximal acht Stunden automatisch synchronisiert und auf dem Shopsystem gecacht werden. Es empfiehlt sich, den Kunden zusätzlich eine manuelle Synchronisierung anzubieten bzw. die Option das Aktualisierungsintervall selbst zu definieren. Die Inhalte der Dateien sind grundsätzlich im Shopsystem an der entsprechenden Stelle so einzubinden, dass sie nicht nur auf der Webseite sondern in allen relevanten Prozessen (z.b. Widerrufsbelehrung, Muster-Widerrufsformular, AGB in der E-Mail zur Bestellbestätigung) zur Verfügung stehen. Sollte die Synchronisation, d.h. der Datei-Download, nicht fehlerfrei ausgeführt werden können, dann sind auch weiterhin die entsprechend gecachten Inhalte zu nutzen und im Shopsystem anzuzeigen. Usability / Einbindung der Dokumente E-Mail 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 3 Dokumente (Widerrufsbelehrung, Muster-Widerrufsformular, AGB) in den Kontext der E-Mail eingebunden werden können oder dass die Rechtstexte mittels PDF Anhang eingebunden werden können. Wenn die PDF Dokumente als Anhang in der E-Mail Auftragsbestätigung verwendet werden sollen, dann müssen diese mit dem jeweiligen Ländernamen im Shopsystem abgespeichert werden, da sonst 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 5
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. 6
Deutschsprachige Texte Für einen Shop mit Deutscher Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum http://www.janolaw.de/agb-service/shops/100284901/761296/de/legaldetails.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/legaldetails_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/legaldetails.txt http://www.janolaw.de/agb-service/shops/100284901/761296/de/legaldetails.pdf NEU!!! AGB http://www.janolaw.de/agb-service/shops/100284901/761296/de/terms.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/terms_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/terms.txt http://www.janolaw.de/agb-service/shops/100284901/761296/de/terms.pdf NEU!!! Widerrufsbelehrung http://www.janolaw.de/agb-service/shops/100284901/761296/de/revocation.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/revocation_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/revocation.txt http://www.janolaw.de/agb-service/shops/100284901/761296/de/revocation.pdf NEU!!! Datenschutzerklärung http://www.janolaw.de/agb-service/shops/100284901/761296/de/datasecurity.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/datasecurity_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/datasecurity.txt http://www.janolaw.de/agb-service/shops/100284901/761296/de/datasecurity.pdf NEU!!! Muster-Widerrufsformular KOMLETT NEU!!! http://www.janolaw.de/agb-service/shops/100284901/761296/de/model-withdrawal-form.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/model-withdrawal-form_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/de/model-withdrawal-form.txt http://www.janolaw.de/agb-service/shops/100284901/761296/de/model-withdrawal-form.pdf 7
Englischsprachige Texte KOMLETT NEU!!! Für einen Shop mit Englischer Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum http://www.janolaw.de/agb-service/shops/100284901/761296/gb/legaldetails.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/legaldetails_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/legaldetails.txt http://www.janolaw.de/agb-service/shops/100284901/761296/gb/legaldetails.pdf AGB http://www.janolaw.de/agb-service/shops/100284901/761296/gb/terms.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/terms_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/terms.txt http://www.janolaw.de/agb-service/shops/100284901/761296/gb/terms.pdf Widerrufsbelehrung http://www.janolaw.de/agb-service/shops/100284901/761296/gb/revocation.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/revocation_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/revocation.txt http://www.janolaw.de/agb-service/shops/100284901/761296/gb/revocation.pdf Datenschutzerklärung http://www.janolaw.de/agb-service/shops/100284901/761296/gb/datasecurity.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/datasecurity_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/datasecurity.txt http://www.janolaw.de/agb-service/shops/100284901/761296/gb/datasecurity.pdf Muster-Widerrufsformular http://www.janolaw.de/agb-service/shops/100284901/761296/gb/model-withdrawal-form.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/model-withdrawal-form_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/gb/model-withdrawal-form.txt http://www.janolaw.de/agb-service/shops/100284901/761296/gb/model-withdrawal-form.pdf 8
Französischsprachige Texte KOMPLETT NEU!!! Für einen Shop mit Französischer Sprache sähen die Dokumenten-Pfade wie folgt aus: Impressum http://www.janolaw.de/agb-service/shops/100284901/761296/fr/legaldetails.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/legaldetails_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/legaldetails.txt http://www.janolaw.de/agb-service/shops/100284901/761296/fr/legaldetails.pdf AGB http://www.janolaw.de/agb-service/shops/100284901/761296/fr/terms.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/terms_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/terms.txt http://www.janolaw.de/agb-service/shops/100284901/761296/fr/terms.pdf Widerrufsbelehrung http://www.janolaw.de/agb-service/shops/100284901/761296/fr/revocation.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/revocation_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/revocation.txt http://www.janolaw.de/agb-service/shops/100284901/761296/fr/revocation.pdf Datenschutzerklärung http://www.janolaw.de/agb-service/shops/100284901/761296/fr/datasecurity.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/datasecurity_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/datasecurity.txt http://www.janolaw.de/agb-service/shops/100284901/761296/fr/datasecurity.pdf Muster-Widerrufsformular http://www.janolaw.de/agb-service/shops/100284901/761296/fr/model-withdrawal-form.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/model-withdrawal-form_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/fr/model-withdrawal-form.txt http://www.janolaw.de/agb-service/shops/100284901/761296/fr/model-withdrawal-form.pdf 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: http://www.janolaw.de/agb-service/shops/<user-id>/<shop-id>/<datei-name>>/<datei- 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 E-Mail (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. 10
Pfad zu den Dokumenten Beispielhaft sieht das bei Verwendung der Version 1 wie folgt aus: Impressum http://www.janolaw.de/agb-service/shops/100284901/761296/impressum.html http://www.janolaw.de/agb-service/shops/100284901/761296/impressum_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/impressum.txt AGB http://www.janolaw.de/agb-service/shops/100284901/761296/agb.html http://www.janolaw.de/agb-service/shops/100284901/761296/agb_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/agb.txt Widerrufsbelehrung http://www.janolaw.de/agb-service/shops/100284901/761296/widerrufsbelehrung.html http://www.janolaw.de/agb-service/shops/100284901/761296/widerrufsbelehrung_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/widerrufsbelehrung.txt Datenschutzerklärung http://www.janolaw.de/agb-service/shops/100284901/761296/datenschutzerklaerung.html http://www.janolaw.de/agb-service/shops/100284901/761296/datenschutzerklaerung_include.html http://www.janolaw.de/agb-service/shops/100284901/761296/datenschutzerklaerung.txt 11
Überblick über schon bestehende Schnittstellen http://www.janolaw.de/agb-service/anleitungen_einbindung.html#menu 12