KSIDol-Dokumentation > KSIDol-Module > PropalQR
Modulanleitung: PropalQR
Nicht-technische Bedienungsanleitung: wozu das Modul dient, wie man es verwendet und wie es mit Dolibarr zusammenspielt.
KundensignaturMit 1 Scan
QR-Code-PositionenBeleg, PDF, E-Mail
Akzentfarben6 Farbtöne
Angesteuerte PDF-SeitenErste, alle oder letzte
1. Moduluberblick
PropalQR ("Angebotssignatur per QR-Code") fügt neben dem Online-Signatur-Link Ihrer Dolibarr-Angebote einen QR-Code hinzu. Konkret muss der Kunde keine Adresse mehr abtippen oder in einer E-Mail nach einem Link suchen: Er scannt den QR-Code mit der Kamera seines Telefons und gelangt direkt auf die Online-Signaturseite des Angebots. Das ist eine Abkürzung, die die Annahme eines Angebots beschleunigt, besonders bei einem Termin oder bei der Übergabe eines Papierdokuments.
Das Modul erzeugt keine neuen Daten und ersetzt nichts: Es stützt sich vollständig auf die nativen Objekte von Dolibarr. Der QR-Code codiert lediglich die Online-Signatur-URL, die Dolibarr für das Angebot bereits bereitstellt. Es funktioniert also dort, wo Ihr Angebot bereits lebt: auf dem Angebotsbeleg, im erzeugten PDF und in den aus Dolibarr versendeten E-Mails.
- Verwandelt den Online-Signatur-Link eines Angebots in einen QR-Code, den der Kunde zum Unterschreiben scannt
- Erscheint automatisch auf dem Angebotsbeleg, neben dem vorhandenen Link
- Kann dem Angebots-PDF hinzugefügt und in E-Mail-Vorlagen eingefügt werden
- Stützt sich ausschließlich auf die native Online-Signatur von Dolibarr: Es wird nichts weiter offengelegt als der bereits an den Kunden übermittelte Link
- Keine Pflichtkonfiguration: Das Modul wählt standardmäßig passende Einstellungen
2. QR-Code auf dem Angebotsbeleg
Auf dem Bildschirm eines Angebots fügt das Modul unter den Angebotsinformationen ein Feld "QR-Code für die Online-Signatur" hinzu, neben dem bereits vorhandenen Signatur-Link.
- Zeigt einen Block mit dem Titel, dem öffentlichen (anklickbaren) Signatur-Link und dem Bild des QR-Codes
- Der QR-Code codiert die Adresse der Online-Signaturseite des Angebots
- Das Feld erscheint nur in der normalen Angebotsansicht (nicht während der Vorbereitung einer E-Mail), um die Bildschirme nicht zu verlangsamen
- Der Mitarbeiter kann den Code direkt am Bildschirm vom anwesenden Kunden scannen lassen
3. QR-Code auf dem Angebots-PDF
Wenn Dolibarr das PDF eines Angebots erzeugt, fügt das Modul einen Block mit dem Signatur-QR-Code hinzu – praktisch für ein gedrucktes oder als Anhang versendetes Angebot.
- Fügt den QR-Code dem von Dolibarr erzeugten Angebots-PDF hinzu (der ausgeschriebene Link wird im PDF nicht wiederholt)
- Die Position des Blocks (X- und Y-Koordinaten in Millimetern) ist in der Konfiguration einstellbar
- Die Farbe des QR-Codes und seines Titels folgt dem gewählten Akzentton
- Sie wählen, auf welchen Seiten er erscheint: nur die erste, alle oder nur die letzte
- Der Kunde scannt den QR-Code auf dem Papier- oder PDF-Dokument, um die Online-Signatur auf seinem Telefon zu öffnen
4. QR-Code und Link in E-Mails
Das Modul stellt zwei "Ersetzungsfelder" (Substitutionen) bereit, die Sie in Ihre Dolibarr-E-Mail-Vorlagen einfügen können, um den QR-Code oder den Signatur-Link einzubinden.
- __PROPAL_SIGNATURE_QRCODE__: fügt das Bild des QR-Codes in den Text der E-Mail ein
- __PROPAL_SIGNATURE_QRCODE_URL__: fügt den öffentlichen Signatur-Link ein (nützlich, wenn der Kunde die Anzeige von Bildern blockiert)
- Das Bild des QR-Codes wird bei Bedarf erzeugt, um das Öffnen des Formulars "E-Mail senden" nicht zu verlangsamen
- Diese Felder werden wie die anderen Dolibarr-Variablen in die E-Mail-Vorlagen eingefügt
5. Konfiguration des Moduls
Das Modul fügt einen Menüeintrag "Propal QR" und eine Einstellungsseite hinzu. Keine Einstellung ist Pflicht: Die Standardwerte passen in den meisten Fällen.
- QR-Position im PDF: X-Koordinate (vom linken Rand) und Y (von oben), in Millimetern; bleibt das Feld leer, wird die automatische Platzierung beibehalten
- Visuelle Vorschau: Ein Seitenmodell (Muster der Vorlage Cyan) zeigt live, wo der QR-Code landet, während Sie X und Y anpassen
- Akzentfarbe: 6 angebotene Farbtöne (Tintenschwarz, Ozeanblau, Smaragdgrün, Violett, Bernsteinorange, Karminrot)
- Anzeige des QR im PDF: nur erste Seite, alle Seiten oder nur letzte Seite
- Schaltflächen "Speichern" und "Standardposition wiederherstellen", um zu den ursprünglichen Einstellungen zurückzukehren
6. Anzeigebedingungen des QR-Codes
Der QR-Code erscheint nur, wenn eine Signatur sinnvoll ist, um keinen inaktiven Link anzubieten.
- Die Online-Signatur der Angebote muss in Dolibarr aktiviert sein
- Das Angebot darf nicht mehr im Entwurfsstatus sein (das Angebot muss validiert sein)
- Sind diese Bedingungen nicht erfüllt, wird kein QR-Block angezeigt oder dem PDF hinzugefügt
- Das Modul unterstützt Mehrmandanten-Umgebungen (Multi-Entity), um die richtige öffentliche Adresse zu berechnen
7. Verknupfungen mit Dolibarr
Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.
- Angebote (Preisangebote) : Das Modul hängt vom nativen Modul Angebote ab: Der QR-Block wird auf dem Angebotsbeleg und in dessen PDF ergänzt, ohne die Struktur der Angebote zu verändern.
- Dolibarr Online-Signatur : Der QR-Code codiert die von Dolibarr bereitgestellte Online-Signatur-URL. Die Online-Signatur der Angebote muss daher aktiviert sein. Das Modul legt nichts weiter offen als diesen bereits an den Kunden übermittelten öffentlichen Link.
- PDF-Erzeugung : Das Modul klinkt sich in die native PDF-Erzeugung (Angebotsvorlagen) ein, um dort den QR-Block abzulegen – an der Position und auf den Seiten, die Sie wählen.
- E-Mail-Vorlagen (Substitutionen) : Es stellt zwei Ersetzungsvariablen (__PROPAL_SIGNATURE_QRCODE__ und __PROPAL_SIGNATURE_QRCODE_URL__) bereit, die in Dolibarr-E-Mail-Vorlagen wie die anderen Standardfelder wiederverwendbar sind.
- Kunden / empfangende Geschäftspartner : Es ist der Kunde als Empfänger des Angebots, der den QR-Code scannt, um online zu unterschreiben; das Modul erleichtert diesen Ablauf, ohne einen zusätzlichen Datensatz oder zusätzliche Daten anzulegen.
- Dokumentstatus : Das Verhalten folgt dem nativen Status des Angebots: Der QR wird nur für ein validiertes Angebot angeboten (nie für einen Entwurf).
