PDF an einer bestimmten Stelle signieren: sichtbare Unterschrift mit CodeB Wallet im Aloaha PDF Editor

Thema

Aloaha PDF Editor

Codebeispiele

VB.NET

Veröffentlicht

27. Oktober 2026

Kurz: Im Aloaha PDF Editor ziehen Sie mit der Maus ein Rechteck an der Stelle auf, an der die Unterschrift stehen soll, klicken hinein und wählen Sign Document. Ist in den Signatur-Einstellungen CodeB Wallet gewählt, geht das PDF als Signaturanfrage an CodeB, und Sie unterschreiben am Android-Telefon in CodeB Wallet – die sichtbare Unterschrift (handschriftlich, Bild aus dem Ausweis oder nur der Name) erscheint genau in diesem Rechteck. In der App entscheiden Sie, wie Sie unterschreiben: mit einer Signaturkarte (qualifizierte elektronische Signatur, wenn das Zertifikat der Karte sie ausweist) oder mit dem CodeB-Signaturdienst ohne Karte (fortgeschrittene Signatur). Das signierte PDF speichert der PDF Editor unter dem gewählten Namen. Verfügbar ab Version 11.0.0.9.

Andere Begriffe für dasselbe: Unterschriftsfeld im PDF platzieren, sichtbare digitale Signatur positionieren, PDF mit dem Handy unterschreiben, Signaturfeld zeichnen, Unterschrift an markierter Stelle, PAdES-Signatur mit sichtbarem Erscheinungsbild, Unterschrift unter einen Vertrag oder eine Rechnung setzen.

Auf einen Blick

Voraussetzungen

• Aloaha PDF Editor ab Version 11.0.0.9 (Download).
• CodeB Wallet auf einem Android-Telefon (Zugang auf Einladung) und ein CodeB-Konto. Für eine qualifizierte Signatur zusätzlich eine Signaturkarte mit NFC.
• In den Signatur-Einstellungen das Verfahren CodeB Wallet – Signatur am Telefon mit CodeB-Benutzername (login_hint), Agent-ID (client_id) und Agent-Geheimnis (client_secret). Wie Sie den Agenten einmal je PC anlegen, steht unter Agent-ID und Agent-Geheimnis; jede Einstellung erklärt Die Einstellungen im Einzelnen.
• Eine gültige Lizenz des PDF Editors bzw. des SDK. Ohne Lizenz erscheint beim Signieren ein Hinweis mit den Wegen Lizenz kaufen oder kostenlose Testlizenz per E-Mail an info@aloaha.com anfordern.

Sind die Signatur-Einstellungen noch nie gespeichert worden oder fehlt eine Angabe, öffnet Sign Document zuerst den Einstellungsdialog.

Schritt für Schritt

1. PDF öffnen – zum Beispiel einen Vertrag, ein Angebot oder eine fertige ZUGFeRD-Rechnung.
2. Feld aufziehen: Mit gedrückter Maustaste ein Rechteck an der Stelle aufziehen, an der die Unterschrift stehen soll, mindestens etwa 2,1 × 0,7 cm groß.
3. Sign Document: In das Rechteck klicken und im Menü Sign Document wählen. Danach den Namen der signierten Datei wählen.
4. Programm freigeben: Das Statusfenster zeigt einen 4-stelligen Code. Auf phone.codeb.io/agent-approvals.html erscheint die Anmeldung unter Waiting for your approval – freigeben, wenn derselbe Code angezeigt wird. Die Freigabe gilt eine Stunde.
5. In CodeB Wallet unterschreiben: Das PDF wird hochgeladen. Den QR-Code auf phone.codeb.io/sign-request.html mit der App scannen, das Erscheinungsbild wählen (handschriftlich, Bild aus dem Ausweis oder nur der Name) und mit Signaturkarte oder CodeB-Signaturdienst unterschreiben.
6. Fertig: Das Statusfenster lädt das signierte PDF herunter und speichert es unter dem gewählten Namen; der PDF Editor zeigt es an.

Welche Signatur entsteht?

Das entscheiden Sie beim Unterschreiben in der App. Mit einer Signaturkarte entsteht eine qualifizierte elektronische Signatur (QES), wenn das Zertifikat der Karte das ausweist; welche Karten das sind, steht unter Welche Karten ergeben eine QES?. Mit dem CodeB-Signaturdienst ohne Karte entsteht eine fortgeschrittene elektronische Signatur (AdES). Das Statusfenster zeigt beim Warten den Stand auf phone.codeb.io an, nach dem Unterschreiben z. B. „me: signed (certificate states a qualified signature)“.

Deshalb fordert der PDF Editor bei einem gezeichneten Feld immer die Stufe „fortgeschritten“ an: Sie akzeptiert beide Wege, und eine Karte mit qualifiziertem Zertifikat ergibt trotzdem eine QES. Die Stufe „qualifiziert“ aus den Signatur-Einstellungen gilt nur für PDF signieren ohne Feld.

Wo genau landet die Unterschrift?

Der PDF Editor rechnet das Rechteck in PDF-Punkte der markierten Seite um (Ursprung unten links) und übergibt es der Signaturanfrage als Signaturfeld. Der CodeB-Server fügt vor dem Signieren ein leeres Signaturfeld CodeB_Signer1 als inkrementelle Änderung ein; CodeB Wallet signiert genau in dieses Feld und zeichnet das Erscheinungsbild. Ein Signaturfeld muss auf der Seite liegen und mindestens 60 × 20 Punkt groß sein; je Unterzeichner und Dokument gibt es ein Feld.

Bleibt eine ZUGFeRD-Rechnung gültig?

Ja, das eingebettete XML wird nicht verändert. In unserem Test lieferten die PDF/A-3- und XML-Prüfung nach dem Signieren dasselbe Ergebnis wie vorher. Details und Hinweise zur sichtbaren Signatur: Bleibt die ZUGFeRD-Rechnung nach dem Signieren gültig? Wichtig: Zuerst das XML einbetten, dann signieren – jede spätere Änderung macht die Signatur ungültig.

Feld zeichnen oder „PDF signieren“?

Typische Fehler

• Rechteck zu klein: Unter 60 × 20 Punkt lehnt der Dienst das Feld ab – das Statusfenster meldet es sofort, bevor etwas hochgeladen wird. Das Rechteck etwas größer aufziehen.
• Freigabe nicht erteilt: Ohne Freigabe auf Waiting for your approval wird nichts hochgeladen; die Anfrage zur Freigabe gilt 5 Minuten.
• Fenster vorzeitig geschlossen: Das Programm fragt, ob die Anfrage zurückgezogen werden soll. Bleibt sie offen, laden Sie das signierte PDF später auf phone.codeb.io/sign-request.html herunter.
• Lokales Zertifikat statt CodeB Wallet: Ist in den Signatur-Einstellungen ein anderes Verfahren gewählt, signiert der PDF Editor lokal. Für das Telefon CodeB Wallet wählen.
• Keine Lizenz: Ohne gültige Lizenz wird nicht signiert; der Hinweis bietet Lizenz kaufen oder Testlizenz anfordern. Den Schlüssel danach in den Lizenzeinstellungen eintragen.
• PDF nach dem Signieren geändert: Jede Änderung danach (auch erneutes Speichern mit einem anderen Programm) macht die Signatur ungültig.

Für Entwickler: dasselbe aus der eigenen Software

Der PDF Editor nutzt die COM- und .NET-Klasse WalletSignRequest des Aloaha ZUGFeRD SDK. Ein sichtbares Feld setzen Sie mit AddSignatureField(Signer, Page, X1, Y1, X2, Y2) vor CreateRequest – Seite ab 1, Koordinaten in PDF-Punkten von unten links:

Dim w As New Aloaha_ZUGFeRD.WalletSignRequest
w.LicenseKey = "IHR-LIZENZSCHLUESSEL"
w.UserName = "ihr-codeb-benutzername"           ' login_hint
w.AgentID = AgentIdAusIhrerKonfiguration        ' client_id
w.AgentSecret = GeheimnisAusGeschuetztemSpeicher ' client_secret, z. B. Windows-Anmeldeinformationsverwaltung
w.Level = "aes"                                 ' Karte oder Signaturdienst
w.SignMyself = True
If w.RequestApproval() AndAlso w.WaitForApproval(300) Then
    ' Feld für Unterzeichner 1 auf Seite 1: x 360-560, y 80-140 (PDF-Punkte)
    w.AddSignatureField(1, 1, 360, 80, 560, 140)
    If w.CreateRequest("C:\Rechnungen\RE-1001.pdf", "RE-1001.pdf") Then
        w.WaitUntilSigned("C:\Rechnungen\RE-1001_signed.pdf", 1800)
    End If
End If

Den Code für die Freigabe (BindingMessage) zeigen Sie dem Benutzer nach RequestApproval an. Alle Methoden und Eigenschaften: ZUGFeRD-Rechnung mit CodeB Wallet signieren – SDK.

Mit gültigem Wartungsvertrag ist das Upgrade auf die neue Version kostenlos.