angebot-lv

name: angebot-lv description: Erstellt Angebote in Lexware Office (Lexoffice) aus einem hochgeladenen LV (PDF). Daraus wird eine strukturierte Excel (Claude Desktop/Code) bzw. ein editierbares Live-Artefakt (Cowork), das per Knopfdruck zum Lexoffice-Angebot wird. Triggert bei "hier ist das LV", "kalkulier mir das LV", "Excel zum LV", "Angebot aus LV", oder wenn ein PDF mit "LV", "Leistungsverzeichnis" oder "Ausschreibung" hochgeladen wird. NICHT für: einfache Angebote ohne LV (→ lexoffice:angebot), Rechnungen aus Dimacon-Jobs (→ dimacon:abrechnung), Angebote aus Dimacon-Planungs-URLs (→ dimacon:lexware), Aufträge planen (→ dimacon:planung).

ACADEMY ANGEBOT

Pflichtworkflow für jedes Angebot in Lexware Office. Der Skill verarbeitet zwei Eingangsformen und produziert je nach Umgebung unterschiedliche Outputs.

Eingangsformen erkennen

Bei gemischten Eingaben (PDF + ergänzende Worte) immer den PDF-Pfad nehmen — die Datei ist die Quelle der Wahrheit.

Umgebungen erkennen

In Zweifelsfällen: Excel ist immer ein sinnvoller Output, weil sie auch in Cowork heruntergeladen werden kann.

Reihenfolge — Pfad A: Direkt-Angebot

1. Kunde prüfen — Schritt 1
2. Adresse recherchieren (bei neuem Kontakt) — Schritt 1b
3. Steuerstatus klären — Schritt 2
4. Preise aus Lexoffice laden — Schritt 3
5. Kontakt anlegen oder updaten — Schritt 4
6. Angebot anlegen — Schritt 5
7. Deeplink ausgeben — Schritt 6
8. Bei Cowork: Live-Artefakt — Schritt 7

Reihenfolge — Pfad B: LV-PDF → Excel/Artefakt → Angebot

• B1. PDF lesen, Positionen extrahieren
• B2. Lexoffice-Artikelstamm laden (= Schritt 3 vorgezogen)
• B3. Mapping LV-Position ↔ Lex-Art-Nr automatisch erzeugen
• B4. Output: Excel-Datei (Desktop/Code) ODER Live-Artefakt (Cowork)
• B5. User bearbeitet/bestätigt → bei Excel-Pfad: bearbeitete Excel zurück → einlesen
• B6. Steuerstatus klären — Schritt 2
• B7. Kunde prüfen + ggf. anlegen — Schritt 1, 1b, 4
• B8. Angebot anlegen — Schritt 5
• B9. Deeplink — Schritt 6

Details zu Schritten 1–7 stehen unten. Die Pfad-B-spezifischen Schritte folgen direkt darunter.

Schritt 1 — Kunde prüfen

lexoffice_list-contacts(name: "<Firmenname>", customer: true, size: 50)

Substring-Suche. Bei Mehrtreffern dem User die Liste zeigen und fragen. Bei Null Treffern → Schritt 1b.

Schritt 1b — Adresse recherchieren (neuer Kontakt)

IMMER zuerst per WebSearch nach der Firma recherchieren, bevor der Kontakt angelegt wird. Firmenadressen sind fast immer im Netz auffindbar.

WebSearch(query: "<Firmenname> Adresse Telefon")

Liefern soll: Vollständiger Firmenname (mit Rechtsform), Straße + Hausnr., PLZ + Ort, Telefon, E-Mail.

Bei mehreren Standorten den geografisch zur Baustelle passenden wählen. Im Zweifel User fragen. Nur wenn die Suche wirklich nichts liefert: Provisorisch Baustellenadresse + note-Vermerk.

Schritt 2 — Steuerstatus klären

Bauleistender im Sinne von §13b UStG?

Ja: Bauunternehmen, GU, ARGE, Bauträger, Schlüsselfertigbau, Tiefbau, Hochbau, Rohbau, Innenausbau, GaLaBau (bei baulichen Leistungen), Bau-Subunternehmer.

Nein: Privatperson, Stadt/Gemeinde/öffentliche Hand, Industrie ohne Bautätigkeit, Hausverwaltung, Architekt, Ingenieurbüro.

Bei Unsicherheit immer fragen: "Ist [Kunde] ein Bauleistender (§13b)? — sonst nehme ich Standard 19% USt."

Schritt 3 — Preise aus Lexoffice laden (Pflicht!)

lexoffice_list-articles(size: 250)

Niemals den User nach Preisen fragen — die Preise kommen aus dem System. Bei sehr großen Antworten: per Subagent oder Grep filtern.

Artikelnummern-Bereiche:

• 10xxx — Anfahrt/BE
• 21xxx — Kernbohrung Stahlbeton (cm)
• 22xxx — Kernbohrung Mauerwerk (cm)
• 30100 — Wandsäge (m²), 30200 — Seilsäge (m²), 30300 — Kettensäge (cm)
• 30400/30500 — Fugenschneider (m²)
• 40xxx-42xxx — Aufwand/Befestigung/Geräte
• 99100 — Nebenarbeiten (Std)

Kernbohrungs-ø-Werte: 50/80/102/125/152/200/250/300/350/400/450/500/600/700/800/1000 mm. "ø150" → 21152 (DN150-Durchbruch wird mit ø152-Krone gebohrt).

Schritt 4 — Kontakt anlegen oder updaten

{
  "version": 0,
  "roles": { "customer": {} },
  "company": {
    "name": "<Firmenname>",
    "allowTaxFreeInvoices": true,
    "contactPersons": [...]
  },
  "addresses": {
    "billing": [{ "street": "...", "zip": "...", "city": "...", "countryCode": "DE" }]
  },
  "emailAddresses": { "business": [...] },
  "phoneNumbers": { "business": [...] }
}

allowTaxFreeInvoices: true für Bauleistende — sonst lehnt die API taxType: "constructionService13b" ab. Falls der Kontakt schon existiert, aber das Flag fehlt: per lexoffice_update-contact nachsetzen. Pflichtfelder Adresse: name + countryCode.

Schritt 5 — Angebot anlegen

{
  "voucherDate": "<heute YYYY-MM-DDTHH:mm:ss.000+02:00>",
  "expirationDate": "<heute + 30 Tage>",
  "address": { "contactId": "...", "name": "...", "countryCode": "DE" },
  "lineItems": [...],
  "totalPrice": { "currency": "EUR" },
  "taxConditions": { "taxType": "constructionService13b" | "net" },
  "shippingConditions": { "shippingDate": "<heute>", "shippingType": "service" },
  "title": "Angebot",
  "introduction": "...",
  "remark": "..."
}

vatfree ist organisationsweit gesperrt — nicht verwenden.

Erste LineItem als BV-Header:

{ "type": "text", "name": "BV <Bezeichnung>, <Adresse>", "description": "für oben genanntes Bauvorhaben unterbreiten wir Ihnen folgendes Angebot:" }

Datenpositionen:

{
  "type": "custom",
  "name": "<Kurztitel>",
  "description": "<Detail mit Art.-Nr.>",
  "quantity": <Zahl>,
  "unitName": "<Stück|cm|m²|Std|...>",
  "unitPrice": { "currency": "EUR", "netAmount": <Betrag>, "taxRatePercentage": <0|7|19> }
}

Gruppentitel zwischen Positionen: Weitere type: "text"-Items als Untergruppen-Header (z.B. "Kernbohrungen Stahlbeton", "Wandsägen", "Aufwände") — folgt der Excel-Struktur aus Pfad B.

§13b-Hinweis im Remark: "Steuerschuldnerschaft des Leistungsempfängers gem. § 13b Abs. 2 Nr. 4 UStG (Bauleistung)."

Schritt 6 — Deeplink ausgeben

API-Permalinks (app.lexware.io/permalink/...) funktionieren nicht. Korrekt:

https://app.lexware.de/voucher/#/<quotation-id>

Diesen Link selbst zusammenbauen. Für Kontakte gibt es keinen funktionierenden Deeplink — nicht generieren.

Schritt 7 — Cowork: Live-Artefakt

In Cowork zusätzlich ein editierbares Artefakt rendern (Notion-Style, hell, #2383e2 Blau, #fdecc8 Orange für §13b, #0f7b0f Grün für Save-Button). Editierbare Felder via contenteditable (KEIN prompt() — Sandbox blockt das). Save-Button ruft window.cowork.callMcpTool("lexoffice_create-quotation", {...}). Im create_artifact-Call muss mcp_tools das Tool enthalten.

Detail-Spec siehe references/cowork-artefakt.md.

Pfad B: LV-PDF → Excel/Artefakt → Angebot

B1 — PDF lesen, Positionen extrahieren

PDF mit pdf-reading-Skill öffnen. Aus jeder LV-Position folgende Felder extrahieren:

Mehrseitige LVs: Reihenfolge der Positionen beibehalten. Gruppenüberschriften (z.B. "Titel 2.1 Kernbohrungen Stahlbeton") als Excel-Gruppentitel übernehmen — nicht ignorieren.

B2 — Artikelstamm laden

= Schritt 3.

B3 — Mapping LV-Position ↔ Lex-Art-Nr

Für jede LV-Position automatisch passenden Lex-Artikel finden anhand:

• Material (Stahlbeton vs. Mauerwerk)
• Einheit (cm vs. m² vs. Std)
• Größe/Durchmesser (z.B. "D=143-152" → ø152 → 21152)

Mapping-Tabelle in references/lv-mapping.md für die typischen Bezeichnungen aus deutschen LVs.

Bei Positionen ohne sicheres Mapping: Die Lex-Art-Nr leer lassen und in der Excel/dem Artefakt mit gelbem Hintergrund markieren — der User entscheidet.

B4 — Output erzeugen

Cowork: Live-Artefakt mit Tabelle aller Positionen. Detail siehe references/cowork-artefakt.md.

Claude Desktop / Code: Excel-Datei nach exakt dem Format der Referenzdatei erzeugen. Detail-Spec mit Code-Vorlage siehe references/excel-format.md. Über den xlsx-Skill erstellen, mit present_files zurückgeben.

B5 — Bearbeitete Excel einlesen

Wenn der User eine bearbeitete Excel-Datei zurückschickt: Erkennen am Header (Zeile 4: LV-Pos | Bezeichnung | Material | Einheit | EP € | Σ Anzahl | Σ Menge | Σ Wert €) und am BV-Titel in A1.

# Lesen mit data_only=True um berechnete Werte zu bekommen
from openpyxl import load_workbook
wb = load_workbook(path, data_only=True)
ws = wb.active
# A1: BV-Titel; A2: Leistungszeitraum/Untertitel
# Ab Zeile 5: Daten + Gruppentitel (Gruppentitel = nur A gefüllt)
# Ab "Zwischensumme*" in B: Aggregation, ignorieren für LineItems

User-Änderungen interpretieren:

• Geänderte EP-Werte → übernehmen (User kann manuell von Lex-Standard abweichen)
• Geänderte Mengen → übernehmen
• Geänderte/gelöschte Zeilen → übernehmen
• Neue Zeilen → übernehmen, auch wenn ohne LV-Pos
• Kommentare/farbig markierte Felder → User kurz fragen, was er meint

B6–B9

= Schritte 2, 1, 1b, 4, 5, 6 wie bei Pfad A.

Häufige Fehler & Lösungen

Tools (ACADEMY MCP)

• lexoffice_list-contacts / _get-contact / _create-contact / _update-contact
• lexoffice_list-articles (Pflicht vor jedem Angebot)
• lexoffice_create-quotation / _get-quotation
• WebSearch — bei neuem Kontakt
• pdf-reading-Skill / pdf-Skill — PDF-LV einlesen
• xlsx-Skill — Excel erzeugen und lesen
• Cowork: create_artifact mit mcp_tools: ["lexoffice_create-quotation"]

Falls der ACADEMY MCP nicht verfügbar ist: Tools sind im Dimacon MCP MIRANUM unter gleichem Namen.

Referenzen

• references/excel-format.md — exakte Excel-Struktur mit Code-Vorlage (Pfad B4)
• references/cowork-artefakt.md — Live-Artefakt-Spec (Cowork Pfad A & B)
• references/lv-mapping.md — Mapping-Tabelle Standard-LV-Bezeichnungen → Lex-Art-Nr
• scripts/build_lv_excel.py — fertiger Generator für Pfad B (Desktop/Code)
• scripts/read_lv_excel.py — Re-Import bearbeiteter LV-Excel (Pfad B5)