Zum Inhalt springen

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.

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.

Rufen Sie den Endpunkt createRecord mit einem Datensatz vom Typ TRANSACTION auf:

  • Setzen Sie den Operationstyp auf CORRECTION mit data.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"
}
}
]
}
}
}
}
SzenarioAktionAusgestellte Dokumente
Vollständige Stornierung — Duplikat oder stornierte TransaktionGesamtbetrag gutschreibenNur Credit Note
Teilgutschrift — Rückgabe, Rabatt oder ÜberfakturierungNur die betroffenen Positionen oder Beträge gutschreibenNur Credit Note
Korrektur — falsche Daten oder Beträge auf der ursprünglichen RechnungGesamtbetrag gutschreiben, dann korrigiert neu ausstellenCredit Note + neue Rechnung
Zu niedriger Betrag — ursprünglicher Betrag war zu niedrigGesamtbetrag gutschreiben, dann mit korrektem Betrag neu ausstellenCredit Note + neue Rechnung
Falscher Empfänger — Rechnung an den falschen Käufer gesendetGesamtbetrag an den ursprünglichen Empfänger gutschreiben, dann dem richtigen Empfänger in Rechnung stellenCredit Note + neue Rechnung

Verwenden Sie dies, wenn die ursprüngliche Rechnung nie hätte ausgestellt werden sollen (Duplikat, stornierter Auftrag). Wurde sie an den falschen Käufer gesendet, siehe Falscher Empfänger.

Ursprüngliche Rechnung INV-001 €6300.00
↓
Credit Note CN-001 €6300.00 (referenziert INV-001)
↓
Nettoresultat: €0.00

Die ursprüngliche Rechnung bleibt im System. Die Credit Note erstellt eine vollständige Stornierung.

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.00

Nur die gutgeschriebenen Positionen werden in die Credit Note aufgenommen. Die ursprüngliche Rechnung bleibt für alle nicht gutgeschriebenen Positionen gültig.

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.00

Stornieren 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.00

Verwenden Sie dies, wenn die Rechnung an den falschen Empfänger gesendet wurde.

Ursprüngliche Rechnung INV-056 €119.00 (an den falschen Empfänger gesendet)
↓
Credit Note CN-012 €119.00 (referenziert INV-056, derselbe Empfänger wie INV-056)
↓
Neue Rechnung INV-057 €119.00 (richtiger Empfänger)

Die Credit Note storniert die ursprüngliche Rechnung vollständig. Sie geht an denselben Empfänger wie die ursprüngliche Rechnung, also an den falschen, denn an ihn war die Rechnung adressiert. Stellen Sie anschließend dem richtigen Empfänger eine neue Rechnung mit einer neuen Rechnungsnummer aus.

Bei Korrektur, zu niedrigem Betrag und falschem Empfänger sind zwei separate Transaktionen erforderlich:

  1. Erstellen Sie einen CORRECTION-Datensatz (Credit Note) mit Referenz auf die ursprüngliche Rechnung
  2. Erstellen Sie einen neuen INVOICE-Datensatz mit den korrigierten Daten

Beide Datensätze folgen dem Standard-INTENTION → TRANSACTION-Ablauf.

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.

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", ... }
}
}
}

Die Credit Note muss denselben Empfänger verwenden wie die ursprüngliche Rechnung: dieselben Empfängerdaten, denselben Zustellkanal (invoicing.type), dieselbe E-Mail-Adresse bzw. Peppol-ID und dasselbe invoicing.format.

Weicht etwas ab, wird die Anfrage trotzdem angenommen und der Record ist COMPLETED, es wird aber nichts versendet. Der Record erhält in content.logs einen ERROR-Log: invoice correction recipients do not match the original invoice. Prüfen Sie die Logs jeder Credit Note, die Sie erstellen.

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.

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.

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.number wird 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 über operation.record.id hergestellt.
  • entries[].data.text wird nicht validiert und muss den Wortlaut der Originalrechnung nicht wiederholen.

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 referenziert immer eine Rechnung, niemals eine andere Credit Note. Ein CORRECTION auf eine Credit Note ist nicht möglich: Die Anfrage schlägt mit 405 fehl. Eine Credit Note lässt sich nur durch eine neue Rechnung aufheben, die sie referenziert.

Muss eine Credit Note selbst korrigiert werden, stellen Sie stattdessen ein neues Dokument aus. Welches, hängt davon ab, was falsch war:

Was falsch warAktionAusgestellte Dokumente
Zu wenig gutgeschriebenDen fehlenden Betrag gutschreibenEine weitere Credit Note, die die Originalrechnung referenziert
Zu viel gutgeschrieben oder irrtümlich ausgestelltDie Differenz in Rechnung stellenNeue Rechnung, die die Credit Note referenziert
Falsche Daten auf der Credit NoteDen Betrag der Credit Note in Rechnung stellen, dann korrekt erneut gutschreibenNeue Rechnung, die die Credit Note referenziert + neue Credit Note, die die Originalrechnung referenziert
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.00

Zu 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.00

Bei einer irrtümlich ausgestellten Credit Note lautet die neue Rechnung über den vollen Betrag 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.00

Die 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“
  • Deutschland: Daten, die auf jeder Credit Note erneut zu senden sind, und wie Erstattungen in payments dargestellt werden. Siehe Deutschland: Credit Notes.