| name | planung |
| description | Plant neue Aufträge in Dimacon ein – vom Kundenabgleich über Projektauswahl bis zur Job- und Working-Erstellung. Verwende diesen Skill IMMER wenn der Benutzer einen Auftrag einplanen, anlegen, erstellen oder terminieren will. Auch verwenden bei: "Plane einen Auftrag für [Kunde]", "Leg einen Job an", "Neuer Auftrag für [Projekt]", "Termin einplanen", "Auftrag erstellen", "Job anlegen für [Datum]", "Kernbohrung einplanen", "Wandsäge-Auftrag", "Plane das ein", "Kannst du das einplanen?", "Auftrag aus Angebot erstellen", "Mach einen Job draus", "Plane [Angebotsnummer] ein". Triggert auch wenn der Benutzer eine Lexware-Angebotsnummer (z.B. "AG-2026-042") nennt und einen Auftrag daraus machen will, oder wenn er einen Kunden + Datum nennt und etwas eingeplant haben möchte. NICHT verwenden für Abrechnung (→ dimacon:abrechnung) oder Angebotserstellung aus Planungsexport-URLs (→ dimacon:lexware).
|
Dimacon Auftragsplanung
Dieser Skill plant neue Aufträge (Jobs) in Dimacon ein. Er führt den Benutzer
durch den Prozess: Kunde finden → Projekt auswählen → Job anlegen → optional
Workings vorbereiten.
0. Eingangsprüfung – Was will der Benutzer?
Bevor du loslegst, kläre welcher Fall vorliegt:
Fall A: Auftrag aus Lexware-Angebot
Der Benutzer nennt eine Angebotsnummer (z.B. "AG-2026-042", "Angebot 42")
oder sagt "Plan das Angebot ein".
→ Angebot in Lexware suchen:
miranum:lexoffice_list-voucherlist(voucherType="quotation", voucherNumber=<nummer>)
→ Angebotsdaten lesen: miranum:lexoffice_get-quotation(id=<uuid>)
→ Kundenname und Positionen aus dem Angebot extrahieren
→ Weiter mit Schritt 1 (Kunde suchen), Kundenname aus Angebot übernehmen
Fall B: Freier Auftrag
Der Benutzer beschreibt was gemacht werden soll, nennt einen Kunden und/oder
ein Projekt. Kein Lexware-Angebot involviert.
→ Direkt zu Schritt 1
Im Zweifel: Frag den Benutzer
Wenn unklar ist ob ein Angebot referenziert wird oder nicht, frag kurz nach:
"Gibt es ein bestehendes Angebot in Lexware dazu, oder soll ich einen freien
Auftrag anlegen?"
1. Kunde finden
Kundennamen aus dem Kontext ermitteln (aus Angebot, Benutzereingabe, oder
vorherigem Gespräch).
miranum:dimacon_list_customers()
Lokal nach dem genannten Kundennamen filtern (Teilstring-Match, case-insensitive).
Ergebnis:
- 1 Treffer →
customerId merken, weiter zu Schritt 2
- Mehrere Treffer → Dem Benutzer die Optionen zeigen, auswählen lassen
- Kein Treffer → Benutzer fragen: "Kunde '[Name]' nicht gefunden. Soll ich
den Kunden in Dimacon anlegen?" Falls ja →
miranum:dimacon_create_customer (Daten
vom Benutzer erfragen: Name, Straße, PLZ/Ort, ggf. Telefon/E-Mail)
2. Projekt auswählen
Projekte des Kunden finden:
miranum:dimacon_list_projects()
Lokal filtern: alle Projekte mit customerId des gefundenen Kunden.
Ergebnis:
- Projekte vorhanden → Dem Benutzer die Liste zeigen. Wenn der Benutzer
bereits einen Projektnamen / eine Adresse genannt hat, automatisch matchen.
Sonst auswählen lassen.
- Keine Projekte → Benutzer fragen ob ein neues Projekt angelegt werden
soll. Falls ja:
miranum:dimacon_create_project(
name=<Projektname>,
customerId=<customerId>,
street=<Straße>,
zipCity=<PLZ Ort>,
customAttributeValues=[]
)
Projektname, Adresse und sonstige Daten beim Benutzer erfragen.
3. Termin und Team klären
Bevor der Job angelegt wird, brauchen wir:
3a. Datum
- Aus Benutzereingabe ableiten ("nächsten Montag", "am 25.03.", "diese Woche")
- Datum in ISO 8601 umwandeln:
YYYY-MM-DDT07:00:00.000+01:00 (Standardstart 07:00)
- Winter (Nov–Mär):
+01:00, Sommer (Apr–Okt): +02:00
3b. Team
miranum:dimacon_list_active_teams()
Dem Benutzer die verfügbaren Teams zeigen und auswählen lassen.
Wenn der Benutzer bereits ein Team/einen Mitarbeiter namentlich genannt hat,
automatisch matchen.
3c. Angebotsnummer (optional)
Falls ein Lexware-Angebot vorliegt (Fall A): die Angebotsnummer als
offerNumber im Job hinterlegen. Das ist wichtig für die spätere Abrechnung
(→ dimacon:abrechnung, Pfad A).
4. Job anlegen
miranum:dimacon_create_job(
projectId=<projectId>,
dueDate=<datum ISO 8601>,
appointments=[
{
date: <datum ISO 8601>,
teamId: <teamId>
}
],
automaticallyCreateGuestAccess=true,
customAttributeValues=[],
offerNumber=<angebotsnummer oder leer>,
description=<Beschreibung der Arbeiten>
)
Pflichtfelder
projectId – aus Schritt 2dueDate – Zieldatumappointments – mindestens 1 Termin mit date + teamIdautomaticallyCreateGuestAccess – immer truecustomAttributeValues – leeres Array [] falls keine CAs
Optionale Felder
offerNumber – Lexware-Angebotsnummer (Fall A)description – Beschreibung der ArbeitenadditionalInformation – Zusatzinfoscolor – FarbmarkierunginvoiceNumber – Rechnungsnummer (selten bei Neuanlage)scheduledDateConfirmed – ob Termin bestätigt ist
Mehrere Termine
Wenn der Benutzer mehrere Tage plant (z.B. "Montag und Dienstag"), für jeden
Tag einen eigenen Appointment im Array anlegen. Jeder Appointment braucht
ein eigenes date und teamId (kann dasselbe Team sein).
5. Workings vorbereiten (optional)
Workings sind die einzelnen Tätigkeiten eines Auftrags (Kernbohrungen,
Wandsägeschnitte etc.). Sie werden normalerweise VOR ORT vom Team dokumentiert,
können aber vorausgefüllt werden wenn die Arbeiten bekannt sind.
Wann Workings anlegen?
- Fall A (Angebot vorhanden): Frag den Benutzer: "Soll ich die Positionen
aus dem Angebot als Workings voranlegen?" Falls ja → Workings aus den
Angebotspositionen ableiten.
- Fall B (Freier Auftrag): Nur wenn der Benutzer explizit Workings will
oder die konkreten Leistungen beschreibt.
- Im Zweifel: Nicht automatisch anlegen – das Team macht das vor Ort.
Working-Templates ermitteln
miranum:dimacon_list_working_templates()
Die Templates bestimmen welche Attribute pro Working erfasst werden.
Typische Templates:
- Kernbohrung (DOING) – Attribute: Durchmesser, Tiefe, Material, Aufwand
- Wandsäge (DOING) – Attribute: Schnittlänge, Wandstärke, Material
- Nebentätigkeit (ADDITIONAL_DOING) – Attribute: Dauer, Beschreibung
Working erstellen
miranum:dimacon_create_working(
jobId=<jobId>,
templateId=<templateId>,
type="DOING",
amount=1,
appointment=<appointmentId>,
attributes=[
{ templateAttributeId: "<attrId>", value: "<wert>" }
],
fileNames=[]
)
Oder für mehrere auf einmal:
miranum:dimacon_create_workings(
jobId=<jobId>,
workings=[...]
)
Die appointmentId kommt aus der Job-Erstellung (Schritt 4 – Response enthält
die erstellten Appointments mit IDs).
6. Zusammenfassung
Nach erfolgreicher Erstellung dem Benutzer eine kurze Zusammenfassung geben:
✅ Auftrag angelegt:
Kunde: <Kundenname>
Projekt: <Projektname>
Termin: <Datum>, Team: <Teamname>
Angebot: <Angebotsnr.> (falls vorhanden)
Workings: <Anzahl> vorausgefüllt (falls erstellt)
Regeln
IMMER
- Kunde zuerst suchen – nie blind eine customerId annehmen
- Projekt zum Kunden – nie ein Projekt eines anderen Kunden verwenden
- Team auswählen lassen – nie ein Team raten
- Termin bestätigen – bevor der Job erstellt wird, den Benutzer die
Details bestätigen lassen
automaticallyCreateGuestAccess=true – damit Kunden den Bericht sehen
NIE
- Nicht automatisch Workings anlegen ohne Rückfrage
- Nicht Jobs ohne Appointment erstellen
- Nicht
miranum:dimacon_list_jobs oder miranum:dimacon_get_current_jobs verwenden –
wir ERSTELLEN hier, wir suchen keine bestehenden Jobs
- Nicht die Abrechnung starten – dafür ist
dimacon:abrechnung zuständig
DATENVALIDIERUNG
- Datumsformat immer ISO 8601 mit Zeitzone
customAttributeValues immer als Array senden (auch wenn leer: [])- Team-IDs und Projekt-IDs sind UUIDs (Strings)
- Angebotsnummern aus Lexware exakt übernehmen
Fehlerbehandlung
| Situation | Aktion |
|---|
| Kunde nicht gefunden | Benutzer fragen ob Neuanlage |
| Kein Projekt beim Kunden | Benutzer fragen ob Neuanlage |
| Kein aktives Team | Benutzer informieren |
| Job-Erstellung fehlgeschlagen | Fehler zeigen, ggf. Daten korrigieren |
| Angebot in Lexware nicht gefunden | Benutzer informieren, als freien Auftrag weiter |
| Benutzer bricht ab | Kein Problem, nichts wird erstellt bis zur Bestätigung |
