> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # E-Signatur-Warnungen und Risikocodes > Alle E-Signatur-Warnungen bei Didit von SIGNATURE_DECLINED bis SIGNATURE_DOCUMENT_CHANGED: Auslöser und zugehörige Regeln. Ein [E-Signatur](https://docs.didit.me/de/core-technology/electronic-signature/overview.md)-Schritt gibt eine Warnung aus, wenn ein Unterzeichner nicht signieren kann oder will: Er lehnt ab, hat keine Codes mehr übrig oder kann keiner verifizierten Identität zugeordnet werden, oder ein Dokument stimmt nicht mehr mit dem überein, was ihm angezeigt wurde. Jede Warnung stoppt die Signatur dieses Unterzeichners, sodass dafür kein signiertes Dokument ausgestellt wird. Wie sich die Warnung auf die Entscheidung auswirkt, liegt bei Ihnen. ## Übersicht Eine Warnung erscheint an zwei Stellen: * Im Eintrag des Unterzeichners in `signatures[]`, als `{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }` in `warnings[]`. Siehe [E-Signatur-Bericht](https://docs.didit.me/de/core-technology/electronic-signature/report-electronic-signature.md). * In der Aktivität der Sitzung, getaggt mit der Funktion `SIGNATURE`, mit ihrem Titel und ihrer Beschreibung. Die Console zeigt sie im Reiter **Signatur** der Sitzung an, und `additional_data.signature_id` verweist auf den Unterzeichner. Jeder Code ist einer Regel zugeordnet. Legen Sie die Regel pro Workflow-Schritt im Console-Reiter **Regeln** oder in der [Konfiguration](https://docs.didit.me/de/management-api/workflows/feature-configs.md#e-signatur) des Schritts auf `DECLINE`, `REVIEW` oder `NO_ACTION` fest. Die Regel bestimmt das `verdict` des Unterzeichners (`Declined`, `In Review` oder `Approved`) und den Schweregrad der Warnung (`error`, `warning` oder `information`). Benutzerdefinierte Statusregeln für den Schritt werden danach angewendet. > [!WARNING] > > Eine Regel bestimmt die Entscheidung, nicht, ob die Dokumente signiert sind. `NO_ACTION` lässt den Workflow fortfahren, aber der Unterzeichner hat noch immer nicht signiert. Prüfen Sie, ob `status` den Wert `signed` hat, bevor Sie sich auf eine Signatur verlassen. ## Erzeugte Warnungen | Code | Wann sie ausgelöst wird | Regel und Standardwert | | - | - | - | | `SIGNATURE_DECLINED` | Der Unterzeichner hat die Signatur abgelehnt. Es wird keine signierte Kopie ausgestellt und nichts in Rechnung gestellt. | `signature_declined_action`, Standardwert `REVIEW` | | `SIGNATURE_OTP_FAILED` | Der Unterzeichner hat 3 falsche Codes eingegeben oder mehr als 5 Codes angefordert. | `signature_otp_failed_action`, Standardwert `DECLINE` | | `SIGNATURE_NAME_MISMATCH` | KYB: Der für die Schlüsselperson angegebene Name stimmt nicht mit deren verifiziertem Namen überein (Groß-/Kleinschreibung und Leerzeichen werden ignoriert). | `signature_name_mismatch_action`, Standardwert `DECLINE` | | `SIGNATURE_IDENTITY_NOT_VERIFIED` | Der Unterzeichner verfügt über keine genehmigte Ausweisverifizierung mit Namen, eine Liveness-Erkennung in seiner Sitzung ist nicht genehmigt oder die Ausweisverifizierung hat sich geändert, nachdem der Unterzeichner begonnen hat. | `signature_identity_not_verified_action`, Standardwert `DECLINE` | | `SIGNATURE_DOCUMENT_CHANGED` | Ein Dokument stimmt nicht mehr mit dem SHA-256-Wert überein, der erfasst wurde, als es dem Unterzeichner angezeigt wurde. | `signature_document_changed_action`, Standardwert `DECLINE` | Die Identitäts- und Namensprüfungen werden ausgeführt, wenn der Unterzeichner seinen Code anfordert, und erneut, wenn er ihn eingibt. Daher erscheinen diese Warnungen zu diesem Zeitpunkt und nicht beim Öffnen des Schritts. ## Ablehnungen können wieder geöffnet werden `SIGNATURE_DECLINED` ist die einzige Warnung, die ein Unterzeichner rückgängig machen kann. Solange der Signaturlink gültig ist, kann ein Unterzeichner, der abgelehnt hat, den Schritt erneut öffnen und signieren. Das erneute Öffnen setzt die Warnung des Unterzeichners sowie dessen Lesen und Zustimmung für jedes Dokument zurück, sodass er die Dokumente erneut durchgeht. Die Warnung wird aus den Aktivitäten der Sitzung entfernt, sobald kein Unterzeichner des Schritts mehr ablehnt. Das erneute Öffnen setzt die Code-Versuche nicht zurück. Die anderen Warnungen sind für diesen Unterzeichner endgültig. ## Probleme, die der Unterzeichner sieht Diese stoppen den Unterzeichner, ohne eine Warnung auszulösen. Der Ablauf informiert ihn darüber, was passiert ist. | Situation | Was passiert | | - | - | | Der Signaturlink ist abgelaufen | Der Schritt kann nach `expires_at` nicht mehr geöffnet oder abgeschlossen werden. Der Link ist ab der Erstellung der Sitzung für `signature_link_validity_days` Tage gültig. | | Der Code ist abgelaufen | Codes sind 5 Minuten lang gültig. Der Unterzeichner fordert einen neuen an. | | Ein neuer Code wurde zu früh angefordert | Der Unterzeichner wartet 60 Sekunden zwischen zwei Codes. | | Kein verifizierter Kontakt | Der Code wird nur an eine E-Mail-Adresse oder Telefonnummer gesendet, die zuvor in der Sitzung verifiziert wurde. Fügen Sie vor dem Signaturschritt eine E-Mail-Verifizierung oder Telefonverifizierung hinzu. | | Ein Pflichtfeld ist leer | Der Unterzeichner kann ein Dokument erst fertigstellen, wenn jedes Pflichtfeld darauf einen Wert enthält. Der Ablauf zeigt an, wie viele noch fehlen, und springt zum ersten. | | Der Wert eines Feldes wird abgelehnt | Ein Wert, der die [Validierung](https://docs.didit.me/de/core-technology/electronic-signature/overview.md#validierung) seines Feldes verletzt (z. B. zu lang oder keine Zahl), wird abgelehnt und der Ablauf erklärt den Grund. | | Die App ist zu alt für Felder | Ein natives SDK-Release ohne Unterstützung für Felder kann ein Dokument mit Feldern nicht anzeigen, und der Schritt zeigt einen Fehler an. Dokumente ohne Felder funktionieren weiterhin. Siehe [Das Signieren](https://docs.didit.me/de/core-technology/electronic-signature/overview.md#das-signiererlebnis). | ## Beispiel ```json theme={null} { "signatures": [ { "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10", "node_id": "feature_signature", "status": "declined", "verdict": "In Review", "warnings": [ { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } ], "declined_at": "2026-11-03T10:41:40.320Z", "declined_action": "REVIEW", "signed_at": null, "certificate": null, "timestamp": null, "evidence_file": null } ] } ``` Das Beispiel zeigt nur die Felder, die sich ändern. Alle anderen Felder des [Signaturobjekts](https://docs.didit.me/de/core-technology/electronic-signature/report-electronic-signature.md#das-signatur-objekt) sind weiterhin vorhanden. ## Warnungstypen Der Schweregrad jeder Warnung richtet sich nach der von Ihnen festgelegten Regel. Die Schweregrade werden in drei Kategorien eingeteilt: ## Verwandte Themen * [Übersicht über die E-Signatur](https://docs.didit.me/de/core-technology/electronic-signature/overview.md) * [E-Signatur-Bericht](https://docs.didit.me/de/core-technology/electronic-signature/report-electronic-signature.md) * [Workflow-Funktionskonfigurationen](https://docs.didit.me/de/management-api/workflows/feature-configs.md#e-signatur) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.