Credit Notes
Overview
Open /credit-notes in the admin app (sidebar Commerce → Credit notes) to see the self-billed credit notes (Gutschriften) Lumio issued for developer payouts, and their cancellations, newest first. Notes of deleted developer profiles stay listed: they are marked Profile deleted and kept for the 8-year retention period. Load more appends the next 50.
Filter by a developer profile ID (UUID) to see one developer's notes; Show all removes the filter.
Card contents
Each card shows the note as issued — an issued note is never edited:
| Part | Content |
|---|---|
| Header | Number (GS-<year>-<6 digits>), Credit note or Cancellation, Cancelled {date} once cancelled, issue date |
| Supplier | Legal name and country copied from the developer's verification at issue |
| Developer profile | The profile ID, or Profile deleted |
| Service period | Start and end (Europe/Berlin) |
| Amounts | Net, VAT with rate, and gross; negative on a cancellation |
| VAT treatment | Germany 19 %, Germany small business (§ 19 UStG), EU reverse charge (§ 13b UStG) or outside the EU |
| When the note was mailed to the developer, or Not sent yet | |
| Cancellation | Reason (payout failed, developer objection, correction), the date the objection arrived, the operator who recorded it, and the payout / cancelled note IDs |
PDF downloads the stored document. While it is still being generated the card says Document is being generated instead.
Cancelling a credit note
Cancel note appears on an effective credit note (not on a cancellation or an already cancelled note). It opens a dialog:
- Choose the reason:
- Developer objection — the developer objected to the note (§ 14 Abs. 2 S. 3 UStG). Enter the date the objection was received.
- Correction — the note carries wrong data, for example an outdated address or tax detail.
- Optionally tick Issue a corrected credit note: Lumio issues a new note for the same payout and period from the developer's current verification.
- Cancel credit note issues the cancellation note (own number, negated amounts) and, if ticked, the corrected note in one step. A confirmation names the new numbers and the list reloads.
The dialog names the reason when it is refused:
| Message | Cause |
|---|---|
| The corrected note would total a different amount than was paid | CREDIT_NOTE_AMOUNT_MISMATCH: for example the developer's VAT status changed. Settle the difference first, or cancel without re-issuing |
| The developer's tax details are incomplete | TAX_DETAILS_REQUIRED on the re-issue. Cancel without re-issuing, or ask the developer to complete them |
| Only an effective credit note can be cancelled | The note was cancelled in the meantime. Reload the list |
| This credit note has no payout to re-issue it for | Re-issue is not possible for this note |
| Enter the date the objection was received | An objection needs its received date |
Every cancellation emits the audit event system:developer_credit_note_cancelled.
Settling payouts
SEPA payouts, and Stripe or PayPal payouts whose answer the payout cycle did not receive, wait for an operator. Mark them paid or failed on the Developer Payouts page. A failed payout cancels its credit note automatically (reason payout failed).
Permissions
| Action | Permission |
|---|---|
| Open the page, download PDFs | billing:read |
| Cancel a credit note | billing:edit |
| List developer payouts | billing:read |
| Mark a developer payout paid or failed | billing:edit |
See Developer Credit Notes for numbering, VAT treatment, delivery and retention.