Apps & connections
Gutschrift erstellen
ONE LOOP: Die Action Create Credit Note erstellt nach einer erfolgreichen Rückerstattung eine finalisierte Gutschrift in Lexware Office.
Die Action Create Credit Note erstellt nach einer erfolgreichen Rückerstattung eine finalisierte Gutschrift in Lexware Office.
Stand 7. November 2026: Lexware Office Connector 9.2.0 ist privat live; vier Dokument-Actions und beide Trigger wurden im freigegebenen ONE LOOP Teststand geprüft. Der Zahlungstrigger 1.5 ist veröffentlicht. Version 9.3.0 befindet sich in öffentlicher Prüfung; eine allgemeine öffentliche Freigabe oder ein kostenpflichtiger Neukundenabschluss ist noch nicht bestätigt.
Empfohlener Ablauf
Den nativen Trigger Refund mit Filter Status = Successful verwenden.
Direkt danach Create Credit Note einfügen.
Alle sechs Werte aus dem Trigger mappen.
Nach Erfolg Nummer und PDF-URL weiterverwenden.
Die Action führt selbst keine Geldbewegung aus. Die Rückerstattung muss bereits erfolgreich erfolgt sein.
Alle sichtbaren Felder
Feld / Referenz | Pflicht | Format | Bedeutung |
|---|---|---|---|
Transaction ID / | Ja | ID aus dem Rückerstattungs-Trigger | Ordnet die Rückerstattung der ursprünglichen Zahlung und Rechnung zu. |
Refund ID / | Ja | Stabile ID aus dem Rückerstattungs-Trigger | Dauerhafter Deduplizierungsschlüssel: dieselbe ID erzeugt höchstens eine Gutschrift. |
Refund Amount / | Ja | EUR-Betrag in Haupteinheiten, z. B. | Nicht als Centwert und nicht mit Währungssymbol übergeben. |
Currency Code / | Ja | Exakt | Andere Währungen werden abgewiesen. |
Refund Status / | Ja | Erfolgswert des Triggers | Nur erfolgreiche Rückerstattungen werden akzeptiert. |
Refund Type / | Ja |
| Transporthinweis; die Integration prüft zusätzlich die tatsächlichen Beträge. |
Payload-Beispiel
{
"data": {
"transactionId": "transaction_example_123",
"refundId": "refund_example_123",
"refundAmount": "50.00",
"currencyCode": "EUR",
"refundStatus": "Successful",
"refundType": "Partial Refund"
},
"extras": {
"locationId": "location_example_123",
"contactId": "contact_example_123",
"executionId": "execution_example_123"
},
"meta": {
"key": "one_loop_lexware_create_credit_note"
}
}
Fachliche Regeln und Grenzen
Die ursprüngliche Rechnung muss zuvor mit Rechnung erstellen aus exakt derselben Transaktion entstanden sein.
Eine volle Rückerstattung wird mit der Originalrechnung verbunden und muss danach als
paidoffzurückkommen.Teilrückerstattungen bleiben eigenständig, damit mehrere verschiedene Rückerstattungs-IDs abbildbar bleiben.
Bei einer Teilrückerstattung mit mehreren Steuerarten wird keine automatische Verteilung geraten. Die Action stoppt vor dem Erstellen.
Bereits erstattete Netto- und Steueranteile dürfen die Originalrechnung in Summe nicht übersteigen.
Bei einem unklaren Provider-Ergebnis wird kein blinder zweiter Erstellversuch gesendet. Zuerst in Lexware Office prüfen.
Alle Ausgabevariablen
Variable | Bedeutung im Workflow |
|---|---|
| Vollständiger Erfolg und Ergebnisstatus. |
| Fehler- und Hinweiswerte. |
| Für diese Action |
| Ursprüngliche Zahlungs-Transaktion. |
| Stabile Kennung dieser Rückerstattung. |
| Erstatteter Bruttobetrag. |
| Bei Erfolg |
|
|
| Historischer Lexware-Kontakt der Originalrechnung. |
| Kennung und sichtbare Nummer der Originalrechnung. |
| Kennung, sichtbare Nummer und Status der Gutschrift. |
| Finale Gutschriftsdaten. |
| Typ und Name des offiziellen Dokuments. |
| Kennung der PDF-Kopie am Kontakt. |
| URL der PDF-Kopie für den nächsten Schritt. |
| Dateiname und Typ dieser Kopie. |
| Bei vollständigem Erfolg |
| Interner Lexware-Link; nicht öffentlich versenden. |
Bei einer Teilgutschrift ist creditNoteStatus normalerweise open. Eine mit der Originalrechnung verknüpfte volle Rückerstattung liefert paidoff.
Vollständige Datei und unklare Teilwirkung
Bei einem vollständig erstatteten Originalbetrag wird die Gutschrift mit der Originalrechnung verknüpft. Teilgutschriften bleiben eigenständig, damit mehrere unterschiedliche Teilrefunds abgebildet werden können. Eine technische Verbindung und ein eigenständiger Verlauf werden nicht still gemischt. Dieselbe refundId bleibt für denselben Refund erhalten.
Ist das rechtlich maßgebliche Dokument ein XRechnung-XML, wird kein PDF-Vorschaubild als offizielles Dokument ausgegeben. Das XML bleibt im Fachsystem; es wird nicht im PDF-only-Kontaktfeld gespeichert. Der Lauf endet kontrolliert als partial_success beziehungsweise zur manuellen Prüfung und nicht als erfolgreicher Workflow-Schritt. Auch bei bekanntem Beleg und unterbrochener Ablage nicht mit einer neuen Refund-ID nochmals erstellen.