Um eine zuvor übermittelte E-Rechnung zu korrigieren, stellen Sie eine Credit Note mit dem Operationstyp CORRECTION und data.type = INVOICE aus. Eine Credit Note storniert die Beträge der ursprünglichen Rechnung — vollständig oder teilweise. Wenn die ursprünglichen Daten ebenfalls ersetzt werden müssen, wird nach der Credit Note eine neue Rechnung ausgestellt.
Die Credit Note referenziert immer die ursprüngliche Rechnung und muss an denselben Empfänger gesendet werden.
API-Verwendung
INTENTION und TRANSACTION, mit Beispielanfrage.
Wann eine Credit Note ausgestellt werden soll
Stornierung, Teilgutschrift, Korrektur oder zu niedriger Betrag.
Korrektur-Workflows
Der Ablauf für jedes Szenario.
Regeln
Beträge, Referenzen, Nummerierung und Positionstyp.
API-Verwendung
Abschnitt betitelt „API-Verwendung“INTENTION
Abschnitt betitelt „INTENTION“Der INTENTION-Schritt folgt demselben Muster wie bei einer Standardrechnung. Rufen Sie den Endpunkt createRecord mit einem Datensatz vom Typ INTENTION auf, der mit dem E_INVOICE_SERVICE-System verknüpft ist.
TRANSACTION
Abschnitt betitelt „TRANSACTION“Rufen Sie den Endpunkt createRecord mit einem Datensatz vom Typ TRANSACTION auf:
- Setzen Sie den Operationstyp auf
CORRECTIONmitdata.type = INVOICE - Referenzieren Sie die ursprüngliche Rechnung über
operation.record.id - Fügen Sie die gutgeschriebenen Positionen hinzu (mit positiven Beträgen)
- Verwenden Sie denselben Empfänger wie bei der ursprünglichen Rechnung
Beispielanfrage — Teilgutschrift
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-invoice-transaction-record-id>" }, "data": { "type": "INVOICE", "document": { "number": "CN-2026-000001" }, "entries": [ { "type": "RETURN", "details": { "concept": "GOOD" }, "data": { "type": "ITEM", "text": "White sugar", "unit": { "quantity": "1.00", "price": { "inclusive": "1220.00", "exclusive": "1000.00" } }, "value": { "base": "1000.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } } } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } ], "totals": { "vat": { "amount": "220.00", "exclusive": "1000.00", "inclusive": "1220.00" } }, "recipients": [ { "type": "BUSINESS", "name": "Dolci Italiani S.r.l.", "identification": { "type": "VAT", "value": "IT12345678901" }, "address": { "street": "Via Roma 1", "city": "Milano", "code": "20121", "region": "MI", "country": "IT" }, "invoicing": { "type": "SDI", "destination_code": "ABC1234" } } ] } } }}Credit Notes werden auf dem E_INVOICE_SERVICE-System erstellt und folgen demselben INTENTION → TRANSACTION-Ablauf wie bei E-Rechnungen.
Wann eine Credit Note ausgestellt werden soll
Abschnitt betitelt „Wann eine Credit Note ausgestellt werden soll“| Szenario | Aktion | Ausgestellte Dokumente |
|---|---|---|
| Vollständige Stornierung — Duplikat, falscher Käufer oder stornierte Transaktion | Gesamtbetrag gutschreiben | Nur Credit Note |
| Teilgutschrift — Rückgabe, Rabatt oder Überfakturierung | Nur die betroffenen Positionen oder Beträge gutschreiben | Nur Credit Note |
| Korrektur — falsche Daten oder Beträge auf der ursprünglichen Rechnung | Gesamtbetrag gutschreiben, dann korrigiert neu ausstellen | Credit Note + neue Rechnung |
| Zu niedriger Betrag — ursprünglicher Betrag war zu niedrig | Gesamtbetrag gutschreiben, dann mit korrektem Betrag neu ausstellen | Credit Note + neue Rechnung |
Korrektur-Workflows
Abschnitt betitelt „Korrektur-Workflows“Vollständige Stornierung
Abschnitt betitelt „Vollständige Stornierung“Verwenden Sie dies, wenn die ursprüngliche Rechnung nie hätte ausgestellt werden sollen (Duplikat, falscher Käufer, stornierter Auftrag).
Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (referenziert INV-001) ↓Nettoresultat: €0.00Die ursprüngliche Rechnung bleibt im System. Die Credit Note erstellt eine vollständige Stornierung.
Teilgutschrift
Abschnitt betitelt „Teilgutschrift“Verwenden Sie dies, wenn nur ein Teil der ursprünglichen Rechnung storniert werden muss (zurückgegebener Artikel, vereinbarter Rabatt, Überfakturierung auf bestimmten Positionen).
Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-002 €600.00 (referenziert INV-001, nur betroffene Positionen) ↓Nettoresultat: €5700.00Nur die gutgeschriebenen Positionen werden in die Credit Note aufgenommen. Die ursprüngliche Rechnung bleibt für alle nicht gutgeschriebenen Positionen gültig.
Korrektur (Credit Note + Neuausstellung)
Abschnitt betitelt „Korrektur (Credit Note + Neuausstellung)“Verwenden Sie dies, wenn die ursprüngliche Rechnung falsche Daten oder Beträge enthielt.
Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-003 €6300.00 (vollständige Stornierung, referenziert INV-001) ↓Neue Rechnung INV-002 €5950.00 (korrigierte Daten) ↓Nettoresultat: €5950.00Stornieren Sie die ursprüngliche Rechnung vollständig über eine Credit Note und stellen Sie dann eine neue Rechnung mit den korrekten Daten aus.
Zu niedriger Betrag (Credit Note + höhere Neuausstellung)
Abschnitt betitelt „Zu niedriger Betrag (Credit Note + höhere Neuausstellung)“Verwenden Sie dies, wenn der ursprüngliche Rechnungsbetrag zu niedrig war.
Ursprüngliche Rechnung INV-001 €5000.00 ↓Credit Note CN-004 €5000.00 (vollständige Stornierung, referenziert INV-001) ↓Neue Rechnung INV-003 €6300.00 (korrekter Betrag) ↓Nettoresultat: €6300.00Credit Note + Neuausstellung
Abschnitt betitelt „Credit Note + Neuausstellung“Für Korrektur- und Unterbetragsszenarien sind zwei separate Transaktionen erforderlich:
- Erstellen Sie einen
CORRECTION-Datensatz (Credit Note) mit Referenz auf die ursprüngliche Rechnung - Erstellen Sie einen neuen
INVOICE-Datensatz mit den korrigierten Daten
Beide Datensätze folgen dem Standard-INTENTION → TRANSACTION-Ablauf.
Beträge müssen positiv sein
Abschnitt betitelt „Beträge müssen positiv sein“Alle Beträge auf einer Credit Note müssen positiv sein. Der Dokumenttyp signalisiert, dass positive Positionsbeträge Credit Notes darstellen. Negative Werte führen zu Validierungsfehlern. Stellen Sie eine Credit Note immer als CORRECTION aus. Eine INVOICE mit negativen Beträgen ist keine Credit Note.
Vorausgehende Dokumentreferenz ist erforderlich
Abschnitt betitelt „Vorausgehende Dokumentreferenz ist erforderlich“Jede Credit Note referenziert die ursprüngliche Rechnung. Geben Sie im CORRECTION::INVOICE-Request die ID des ursprünglichen Transaktionsdatensatzes im Feld content.operation.record.id an. fiskaly löst die Details des vorausgehenden Dokuments automatisch auf.
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-transaction-record-id>" }, "data": { "type": "INVOICE", ... } } }}Empfänger muss übereinstimmen
Abschnitt betitelt „Empfänger muss übereinstimmen“Verwenden Sie denselben Empfänger wie auf der ursprünglichen Rechnung, mit demselben Zustellkanal und Format.
Separate Nummerierungsreihe
Abschnitt betitelt „Separate Nummerierungsreihe“Credit Notes müssen eine separate fortlaufende Nummerierungsreihe verwenden (z. B. CN-2026-000001). Nehmen Sie das Präfix der Reihe in document.number auf und lassen Sie document.series leer.
Positionstyp
Abschnitt betitelt „Positionstyp“Den Dokumenttyp setzen Sie nicht selbst: Er wird aus der aufgerufenen Unified-API-Operation abgeleitet. Eine CORRECTION erzeugt eine Gutschrift, eine INVOICE eine Rechnung — unabhängig vom Positionstyp.
Setzen Sie bei jeder gutgeschriebenen Position entries[].type = RETURN, mit positiven Beträgen. Die Positionen der ursprünglichen Rechnung verwenden SALE.
Um neue Positionen zu berechnen, stellen Sie eine separate Rechnung aus.
Positionsfelder, die nicht übereinstimmen müssen
Abschnitt betitelt „Positionsfelder, die nicht übereinstimmen müssen“Zwei Felder in entries[] verursachen bei Gutschriften häufig unnötigen Aufwand:
entries[].details.numberwird in der E-Rechnungsstellung nicht verwendet. Es existiert für die Fiskalisierungsprodukte, wo es die zu korrigierende Originalposition identifiziert. Sie übertragen keine ursprünglichen Positionsnummern auf eine Gutschrift — die Verbindung zur Originalrechnung wird einmalig auf Dokumentebene überoperation.record.idhergestellt.entries[].data.textwird nicht validiert und muss den Wortlaut der Originalrechnung nicht wiederholen.
Eine Rechnung, mehrere Credit Notes
Abschnitt betitelt „Eine Rechnung, mehrere Credit Notes“Mehrere Credit Notes können sich auf dieselbe Originalrechnung beziehen — etwa wenn Waren aus einer Rechnung in mehreren Teilmengen zurückgegeben werden oder verschiedene Positionen zu unterschiedlichen Zeitpunkten gutgeschrieben werden. Jede ist ein eigenständiger CORRECTION-Record mit derselben operation.record.id, der nur die jeweils gutgeschriebenen Positionen enthält. Die Originalrechnung bleibt für die nicht gutgeschriebenen Positionen gültig. Stellen Sie sicher, dass die Credit Notes zu einer Rechnung zusammen nicht mehr ergeben als die Rechnung. Eine Credit Note, die durch eine neue Rechnung aufgehoben wurde, zählt dabei nicht mehr mit.
Eine Credit Note wird nie gutgeschrieben
Abschnitt betitelt „Eine Credit Note wird nie gutgeschrieben“Eine Credit Note referenziert immer eine Rechnung, niemals eine andere Credit Note. Muss eine Credit Note selbst korrigiert werden, stellen Sie stattdessen ein neues Dokument aus. Welches, hängt davon ab, was falsch war:
| Was falsch war | Aktion | Ausgestellte Dokumente |
|---|---|---|
| Zu wenig gutgeschrieben | Den fehlenden Betrag gutschreiben | Eine weitere Credit Note, die die Originalrechnung referenziert |
| Zu viel gutgeschrieben oder irrtümlich ausgestellt | Die Differenz in Rechnung stellen | Neue Rechnung, die die Credit Note referenziert |
| Falsche Daten auf der Credit Note | Den Betrag der Credit Note in Rechnung stellen, dann korrekt erneut gutschreiben | Neue Rechnung, die die Credit Note referenziert + neue Credit Note, die die Originalrechnung referenziert |
Zu wenig gutgeschrieben
Abschnitt betitelt „Zu wenig gutgeschrieben“Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-001 €300.00 (referenziert INV-001, hätte €600.00 sein müssen) ↓Credit Note CN-002 €300.00 (referenziert INV-001, der fehlende Betrag) ↓Nettoresultat: €5700.00Zu viel gutgeschrieben oder irrtümlich ausgestellt
Abschnitt betitelt „Zu viel gutgeschrieben oder irrtümlich ausgestellt“Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (referenziert INV-001, hätte €600.00 sein müssen) ↓Neue Rechnung INV-002 €5700.00 (referenziert CN-001, die Differenz) ↓Nettoresultat: €5700.00Bei einer irrtümlich ausgestellten Credit Note lautet die neue Rechnung über den vollen Betrag der Credit Note.
Falsche Daten auf der Credit Note
Abschnitt betitelt „Falsche Daten auf der Credit Note“Ursprüngliche Rechnung INV-001 €6300.00 ↓Credit Note CN-001 €600.00 (referenziert INV-001, falsche Daten) ↓Neue Rechnung INV-002 €600.00 (referenziert CN-001, hebt sie auf) ↓Credit Note CN-002 €600.00 (referenziert INV-001, korrekte Daten) ↓Nettoresultat: €5700.00Die neue Rechnung trägt die Nummer und das Ausstellungsdatum der Credit Note, die sie aufhebt, in document.references.preceding_document.
Rechnungen gutschreiben, die nicht über fiskaly übermittelt wurden
Abschnitt betitelt „Rechnungen gutschreiben, die nicht über fiskaly übermittelt wurden“Der Dokumenttyp wird aus dem Vorgang abgeleitet und nicht von Ihnen gesetzt: Eine CORRECTION erzeugt eine Gutschrift, eine INVOICE eine Rechnung. Wenn Sie eine extern ausgestellte Rechnung als vorangehendes Dokument einer INVOICE referenzieren, wird zwar erfolgreich übermittelt — das Dokument trägt aber den Typ Rechnung und erhöht damit den geschuldeten Betrag, anstatt ihn auszugleichen.
Wenn Sie zu fiskaly migrieren, halten Sie Ihr bisheriges E-Rechnungssystem so lange verfügbar, bis jede dort ausgestellte Rechnung beglichen oder gutgeschrieben ist. Wo eine einmalige Korrektur unvermeidbar ist, erlauben manche Steuerbehörden Händlern, eine Gutschrift manuell außerhalb ihres Anbieters auszustellen — Verfügbarkeit und Ablauf unterscheiden sich je Land, prüfen Sie daher die Länderseite.