M4 runs
The M4 part of the recording session: receipts, reconciliation, exports
and e-invoices, about 30 minutes. Run it on the same trial account after
step 3. The M4 probes
(m4-*-probes.ts) and the M4 lifecycle scenario need a little more preparation.
What to prepare
- Company data (Einstellungen → Unternehmen): street, zip, city, IBAN and BIC, contact
e-mail and phone, Steuernummer or USt-IdNr. sevDesk needs them to finalize an e-invoice; the
probe
write-einvoice-xmlnames the emptyGET /SevClientfields whensendByrefuses. Fake values are fine (Musterfirma, a test IBAN such asDE02120300000000202051). - DATEV export configuration (accountant number, client number, start of the fiscal year).
Without it sevDesk refuses the export job. Either enter fake values in the web app (DATEV
settings) or let the opt-in probe
write-export-datev-configset accountant 1001, client 1 and 1 January; it checks first that the account looks like a fresh trial and refuses otherwise. - Nothing for reconciliation. sevDesk refuses hand-made transactions on offline accounts and
cash registers (422 "You can only create transactions on online checkaccounts", recorded
2026-11-08). The probes and the M4 scenario therefore create one tagged file-import bank
account per run (
POST /CheckAccount/Factory/fileImportAccount, namedMCP-E2E … Import, type CSV, default booking account) and enter their test transactions there. It is in the cleanup list; delete it in the web app at the end. - The booking accounts come from ReceiptGuidance (SKR04 6815 Bürobedarf with tax rule 9 at 19 %, 4400 with rule 1, or the first account that fits), so a standard chart of accounts needs no setup.
Runs, in this order
export SEVDESK_API_TOKEN_FILE=~/.config/sevdesk-trial.tokenW="SEVDESK_LIVE_I_UNDERSTAND_WRITES=1"# 1. Read-only: SevClient keys, AccountDatev paging, CSV exports, transaction 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. Writes: vouchers (upload, save, update, delete, finalize, payments, reset), transactions on# the file-import account (create, split, booking types, private), the DATEV job (refused# without a configuration), a ZUGFeRD receipt; then the reads that now have data.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: a fake DATEV configuration, then the export job again (job id, progress, the# download link's host and expiry format, the ZIP's entry names).env $W pnpm probe --allow-writes --only write-export-datev-config,write-export-datev-csv \ --out probe-report-m4-datev.md# 4. Opt-in, after the company data (step 1 above): one e-invoice, FINALIZED (it cannot be# deleted). Attaches the scrubbed getXml answer to the report as a fixture candidate; after# a review it goes to test/fixtures/einvoice/sevdesk/ (see the README there).env $W pnpm probe --allow-writes --only write-einvoice-xml --out probe-report-m4-einvoice.md# 5. Fixtures (read-only), then the live checks and the scenarios (M3 and M4).pnpm fixtures:recordpnpm test:liveSEVDESK_LIVE_LIFECYCLE=1 SEVDESK_LIVE_I_UNDERSTAND_WRITES=1 pnpm test:liveBehind a filtering proxy the DATEV download also needs the S3 host that jobDownloadInfo names
(the probe report states it); the probe fetches the ZIP without credentials.
What the M4 runs create and how they stay safe
- Generated files only: one-page PDFs and a 1×1 PNG with the run tag, and a minimal Factur-X PDF (EN 16931 CII inside). Never upload real receipts.
- Vouchers (drafts, open, paid and reset ones; the scenario deletes its own draft), transactions on the file-import account (status 100 again after the resets), finalized invoices for the booking probes, one contact, the file-import account. All tagged and in the cleanup list.
saveVoucherfor anything but a draft (status 50) needs thecommittier; the client refuses it otherwise. Bookings, resets and transaction status changes arecommitas well.- The DATEV job is a
POST(the spec's GET answers 500 "wrong HTTP Type"), never withenshrineDocuments; the XML job is never started. The report keeps only the download link's host and the expiry format; ZIP entry names have long digit runs (accountant and client numbers) masked. Neither the ZIP nor the link is ever written to the repository. - CSV exports: only the header row reaches the report (the evidence keeps the first line of a non-JSON body), never data rows.
read-sevclient-keysshows only key names, booleans,0/1flags and short codes, never names, addresses, IBAN or numbers.- The e-invoice fixture candidate is scrubbed by a structure-keeping XML scrubber (element names,
codes, amounts, dates and the BT-24 profile stay; names, addresses, contact data, bank and tax ids,
document numbers and free text become fakes; embedded files become a placeholder) and once more
by the report's scrubber. It has no XML declaration: add
<?xml version="1.0" encoding="UTF-8"?>back when it becomes a fixture. - The M4 scenario's local folders (
SEVDESK_FILE_DIRSwith the generated PDFs,SEVDESK_OUTPUT_DIRfor the DATEV ZIP) are temporary and removed at the end.
What to commit from M4
- New recordings:
meta/sev-client.json,banking/transaction-by-id.json,banking/transaction-log.json,banking/transaction-log-unfiltered.json,vouchers/voucher-positions-embed-account.json(after the review). - The e-invoice fixture candidate, after review, as a fixture with
_provenance(sourcerecorded, the date, the probe id) and the declaration added back. - Findings in
spec/deviations.md(probe ids as the source). - Never: export ZIPs or CSVs, the presigned link, uploaded test files, the probe reports' raw answers outside the scrubbed reports.