PPartnerDesk

41 — Gutschriften (§14 UStG)

Aktualisiert am 1. Juni 2026

41 — Gutschriften (§14 UStG)

Jeder approved Payout erzeugt automatisch eine Provisions-Gutschrift als PDF. Die Gutschrift ist konform zu §14 UStG und wird mit dem PDF-Generator DomPDF erzeugt.

Pflichtangaben (§14 UStG)

PartnerDesk fügt alle Pflichtangaben automatisch ein:

  • Aussteller (Tenant): Firmenname, Anschrift, USt-ID (aus Legal-Settings, siehe 94).
  • Empfänger (Partner): Name oder Firma, Anschrift, USt-ID oder Steuernummer.
  • Datum der Ausstellung.
  • Fortlaufende Gutschriftnummer (PA-YYYY-NNNN — pro Tenant durchnummeriert).
  • Leistungsbeschreibung (“Provisionsgutschrift für den Zeitraum X bis Y”).
  • Brutto-, Netto- und MwSt-Betrag (oder Vermerk Kleinunternehmer).
  • Anlage: Einzeltransaktionsnachweis als zweite Seite.

Kleinunternehmer-Handling (§19 UStG)

Wenn der Partner als Kleinunternehmer markiert ist (vat_rate=0):

  • Steuersatz: 0 %.
  • Vermerk auf der Gutschrift: „Gemäß § 19 UStG enthält der ausgewiesene Betrag keine Umsatzsteuer."
  • Bei externer Sync (lexoffice/easybill) wird der entsprechende Schalter im API-Call gesetzt (taxType: 'smallbusiness' bzw. is_small_business: true).

Einzeltransaktionsnachweis

Die zweite Seite listet alle in der Gutschrift enthaltenen Transactions:

  • Datum.
  • Anonymisierte Referenz-ID (erste 4 + letzte 4 Zeichen, z. B. 7c4f-...-9b2a) — Schutz vor versehentlicher Datenleak.
  • Produkt.
  • Brutto- und Provisionsbetrag.

Damit hat der Partner volle Nachvollziehbarkeit, ohne dass Kundendaten oder vollständige Transaction-IDs in das Dokument geraten.

Entwurfs-Modus vs. Final

Solange der Payout im Status draft ist:

  • Vorschau-Endpoint rendert die PDF mit großem „ENTWURF"-Wasserzeichen.
  • Keine Persistierung der PDF — wird bei jedem Aufruf neu generiert.

Beim Approval:

  • Final-PDF (ohne Wasserzeichen) wird einmalig generiert.
  • Speicherung im Flysystem-Storage unter: tenants/{slug}/payouts/{year}/{month}/{docNumber}_{partnerId}.pdf
  • PayoutDocument.pdf_path wird gesetzt.

Logo & Branding

Das Tenant-Logo wird automatisch oben links eingefügt:

  1. Aus Tenant.branding.logoLight (für hellen PDF-Hintergrund).
  2. Fallback logoDark oder logoUrl.
  3. Wenn kein Logo gesetzt: nur Firmenname als Textüberschrift.

Footer ab der zweiten Seite zeigt:

  • Firmenname, Adresse, USt-ID — gesteuert über die Legal-Settings.

Nummernschemas

Default:

PA-2026-0001
PA-2026-0002
...

Konfigurierbar im Admin-Portal → „Einstellungen" → „Gutschrift-Nummern":

  • Prefix (z. B. 4LE- für 4leads).
  • Jahresreset Ja/Nein.
  • Padding (z. B. 4 Stellen).

Bei externer Sync (lexoffice/easybill) wird der externe Provider seine eigene Nummer vergeben — beide werden gespeichert:

  • payout_documents.documentNumber = lokale Nummer.
  • payout_documents.external_document_number = externe Nummer.

Storage-Adapter

Das PDF-Storage ist abstrahiert (Flysystem):

  • Local (Default, Dev und Hetzner): var/storage/documents/.
  • Google Cloud Storage: gcs://...-DSN.
  • AWS S3: s3://...-DSN.

Wechsel ist Config-only.

Details: …/023-tls-flysystem.md.

Re-Generierung

Falls Sie nach Approval einen Inhalt korrigieren mussten (z. B. Adresse des Partners), gibt es im Detail-View einen „PDF neu erstellen"-Button. Die alte PDF wird überschrieben, neue Nummer entsteht nicht.

Achtung: bei bereits versendeter externer Gutschrift in lexoffice/easybill muss diese ggf. dort manuell aktualisiert werden — die externe API-Sync läuft nur beim Approval.

Partner-Download

Partner laden ihre Gutschriften unter „Auszahlungen" → einzelner Eintrag → PDF-Button herunter.

Compliance

PartnerDesk implementiert die §14-UStG-Anforderungen vollständig automatisch. Sie sind dennoch dafür verantwortlich, dass:

  • Die Stammdaten im Tenant (Firma, USt-ID, Adresse) korrekt sind.
  • Partner-Steuerdaten (Adresse, USt-ID oder Kleinunternehmer-Flag) korrekt gepflegt sind.

Bei Unsicherheiten zu steuerrechtlichen Details: Steuerberater konsultieren.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (DocumentGenerator), ../023-tls-flysystem.md (Storage-Abstraktion), ../015-outgoing-credit-notes.md