Identifiants
Pour émettre des documents fiscaux portugais au nom d’un contribuable, SIGN PT doit communiquer avec l’Autoridade Tributária e Aduaneira (AT) — par exemple, pour enregistrer des séries de documents, obtenir des codes de validation ATCUD et soumettre des données de facturation ou de transport en temps réel.
Cette communication utilise des identifiants de Service Web AT dédiés que chaque contribuable crée dans son propre compte Portal das Finanças et fournit à votre application. Ces identifiants authentifient SIGN PT auprès de l’AT — ils sont séparés de toute clé API SIGN PT.
Pour des raisons de sécurité et de traçabilité, la communication AT ne doit jamais utiliser le compte principal du contribuable sur le Portal das Finanças. À la place, le contribuable crée un sous-utilisateur dédié (portugais : utilizador autorizado) sous son NIF, auquel sont accordées uniquement les permissions de Service Web spécifiques dont SIGN PT a besoin.
Permissions requises
Section intitulée « Permissions requises »Le sous-utilisateur du contribuable doit se voir accorder une ou plusieurs des permissions suivantes, selon les fonctionnalités SIGN PT que le contribuable envisage d’utiliser :
| Permission | Objet | Requise ? |
|---|---|---|
| WSE — Comunicação e Gestão de Séries por Webservice | Enregistrer et gérer les séries de documents ; obtenir les codes de validation ATCUD | Toujours requise |
| WFA — Webservice de Comunicação de Dados de Faturas | Soumettre des factures à l’AT en temps réel | Requise pour les déclarations de factures en temps réel |
| WDT — Webservice de Comunicação de Documentos de Transporte | Soumettre des documents de transport à l’AT en temps réel | Requise pour les déclarations de documents de transport en temps réel |
Si le contribuable envisage uniquement de déclarer via l’export mensuel SAF-T (PT), il a tout de même besoin de WSE — l’enregistrement des séries et la validation ATCUD passent toujours par le Service Web AT, même lorsque les données de facturation sont déclarées par fichier SAF-T.
Création du sous-utilisateur sur le Portal das Finanças
Section intitulée « Création du sous-utilisateur sur le Portal das Finanças »Vous pouvez partager cette section avec vos contribuables ou les accompagner dans cette démarche.
Avant de commencer, le contribuable doit disposer de :
- Les identifiants du compte principal du Portal das Finanças (NIF et mot de passe, Cartão de Cidadão ou Chave Móvel Digital). Il doit s’authentifier en tant que titulaire du compte principal, et non en tant que sous-utilisateur existant.
- Un endroit sécurisé pour stocker le mot de passe du sous-utilisateur, car il devra le fournir à votre application par la suite.
1. Se connecter au Portal das Finanças
Section intitulée « 1. Se connecter au Portal das Finanças »Rendez-vous sur https://www.portaldasfinancas.gov.pt et cliquez sur Iniciar Sessão. Connectez-vous en utilisant l’une des méthodes d’authentification disponibles.
2. Ouvrir la page de gestion des utilisateurs
Section intitulée « 2. Ouvrir la page de gestion des utilisateurs »Utilisez la barre de recherche et cherchez Gestão de Utilizadores, puis cliquez sur Aceder sur le résultat correspondant.
Vous pouvez aussi naviguer via Todos os Serviços → Autenticação de Contribuintes → Gestão de Utilizadores, ou utiliser le lien direct : https://www.acesso.gov.pt/gestaoDeUtilizadores/consulta?partID=PFAP.
3. Créer un nouvel utilisateur
Section intitulée « 3. Créer un nouvel utilisateur »Cliquez sur Criar Novo Utilizador et renseignez les champs :
- Nome — un libellé pour le sous-utilisateur (purement identificateur, sans pertinence fiscale). Utilisez quelque chose de descriptif, par ex. fiskaly ou SIGN PT.
- Senha / Confirmar Senha — choisissez un mot de passe fort. Il doit être différent du mot de passe principal du Portal das Finanças. Conservez-le ; il sera nécessaire pour configurer SIGN PT.
- Email — une adresse pour les notifications AT liées à ce sous-utilisateur.
4. Attribuer les permissions requises
Section intitulée « 4. Attribuer les permissions requises »Dans la liste Perfis Atribuíveis (profils attribuables), cochez les permissions du tableau ci-dessus (WSE, plus WFA et/ou WDT selon les besoins).
La liste est paginée. Tapez W dans le champ Filtrar pour localiser rapidement les profils préfixés par W.
5. Soumettre
Section intitulée « 5. Soumettre »Cliquez sur Submeter. Le portail créera le sous-utilisateur et affichera une page de récapitulatif.
6. Noter l’identifiant du sous-utilisateur
Section intitulée « 6. Noter l’identifiant du sous-utilisateur »Le sous-utilisateur est identifié au format NIF/numéro — le NIF du contribuable, suivi d’une barre oblique, suivie d’un numéro séquentiel attribué par le portail. Par exemple : 501234567/5.
Cet identifiant, accompagné du mot de passe défini à l’étape 3, est ce que SIGN PT utilisera pour s’authentifier auprès de l’AT.
Mise à jour d’un sous-utilisateur existant
Section intitulée « Mise à jour d’un sous-utilisateur existant »Si un sous-utilisateur existe déjà (par exemple, un créé précédemment pour communiquer des documents de transport ou soumettre des SAF-T), il n’est pas nécessaire d’en créer un nouveau. À la place, le contribuable doit :
- Ouvrir Gestão de Utilizateurs.
- Localiser le sous-utilisateur existant et cliquer sur Alterar Dados.
- Ajouter les permissions manquantes (généralement WSE, plus WFA et/ou WDT si applicable).
- Cliquer sur Alterar Utilizador pour sauvegarder.
Les sous-utilisateurs plus anciens créés avant 2020 (par ex. pour la soumission SAF-T legacy) peuvent ne disposer d’aucune permission W. Dans ce cas, ajoutez WSE au minimum, ainsi que WFA et/ou WDT selon les besoins.
Stocker les identifiants dans SIGN PT
Section intitulée « Stocker les identifiants dans SIGN PT »Les identifiants créés pour le sous-utilisateur sont ensuite configurés dans SIGN PT via les endpoints createTaxpayer / updateTaxpayer, dans la section credentials du bloc de fiscalisation portugais. Ils sont stockés par Contribuable (Company ou Individual).
Le mot de passe du sous-utilisateur doit être traité comme un secret et ne doit pas être codé en dur dans votre application. Il doit être fourni via une interface de configuration sécurisée et stocké chiffré. Si le mot de passe est modifié sur le Portal das Finanças, il doit également être mis à jour dans SIGN PT.
Maintenir les identifiants valides
Section intitulée « Maintenir les identifiants valides »SIGN PT utilise les identifiants du Service Web AT pour enregistrer les séries et, le cas échéant, transmettre des données de facturation ou de transport en temps réel. Si les identifiants expirent, sont verrouillés ou sont saisis incorrectement, SIGN PT ne peut plus communiquer avec l’AT au nom de ce contribuable. Par conséquent :
- de nouvelles séries de documents peuvent ne pas parvenir à s’enregistrer ;
- la soumission en temps réel des factures peut cesser de fonctionner ; et
- les données de transaction peuvent ne plus parvenir à l’AT comme prévu.
Pour éviter toute interruption de service, l’utilisateur final (le contribuable) a besoin d’une interface dans votre application lui permettant de configurer et de mettre à jour périodiquement ses identifiants de Service Web AT. Nous recommandons vivement d’implémenter :
- Des vérifications régulières — par exemple, un appel planifié léger qui vérifie que les identifiants sont toujours acceptés par l’AT.
- Des alertes proactives — des notifications par e-mail ou des avertissements sur le tableau de bord lorsque les identifiants sont sur le point d’expirer ou ont commencé à échouer.
- Une gestion claire des erreurs — afficher les erreurs d’authentification au contribuable en langage clair afin qu’il sache qu’il doit mettre à jour ses identifiants.
Was this page helpful?