Konfiguration - CptGummiball/Kitting-CoPack-Suite GitHub Wiki
Konfiguration
Alle Einstellungen werden über das Admin-Panel verwaltet: Einstellungen (/settings).
Hinweis: Nur Benutzer mit der Rolle admin haben Zugriff auf die Einstellungen.
Allgemein
| Feld |
Beschreibung |
| Unternehmensname |
Wird im Header und in Labels angezeigt |
QZ Tray
| Feld |
Beschreibung |
| Aktiviert |
QZ Tray Integration ein-/ausschalten |
| Host / IP-Adresse |
IP des QZ Tray Servers (z.B. 192.168.1.50) |
| Port |
Standard: 8181 |
| Signiertes Zertifikat |
PEM-Zertifikat für gesicherte Verbindung |
Zertifikats-Bestätigung
Beim ersten Verbindungsaufbau von einem neuen Gerät muss die Anfrage am QZ Tray Host manuell bestätigt werden. Da die IP-Adressen statisch sind, ist dies nur einmalig erforderlich. Die App zeigt während der Wartezeit einen Fullscreen-Wartebildschirm an.
Weclapp ERP
| Feld |
Beschreibung |
| Aktiviert |
Weclapp-Integration ein-/ausschalten |
| Tenant URL |
Weclapp-Instanz (z.B. https://firma.weclapp.com) |
| API Token |
Aus Weclapp: Mein Konto → API Token |
| Artikeltypen |
Kommasepariert, z.B. STORABLE, SALES_BILL_OF_MATERIAL |
Produktionsartikel-Synchronisation
- Nur per Knopfdruck — keine automatische Synchronisation
- Synchronisiert werden nur Artikel der konfigurierten Artikeltypen
- Zusätzlich werden alle Artikel synchronisiert, die in Stücklisten (BOM) dieser Produktionsartikel referenziert sind
- Existierende Artikel werden per SKU (Artikelnummer) zugeordnet
WMS / Lager-Anbindung
| Feld |
Beschreibung |
| Aktiviert |
WMS-Integration ein-/ausschalten |
| Übergabe-Modus |
Einfacher Webhook oder WMS-Nachricht |
Einfacher Webhook
Sendet einen HTTP POST an eine konfigurierbare URL.
| Feld |
Beschreibung |
| Webhook URL |
Ziel-URL für die Übergabe-Benachrichtigung |
| Webhook Secret |
Optionaler Header X-Webhook-Secret |
WMS-Nachricht
Sendet eine strukturierte JSON-Nachricht an ein WMS-System.
| Feld |
Beschreibung |
| WMS Endpoint URL |
API-Endpunkt des WMS |
| WMS API-Key |
Bearer Token für die Authentifizierung |
Nachrichtenformat (JSON):
{
"messageType": "WAREHOUSE_HANDOVER",
"version": "1.0",
"timestamp": "2026-04-05T10:00:00Z",
"order": {
"externalId": "task-001",
"referenceId": "WK-2026-0301",
"title": "Premium Welcome Kits",
"quantity": 500,
"itemSku": "KIT-PRO-2026",
"itemName": "Premium Welcome Kit",
"priority": "high"
},
"handover": {
"userId": "usr-003",
"userName": "Tom Weber",
"timestamp": "2026-04-05T10:00:00Z"
}
}
Benutzer-Synchronisation
| Feld |
Beschreibung |
| Aktiviert |
Benutzer-Sync ein-/ausschalten |
| Quell-URL |
REST API die ein JSON-Array von Benutzern zurückgibt |
| API-Key |
Bearer Token für die externe API |
Die externe API soll folgendes Format liefern:
[
{ "email": "[email protected]", "name": "Max Mustermann", "role": "user" }
]
Tasks & Workflows
| Feld |
Beschreibung |
| Chargennummern-Präfix |
Präfix für automatisch generierte Chargennummern |
| Schritte überspringen |
Erlaubt das Überspringen bestimmter Timeline-Schritte |
Überspringbare Schritte
Wenn aktiviert, können folgende Schritte übersprungen werden:
- In Bearbeitung → Direkt von Offen/Geplant zu Fertiggestellt
- Fertiggestellt → Direkt von In Bearbeitung zur Lagerübergabe
- Lagerübergabe → Direkt von Fertiggestellt zu Eingelagert
Theme & Branding
| Feld |
Beschreibung |
| Hauptfarbe |
Primärfarbe für Buttons, Links, aktive Elemente |
Datenbank & Backend
| Feld |
Beschreibung |
| Datenbank-Engine |
Flat-File JSON (Demo), MySQL (Produktion), Firebase (Cloud) |
| Verbindungs-URL |
Nur für MySQL/Firebase: Connection String |