Credit Note

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.

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

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   €6.300
     ↓
Credit Note               CN-001    €6.300  (referenziert INV-001)
     ↓
Nettoresultat: €0

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

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   €6.300
     ↓
Credit Note               CN-002    €600    (referenziert INV-001, nur betroffene Positionen)
     ↓
Nettoresultat: €5.700

Nur 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)

Verwenden Sie dies, wenn die ursprüngliche Rechnung falsche Daten oder Beträge enthielt.

Ursprüngliche Rechnung   INV-001   €6.300
     ↓
Credit Note               CN-003    €6.300  (vollständige Stornierung, referenziert INV-001)
     ↓
Neue Rechnung            INV-002   €5.950  (korrigierte Daten)
     ↓
Nettoresultat: €5.950

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)

Verwenden Sie dies, wenn der ursprüngliche Rechnungsbetrag zu niedrig war.

Ursprüngliche Rechnung   INV-001   €5.000
     ↓
Credit Note               CN-004    €5.000  (vollständige Stornierung, referenziert INV-001)
     ↓
Neue Rechnung            INV-003   €6.300  (korrekter Betrag)
     ↓
Nettoresultat: €6.300

Regeln

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.

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

Der Empfänger der Credit Note muss mit dem Empfänger der ursprünglichen Rechnung übereinstimmen.

Separate Nummerierungsreihe

Credit Notes müssen eine separate fortlaufende Nummerierungsreihe verwenden (z. B. CN-2026-000001). Geben Sie diese über das Feld series an, genauso wie bei Standardrechnungen.

Positionstyp

Jede gutgeschriebene Position verwendet entries[].type = SALE, denselben Positionstyp wie auf einer regulären Rechnung. Der Dokumenttyp — nicht der Positionstyp — signalisiert, dass es sich um Gutschriften handelt.

Der Positionstyp trägt in der E-Rechnungsstellung keine Gutschrift- oder Retouren-Semantik. In Italien wird er bei der Erzeugung der FatturaPA überhaupt nicht gelesen: RETURN — der Wert, den die SIGN-Produkte bei einer Korrektur verwenden — macht das Dokument also nicht zu einer Gutschrift. Das tut ausschließlich der aufgerufene Vorgang.

Positionsfelder, die nicht übereinstimmen müssen

Zwei Felder 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. Anders als bei SIGN IT, wo eine Übereinstimmung erwartet wird, können Sie die gutgeschriebene Position frei beschreiben.

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.

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, verwenden Sie den unten beschriebenen Ablauf „Credit Note + Neuausstellung”: Eine spätere Credit Note referenziert die Ersatzrechnung, nicht die frühere Credit Note.

Rechnungen gutschreiben, die nicht über fiskaly übermittelt wurden

⚠️Extern ausgestellte Rechnungen können nicht gutgeschrieben werden

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.

Dies ergibt sich aus dem aktuellen Design der Unified API und kann sich in einer künftigen Version ändern.

API-Verwendung

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

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

• Setzen Sie den Operationstyp auf CORRECTION mit data.type = INVOICE
• Fügen Sie die vorausgehende Dokumentreferenz zur ursprünglichen Rechnung hinzu
• 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",
          "series": "CN"
        },
        "entries": [
          {
            "type": "SALE",
            "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"
            }
          }
        ]
      }
    }
  }
}

💡Hinweis

Credit Notes werden auf dem E_INVOICE_SERVICE-System erstellt und folgen demselben INTENTION → TRANSACTION-Ablauf wie bei E-Rechnungen.

Credit Note + Neuausstellung

Für Korrektur- und Unterbetragsszenarien 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.