Skip to content
ONE LOOP / Documentation / Apps & connections

The source documentation is currently available in German. No English translation is implied.

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

  1. Den nativen Trigger Refund mit Filter Status = Successful verwenden.

  2. Direkt danach Create Credit Note einfügen.

  3. Alle sechs Werte aus dem Trigger mappen.

  4. 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 / transactionId

Ja

ID aus dem Rückerstattungs-Trigger

Ordnet die Rückerstattung der ursprünglichen Zahlung und Rechnung zu.

Refund ID / refundId

Ja

Stabile ID aus dem Rückerstattungs-Trigger

Dauerhafter Deduplizierungsschlüssel: dieselbe ID erzeugt höchstens eine Gutschrift.

Refund Amount / refundAmount

Ja

EUR-Betrag in Haupteinheiten, z. B. 50.00

Nicht als Centwert und nicht mit Währungssymbol übergeben.

Currency Code / currencyCode

Ja

Exakt EUR

Andere Währungen werden abgewiesen.

Refund Status / refundStatus

Ja

Erfolgswert des Triggers

Nur erfolgreiche Rückerstattungen werden akzeptiert.

Refund Type / refundType

Ja

full oder partial bzw. Triggerwert

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 paidoff zurü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

success, status

Vollständiger Erfolg und Ergebnisstatus.

errorCode, errorMessage, retryable, warnings

Fehler- und Hinweiswerte.

sourceMode, sourceReferenceType, sourceReferenceId

Für diese Action refund und die Rückerstattungs-ID.

transactionId

Ursprüngliche Zahlungs-Transaktion.

refundId

Stabile Kennung dieser Rückerstattung.

refundAmount

Erstatteter Bruttobetrag.

refundStatus

Bei Erfolg success.

refundType

full oder partial.

lexwareContactId

Historischer Lexware-Kontakt der Originalrechnung.

originalInvoiceId, originalInvoiceNumber

Kennung und sichtbare Nummer der Originalrechnung.

creditNoteId, creditNoteNumber, creditNoteStatus

Kennung, sichtbare Nummer und Status der Gutschrift.

voucherDate, currency, netAmount, taxAmount, grossAmount

Finale Gutschriftsdaten.

officialDocumentMimeType, officialDocumentFileName

Typ und Name des offiziellen Dokuments.

creditNoteDocumentId

Kennung der PDF-Kopie am Kontakt.

creditNoteFileUrl

URL der PDF-Kopie für den nächsten Schritt.

creditNoteFileName, creditNoteMimeType

Dateiname und Typ dieser Kopie.

contactDocumentStatus

Bei vollständigem Erfolg uploaded.

lexwareViewUrl

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.

← Back to articles