Zum Inhalt springen

M4-Läufe

Der M4-Teil der Aufnahmesitzung: Belege, Zuordnung, Exporte und E-Rechnungen, etwa 30 Minuten. Führe ihn auf demselben Testkonto nach Schritt 3 aus. Die M4-Proben (m4-*-probes.ts) und das M4-Lebenszyklus-Szenario brauchen etwas mehr Vorbereitung.

Was du vorbereitest 

  1. Firmendaten (Einstellungen → Unternehmen): Straße, PLZ, Ort, IBAN und BIC, Kontakt-E-Mail und Telefon, Steuernummer oder USt-IdNr. sevDesk braucht sie, um eine E-Rechnung fertigzustellen; die Probe write-einvoice-xml nennt die leeren Felder von GET /SevClient, wenn sendBy ablehnt. Erfundene Werte reichen (Musterfirma, eine Test-IBAN wie DE02120300000000202051).
  2. DATEV-Exportkonfiguration (Beraternummer, Mandantennummer, Beginn des Wirtschaftsjahrs). Ohne sie lehnt sevDesk den Exportjob ab. Trage entweder erfundene Werte in der Web-App ein (DATEV-Einstellungen) oder lass die Opt-in-Probe write-export-datev-config Berater 1001, Mandant 1 und den 1. Januar setzen; sie prüft vorher, dass das Konto wie ein frisches Testkonto aussieht, und lehnt sonst ab.
  3. Nichts für die Zuordnung. sevDesk lehnt von Hand angelegte Kontoumsätze auf Offline-Konten und Kassen ab (422 „You can only create transactions on online checkaccounts“, aufgezeichnet am 2026-11-08). Die Proben und das M4-Szenario legen deshalb je Lauf ein markiertes Bankkonto für Dateiimporte an (POST /CheckAccount/Factory/fileImportAccount, Name MCP-E2E … Import, Typ CSV, Standard-Buchungskonto) und tragen ihre Test-Kontoumsätze dort ein. Es steht in der Aufräumliste; lösche es am Ende in der Web-App.
  4. Die Buchungskonten kommen aus ReceiptGuidance (SKR04 6815 Bürobedarf mit Steuerregel 9 bei 19 %, 4400 mit Regel 1 oder das erste passende Konto), ein Standard-Kontenrahmen braucht also keine Einrichtung.

Läufe, in dieser Reihenfolge 

export SEVDESK_API_TOKEN_FILE=~/.config/sevdesk-trial.tokenW="SEVDESK_LIVE_I_UNDERSTAND_WRITES=1"# 1. Nur lesend: Schlüssel von SevClient, Paging von AccountDatev, CSV-Exporte, Umsatz-Log.pnpm probe --only read-sevclient-keys,read-account-datev-paging,read-export-csv,read-transaction-log,read-voucher-pos-account-datev \  --out probe-report-m4-read.md# 2. Schreibend: Belege (Upload, speichern, aktualisieren, löschen, fertigstellen, Zahlungen,#    zurücksetzen), Kontoumsätze auf dem Dateiimport-Konto (anlegen, aufteilen, Buchungsarten,#    privat), der DATEV-Job (ohne Konfiguration abgelehnt), ein ZUGFeRD-Beleg; dann die#    Leseproben, die jetzt Daten haben.env $W pnpm probe --allow-writes --only write-voucher-upload-temp-file,write-voucher-save-with-file,write-voucher-net-gross,write-voucher-open-directly,write-voucher-update-draft,write-voucher-invalid-account-rule,write-voucher-revenue,write-voucher-delete,write-voucher-finalize,write-voucher-book-amount,write-voucher-reset,write-transaction-create,write-transaction-split-booking,write-transaction-split-variants,write-transaction-private-status,write-export-datev-csv,write-voucher-zugferd-upload,read-transaction-log,read-sevclient-keys,read-account-datev-paging,read-voucher-pos-account-datev,read-export-csv,read-voucher-document-key,read-transaction-date-filters,read-transaction-status-filter,read-update-after,read-list-defaults \  --out probe-report-m4-write.md# 3. Opt-in: eine erfundene DATEV-Konfiguration, dann noch einmal der Exportjob (Job-ID,#    Fortschritt, Host und Ablaufformat des Download-Links, die Eintragsnamen im ZIP).env $W pnpm probe --allow-writes --only write-export-datev-config,write-export-datev-csv \  --out probe-report-m4-datev.md# 4. Opt-in, nach den Firmendaten (Schritt 1 oben): eine E-Rechnung, FERTIGGESTELLT (sie lässt#    sich nicht löschen). Hängt die bereinigte Antwort von getXml als Fixture-Kandidat an den#    Bericht an; nach einer Prüfung kommt sie nach test/fixtures/einvoice/sevdesk/ (siehe die#    README dort).env $W pnpm probe --allow-writes --only write-einvoice-xml --out probe-report-m4-einvoice.md# 5. Fixtures (nur lesend), dann die Live-Prüfungen und die Szenarien (M3 und M4).pnpm fixtures:recordpnpm test:liveSEVDESK_LIVE_LIFECYCLE=1 SEVDESK_LIVE_I_UNDERSTAND_WRITES=1 pnpm test:live

Hinter einem filternden Proxy braucht der DATEV-Download zusätzlich den S3-Host, den jobDownloadInfo nennt (der Probe-Bericht gibt ihn an); die Probe lädt das ZIP ohne Zugangsdaten herunter.

Was die M4-Läufe anlegen und wie sie sicher bleiben 

  • Nur erzeugte Dateien: einseitige PDFs und ein 1×1-PNG mit dem Lauf-Tag sowie ein minimales Factur-X-PDF (mit EN 16931 CII darin). Lade nie echte Belege hoch.
  • Belege (Entwürfe, offene, bezahlte und zurückgesetzte; das Szenario löscht seinen eigenen Entwurf), Kontoumsätze auf dem Dateiimport-Konto (nach den Zurücksetzungen wieder Status 100), fertiggestellte Rechnungen für die Buchungsproben, ein Kontakt, das Dateiimport-Konto. Alles markiert und in der Aufräumliste.
  • saveVoucher für alles außer einem Entwurf (Status 50) braucht die Stufe commit; sonst lehnt der Client es ab. Buchungen, Zurücksetzungen und Statusänderungen von Kontoumsätzen sind ebenfalls commit.
  • Der DATEV-Job ist ein POST (das GET der Spezifikation antwortet 500 „wrong HTTP Type“), nie mit enshrineDocuments; der XML-Job wird nie gestartet. Der Bericht behält vom Download-Link nur den Host und das Ablaufformat; in den Eintragsnamen des ZIP sind lange Ziffernfolgen (Berater- und Mandantennummer) maskiert. Weder das ZIP noch der Link landen je im Repository.
  • CSV-Exporte: Nur die Kopfzeile erreicht den Bericht (die Nachweise behalten die erste Zeile eines Bodys, der kein JSON ist), nie Datenzeilen.
  • read-sevclient-keys zeigt nur Schlüsselnamen, Booleans, 0/1-Flags und kurze Codes, nie Namen, Adressen, IBAN oder Nummern.
  • Der Fixture-Kandidat der E-Rechnung wird von einem strukturerhaltenden XML-Bereiniger bereinigt (Elementnamen, Codes, Beträge, Daten und das Profil BT-24 bleiben; Namen, Adressen, Kontaktdaten, Bank- und Steuer-IDs, Belegnummern und Freitext werden zu Fälschungen; eingebettete Dateien werden zu einem Platzhalter) und noch einmal vom Bereiniger des Berichts. Er hat keine XML-Deklaration: Ergänze <?xml version="1.0" encoding="UTF-8"?> wieder, wenn er zur Fixture wird.
  • Die lokalen Ordner des M4-Szenarios (SEVDESK_FILE_DIRS mit den erzeugten PDFs, SEVDESK_OUTPUT_DIR für das DATEV-ZIP) sind temporär und werden am Ende entfernt.

Was du aus M4 committest 

  • Neue Aufzeichnungen: meta/sev-client.json, banking/transaction-by-id.json, banking/transaction-log.json, banking/transaction-log-unfiltered.json, vouchers/voucher-positions-embed-account.json (nach der Prüfung).
  • Den Fixture-Kandidaten der E-Rechnung, nach der Prüfung, als Fixture mit _provenance (Quelle recorded, das Datum, die Probe-ID) und mit wieder ergänzter Deklaration.
  • Befunde in spec/deviations.md (Probe-IDs als Quelle).
  • Nie: Export-ZIPs oder -CSVs, den vorsignierten Link, hochgeladene Testdateien, die rohen Antworten der Probe-Berichte außerhalb der bereinigten Berichte.