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
- 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-xmlnennt die leeren Felder vonGET /SevClient, wennsendByablehnt. Erfundene Werte reichen (Musterfirma, eine Test-IBAN wieDE02120300000000202051). - 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-configBerater 1001, Mandant 1 und den 1. Januar setzen; sie prüft vorher, dass das Konto wie ein frisches Testkonto aussieht, und lehnt sonst ab. - 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, NameMCP-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. - 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:liveHinter 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.
saveVoucherfür alles außer einem Entwurf (Status 50) braucht die Stufecommit; sonst lehnt der Client es ab. Buchungen, Zurücksetzungen und Statusänderungen von Kontoumsätzen sind ebenfallscommit.- Der DATEV-Job ist ein
POST(das GET der Spezifikation antwortet 500 „wrong HTTP Type“), nie mitenshrineDocuments; 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-keyszeigt 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_DIRSmit den erzeugten PDFs,SEVDESK_OUTPUT_DIRfü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(Quellerecorded, 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.