dolibarr.handybarcodescanner/README.md

HANDYBARCODESCANNER FOR DOLIBARR ERP & CRM

Mobiler Barcode-Scanner für Dolibarr - optimiert für die Verwendung auf Smartphones.

Features

Das Modul bietet drei Modi für die mobile Barcode-Erfassung:

1. Bestellmodus (Order)

• Produkt per Barcode scannen
• Alle verfügbaren Lieferanten mit Einkaufspreisen werden angezeigt
• Günstigster Lieferant ist vorausgewählt
• Produkt wird zu einer lieferantenspezifischen Entwurfsbestellung hinzugefügt
• Bestellungen werden automatisch als "Direktbestellung-[Lieferantenname]" erstellt
• Falls kein Lieferant zugewiesen: Manuelle Auswahl aller verfügbaren Lieferanten

2. Shop-Modus

• Produkt per Barcode scannen
• Zeigt Links zu den Webshops der Lieferanten
• Schneller Zugriff auf Lieferanten-Onlineshops

3. Inventur-Modus

• Produkt per Barcode scannen
• Aktueller Lagerbestand wird angezeigt
• Neuen Bestand eingeben und mit Bestätigungsdialog speichern
• Lagerbewegungen werden korrekt protokolliert

Barcode-Unterstützung

Das Modul sucht Barcodes in folgender Reihenfolge:

1. Produkt-Barcode (llx_product.barcode)
2. Lieferanten-Barcode (llx_product_fournisseur_price.barcode)
3. Produkt-Referenz (llx_product.ref)

Unterstützte Barcode-Formate:

• EAN-13, EAN-8
• Code 128, Code 39

Installation

Voraussetzungen

• Dolibarr ERP & CRM (Version 14.0 oder höher empfohlen)
• Aktiviertes Modul "Lieferanten" (Fournisseur/Supplier)
• Aktiviertes Modul "Lager" (Stock) für Inventur-Modus
• HTTPS-Verbindung (erforderlich für Kamerazugriff im Browser)

Installation via Git

cd /path/to/dolibarr/htdocs/custom
git clone https://git.data-it-solution.de/data/dolibarr.handybarcodescanner.git handybarcodescanner

Installation via ZIP

1. ZIP-Datei herunterladen
2. In Dolibarr: Home > Setup > Modules > Deploy external module
3. ZIP-Datei hochladen

Aktivierung

1. Als Administrator in Dolibarr einloggen
2. Gehe zu Setup > Modules
3. Suche nach "HandyBarcodeScanner"
4. Modul aktivieren

Konfiguration

Die Einstellungen sind unter Setup > Modules > HandyBarcodeScanner > Settings verfügbar:

Allgemein

• Bestellpräfix: Präfix für automatisch erstellte Bestellungen (Standard: "Direktbestellung")
• Standard-Lager: Standard-Lager für Inventur-Bewegungen

Aktivierte Modi

• Bestellmodus aktivieren: Ein/Aus
• Shop-Modus aktivieren: Ein/Aus
• Inventur-Modus aktivieren: Ein/Aus

Feedback

• Vibration aktivieren: Vibriert bei erfolgreichem Scan (auf unterstützten Geräten)
• Ton aktivieren: Akustisches Signal bei erfolgreichem Scan

QR-Code für mobilen Zugriff

Auf der Einstellungsseite wird ein QR-Code angezeigt, der mit dem Smartphone gescannt werden kann, um direkt zur Scanner-Seite zu gelangen.

Berechtigungen

Das Modul definiert folgende Berechtigungen:

Berechtigung	Beschreibung
handybarcodescanner->use	Scanner verwenden
handybarcodescanner->order->create	Bestellungen erstellen
handybarcodescanner->inventory->write	Lagerbestand ändern

Verwendung

Der Scanner ist im linken Menü unter Produkte > Scanner erreichbar.

Moduswechsel ohne Unterbrechung

Die Modi (Bestellen/Shop/Inventur) können per Tab gewechselt werden, ohne dass die Kamera stoppt. Bereits gescannte Produkte werden im neuen Modus direkt angezeigt.

Im mobilen Browser / PWA

1. QR-Code von der Admin-Seite scannen oder URL direkt eingeben
2. Kamerazugriff erlauben (HTTPS erforderlich!)
3. Gewünschten Modus wählen und "Scan starten" tippen
4. Barcode vor die Kamera halten

Technische Details

Dateistruktur

handybarcodescanner/
├── admin/
│   ├── about.php
│   └── setup.php
├── ajax/
│   ├── addtoorder.php      # Produkt zu Bestellung hinzufügen
│   ├── findproduct.php     # Produkt per Barcode suchen
│   ├── getsuppliers.php    # Alle Lieferanten abrufen
│   └── updatestock.php     # Lagerbestand aktualisieren
├── core/modules/
│   └── modHandyBarcodeScanner.class.php
├── css/
│   └── scanner.css
├── js/
│   └── scanner.js
├── langs/
│   ├── de_DE/handybarcodescanner.lang
│   └── en_US/handybarcodescanner.lang
├── lib/
│   └── handybarcodescanner.lib.php
└── handybarcodescannerindex.php

Verwendete Bibliotheken

• QuaggaJS - Browser-basierte Barcode-Erkennung

Changelog

Siehe ChangeLog.md

Lizenz

Hauptcode

GPLv3 oder (nach Wahl) jede spätere Version. Siehe Datei COPYING für weitere Informationen.

Dokumentation

Alle Texte und READMEs sind unter GFDL lizenziert.

Autor

Eduard Wisch - DATA IT-Solution

Support

Bei Fragen oder Problemen:

• Issue erstellen: https://git.data-it-solution.de/data/dolibarr.handybarcodescanner/issues
• E-Mail: data@data-it-solution.de