Zugangsdaten

Um portugiesische Steuerdokumente im Namen eines Steuerpflichtigen auszustellen, muss SIGN PT mit der Autoridade Tributária e Aduaneira (AT) kommunizieren — beispielsweise um Dokumentenserien zu registrieren, ATCUD-Validierungscodes zu erhalten und Rechnungs- oder Transportdaten in Echtzeit zu übermitteln.

Diese Kommunikation verwendet dedizierte AT-Webservice-Zugangsdaten, die jeder Steuerpflichtige in seinem eigenen Portal das Finanças-Konto erstellt und Ihrer Anwendung bereitstellt. Diese Zugangsdaten authentifizieren SIGN PT gegenüber der AT — sie sind von SIGN PT API-Keys vollständig getrennt.

Aus Sicherheits- und Nachverfolgbarkeitsgründen darf die AT-Kommunikation niemals das Hauptkonto des Steuerpflichtigen im Portal das Finanças verwenden. Stattdessen erstellt der Steuerpflichtige einen dedizierten Unterbenutzer (portugiesisch: utilizador autorizado) unter seiner NIF, dem nur die spezifischen Webservice-Berechtigungen erteilt werden, die SIGN PT benötigt.

Erforderliche Berechtigungen

Dem Unterbenutzer des Steuerpflichtigen müssen eine oder mehrere der folgenden Berechtigungen erteilt werden, abhängig von den SIGN PT-Funktionen, die der Steuerpflichtige nutzen möchte:

Berechtigung	Zweck	Erforderlich?
WSE — Comunicação e Gestão de Séries por Webservice	Dokumentenserien registrieren und verwalten; ATCUD-Validierungscodes erhalten	Immer erforderlich
WFA — Webservice de Comunicação de Dados de Faturas	Rechnungen in Echtzeit an die AT übermitteln	Erforderlich für Echtzeit-Rechnungsberichterstattung
WDT — Webservice de Comunicação de Documentos de Transporte	Transportdokumente in Echtzeit an die AT übermitteln	Erforderlich für Echtzeit-Transportdokumentberichterstattung

💡Tip

Wenn der Steuerpflichtige nur über den monatlichen SAF-T (PT)-Export berichten möchte, wird dennoch WSE benötigt — Serienregistrierung und ATCUD-Validierung erfolgen immer über den AT-Webservice, auch wenn die Rechnungsdaten selbst per SAF-T-Datei gemeldet werden.

Erstellen des Unterbenutzers im Portal das Finanças

Sie können diesen Abschnitt mit Ihren Steuerpflichtigen teilen oder sie dabei begleiten.

Bevor der Steuerpflichtige beginnt, benötigt er:

Hauptkonto-Zugangsdaten für das Portal das Finanças (NIF und Passwort, Cartão de Cidadão oder Chave Móvel Digital). Er muss sich als Hauptkontoinhaber authentifizieren, nicht als vorhandener Unterbenutzer.
Einen sicheren Speicherort für das Unterbenutzerpasswort, da er es anschließend Ihrer Anwendung bereitstellen wird.

1. Anmeldung beim Portal das Finanças

Gehen Sie zu https://www.portaldasfinancas.gov.pt und klicken Sie auf Iniciar Sessão. Melden Sie sich mit einer der verfügbaren Authentifizierungsmethoden an.

2. Benutzerverwaltungsseite öffnen

Verwenden Sie das Suchfeld und suchen Sie nach Gestão de Utilizadores, dann klicken Sie auf Aceder beim passenden Ergebnis.

Alternativ navigieren Sie über Todos os Serviços → Autenticação de Contribuintes → Gestão de Utilizadores oder nutzen Sie den direkten Link: https://www.acesso.gov.pt/gestaoDeUtilizadores/consulta?partID=PFAP.

3. Neuen Benutzer erstellen

Klicken Sie auf Criar Novo Utilizador und füllen Sie folgende Felder aus:

Nome — eine Bezeichnung für den Unterbenutzer (rein identifikatorisch, ohne steuerliche Relevanz). Verwenden Sie etwas Beschreibendes, z. B. fiskaly oder SIGN PT.
Senha / Confirmar Senha — wählen Sie ein starkes Passwort. Es muss sich vom Hauptpasswort des Portal das Finanças unterscheiden. Notieren Sie es; es wird für die Konfiguration von SIGN PT benötigt.
Email — eine Adresse für AT-Benachrichtigungen zu diesem Unterbenutzer.

4. Erforderliche Berechtigungen zuweisen

Wählen Sie in der Liste Perfis Atribuíveis (zuweisbare Profile) die Berechtigungen aus der obigen Tabelle aus (WSE sowie WFA und/oder WDT je nach Bedarf).

💡Tip

Die Liste ist seitenweise aufgebaut. Geben Sie W in das Feld Filtrar ein, um die W-präfixierten Profile schnell zu finden.

5. Absenden

Klicken Sie auf Submeter. Das Portal erstellt den Unterbenutzer und zeigt eine Übersichtsseite an.

6. Unterbenutzer-Kennung notieren

Der Unterbenutzer wird im Format NIF/Nummer identifiziert — die NIF des Steuerpflichtigen, gefolgt von einem Schrägstrich und einer vom Portal vergebenen fortlaufenden Nummer. Beispiel: 501234567/5.

Diese Kennung zusammen mit dem in Schritt 3 festgelegten Passwort verwendet SIGN PT zur Authentifizierung gegenüber der AT.

Bestehenden Unterbenutzer aktualisieren

Wenn bereits ein Unterbenutzer existiert (z. B. einer, der zuvor für die Kommunikation von Transportdokumenten oder die Übermittlung von SAF-T erstellt wurde), muss kein neuer erstellt werden. Stattdessen sollte der Steuerpflichtige:

Gestão de Utilizadores öffnen.
Den vorhandenen Unterbenutzer suchen und auf Alterar Dados klicken.
Die fehlenden Berechtigungen hinzufügen (typischerweise WSE sowie WFA und/oder WDT, falls zutreffend).
Auf Alterar Utilizador klicken, um zu speichern.

⚠️Caution

Ältere Unterbenutzer, die vor 2020 erstellt wurden (z. B. für die Legacy-SAF-T-Übermittlung), haben möglicherweise keine W-Berechtigungen. Fügen Sie in diesem Fall mindestens WSE sowie WFA und/oder WDT nach Bedarf hinzu.

Zugangsdaten in SIGN PT speichern

Die für den Unterbenutzer erstellten Zugangsdaten werden dann in SIGN PT über die Endpunkte createTaxpayer / updateTaxpayer im Abschnitt credentials des portugiesischen Fiskalisierungsblocks konfiguriert. Sie werden pro Steuerpflichtigen (Unternehmen oder Einzelperson) gespeichert.

📘Note

Das Unterbenutzerpasswort sollte als vertraulich behandelt werden und darf nicht fest in Ihrer Anwendung kodiert sein. Es muss über eine sichere Konfigurationsschnittstelle bereitgestellt und verschlüsselt gespeichert werden. Wenn das Passwort im Portal das Finanças geändert wird, muss es auch in SIGN PT aktualisiert werden.

Zugangsdaten gültig halten

SIGN PT verwendet die AT-Webservice-Zugangsdaten, um Serien zu registrieren und, falls zutreffend, Rechnungs- oder Transportdaten in Echtzeit zu übermitteln. Wenn Zugangsdaten ablaufen, gesperrt werden oder falsch eingegeben werden, kann SIGN PT nicht mehr im Namen dieses Steuerpflichtigen mit der AT kommunizieren. Folglich:

können neue Dokumentenserien möglicherweise nicht registriert werden;
kann die Echtzeit-Übermittlung von Rechnungen aufhören zu funktionieren; und
können Transaktionsdaten möglicherweise die AT nicht mehr wie erwartet erreichen.

Um Serviceunterbrechungen zu vermeiden, benötigt der Endnutzer (der Steuerpflichtige) eine Schnittstelle in Ihrer Anwendung, über die er seine AT-Webservice-Zugangsdaten konfigurieren und regelmäßig aktualisieren kann. Wir empfehlen dringend die Implementierung von:

Regelmäßigen Integritätsprüfungen — zum Beispiel ein leichtgewichtiger geplanter Aufruf, der überprüft, ob die Zugangsdaten von der AT noch akzeptiert werden.
Proaktiven Warnungen — E-Mail-Benachrichtigungen oder Dashboard-Warnungen, wenn Zugangsdaten bald ablaufen oder zu Fehlern führen.
Klarer Fehlerbehandlung — Authentifizierungsfehler dem Steuerpflichtigen in verständlicher Sprache anzeigen, damit dieser weiß, dass er seine Zugangsdaten aktualisieren muss.

Was this page helpful?