Apps & Verbindungen
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.