Skip to content
ONE LOOP / Documentation / Apps & connections

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

Apps & connections

Gutschrift mit sevdesk erstellen

Bilde erfolgreiche Erstattungen gegen die passende bezahlte Originalrechnung ab, ohne eine neue Auszahlung auszulösen.

Vorbereitete Anleitung auf Basis des Implementierungsstands. Die vollständige Verbindung und Ausführung im vorgesehenen Standort sind noch nicht allgemein bestätigt. Nutze diese Schritte erst, wenn die App und ihre Funktionen für deinen Standort ausdrücklich bereitstehen.

Zweck und Eingaben

Bilde ausschließlich eine bereits erfolgreiche Rückerstattung ab. Die Action führt selbst keine Auszahlung aus. Pflicht: transactionId, refundId, refundAmount, currencyCode, refundStatus, refundType. V1 verlangt EUR, Status success oder succeeded sowie full oder partial. refundAmount ist der Betrag dieses Refunds in Hauptwährung, nicht der kumulierte Gesamtbetrag.

Die Originalrechnung muss derselben Installation, Firma, Kontakt- und Standortzuordnung angehören und in sevdesk bezahlt oder teilbezahlt sein. Die App bucht keine Zahlung und storniert nicht automatisch, um das zu erzwingen. Wiederholungen verwenden dieselbe refundId. Teilrefunds bei gemischten Steuern ohne eindeutige Positionszuordnung werden abgebrochen.

Ergebnis und vollständige Variablen

Prüfe finalen Beleg, offizielle Datei, Bezug zum Ursprungsdokument und Beträge. Ein Teil- oder unbekanntes Ergebnis ist kein neuer Create-Auftrag.

Variable

Typ

Bedeutung / sichere Verwendung

success

Wahr/Falsch

Erfolg des Schritts; vor Folgeaktionen prüfen.

status

Text

Ergebnisstatus; bei Teilergebnis keine neue Erstellung auslösen.

errorCode

Text; optional/leer möglich

Fehlerkennung.

errorMessage

Text; optional/leer möglich

Fehlermeldung.

retryable

Wahr/Falsch

Hinweis auf mögliche Wiederholung; externe Wirkung zuerst abgleichen.

warnings

Liste

Zusätzliche Hinweise.

sourceMode

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

sourceReferenceType

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

sourceReferenceId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

sevdeskContactId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

transactionId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

refundId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

refundAmount

Zahl

Betragswert gemäß der auf dieser Seite beschriebenen Einheit.

refundStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

refundType

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

originalInvoiceId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

originalInvoiceNumber

Text

Sichtbare Beleg-/Kundennummer.

creditNoteId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

creditNoteNumber

Text

Sichtbare Beleg-/Kundennummer.

creditNoteStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

providerCreditNoteStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

isFinalized

Wahr/Falsch

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

finalizedAt

Text

Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren.

finalizedAtFormatted

Text

Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden.

creditNoteDate

Text

Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren.

creditNoteDateFormatted

Text

Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden.

currency

Text

Währung des Belegs oder Ereignisses.

netAmount

Zahl

Nettobetrag des Belegs.

taxAmount

Zahl

Steuerbetrag des Belegs.

grossAmount

Zahl

Bruttobetrag des Belegs.

grossAmountFormatted

Text

Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden.

creditNoteDocumentId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

creditNoteFileUrl

Text

Link zum zugeordneten Objekt oder Dokument; Leerwert und Zugriff prüfen.

creditNoteFileName

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

creditNoteMimeType

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

contactDocumentStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

Sicher mit Variablen arbeiten

Wähle jede Variable im Variablen-Picker des konkreten Workflow-Schritts. Technische IDs sind für Verknüpfungen, sichtbare Belegnummern für Nachrichten. Keine selbst geratenen Schrittnummern oder Zugangsdaten in Felder kopieren. Prüfe leere Werte und Datentypen vor Folgeaktionen.

Fehler und Wiederholung

Prüfe bei einem Fehler zuerst Standort, Verbindung, Pflichtfelder, Kundenzuordnung, Währung und Steuerdaten. Ein Timeout beweist nicht, dass kein Dokument entstanden ist. Bei unklarem externem Ergebnis zuerst den bestehenden Lauf und den Beleg abgleichen; nicht mit neuer Vorgangskennung nochmals erstellen. Für denselben Vorgang denselben stabilen Schlüssel verwenden. Support benötigt Zeitpunkt, Standort, Action/Trigger, Request- oder Ereigniskennung und Fehlermeldung, niemals API-Schlüssel oder Tokens.

← Back to articles