Credenziali
Per emettere documenti fiscali portoghesi per conto di un contribuente, SIGN PT deve comunicare con l’Autoridade Tributária e Aduaneira (AT) — ad esempio, per registrare serie di documenti, ottenere codici di validazione ATCUD e inviare dati di fatturazione o trasporto in tempo reale.
Questa comunicazione utilizza credenziali del Servizio Web AT dedicate che ogni contribuente crea nel proprio account del Portal das Finanças e fornisce alla vostra applicazione. Queste credenziali autenticano SIGN PT presso l’AT — sono separate da qualsiasi chiave API di SIGN PT.
Per motivi di sicurezza e tracciabilità, la comunicazione AT non deve mai utilizzare l’account principale del contribuente sul Portal das Finanças. Al contrario, il contribuente crea un sottoutente dedicato (portoghese: utilizador autorizado) sotto il proprio NIF, a cui vengono concessi solo i permessi specifici del Servizio Web di cui SIGN PT ha bisogno.
Permessi richiesti
Sezione intitolata “Permessi richiesti”Al sottoutente del contribuente devono essere concessi uno o più dei seguenti permessi, a seconda delle funzionalità di SIGN PT che il contribuente intende utilizzare:
| Permesso | Scopo | Richiesto? |
|---|---|---|
| WSE — Comunicação e Gestão de Séries por Webservice | Registrare e gestire serie di documenti; ottenere codici di validazione ATCUD | Sempre richiesto |
| WFA — Webservice de Comunicação de Dados de Faturas | Inviare fatture all’AT in tempo reale | Richiesto per la comunicazione in tempo reale delle fatture |
| WDT — Webservice de Comunicação de Documentos de Transporte | Inviare documenti di trasporto all’AT in tempo reale | Richiesto per la comunicazione in tempo reale dei documenti di trasporto |
Se il contribuente intende rendicontare solo tramite l’esportazione mensile SAF-T (PT), è comunque necessario WSE — la registrazione delle serie e la validazione ATCUD avvengono sempre tramite il Servizio Web AT, anche quando i dati di fatturazione vengono rendicontati tramite file SAF-T.
Creazione del sottoutente sul Portal das Finanças
Sezione intitolata “Creazione del sottoutente sul Portal das Finanças”Potete condividere questa sezione con i vostri contribuenti o accompagnarli nel processo.
Prima di iniziare, il contribuente deve disporre di:
- Le credenziali dell’account principale del Portal das Finanças (NIF e password, Cartão de Cidadão o Chave Móvel Digital). Deve autenticarsi come titolare dell’account principale, non come sottoutente esistente.
- Un luogo sicuro dove conservare la password del sottoutente, poiché dovrà fornirla alla vostra applicazione in seguito.
1. Accedere al Portal das Finanças
Sezione intitolata “1. Accedere al Portal das Finanças”Accedere a https://www.portaldasfinancas.gov.pt e fare clic su Iniciar Sessão. Accedere utilizzando uno dei metodi di autenticazione disponibili.
2. Aprire la pagina di gestione degli utenti
Sezione intitolata “2. Aprire la pagina di gestione degli utenti”Utilizzare il campo di ricerca e cercare Gestão de Utilizadores, quindi fare clic su Aceder sul risultato corrispondente.
In alternativa, navigare tramite Todos os Serviços → Autenticação de Contribuintes → Gestão de Utilizadores, oppure utilizzare il link diretto: https://www.acesso.gov.pt/gestaoDeUtilizadores/consulta?partID=PFAP.
3. Creare un nuovo utente
Sezione intitolata “3. Creare un nuovo utente”Fare clic su Criar Novo Utilizador e compilare i campi:
- Nome — un’etichetta per il sottoutente (puramente identificativa, senza rilevanza fiscale). Utilizzare qualcosa di descrittivo, ad es. fiskaly o SIGN PT.
- Senha / Confirmar Senha — scegliere una password robusta. Deve essere diversa dalla password principale del Portal das Finanças. Conservarla; sarà necessaria per configurare SIGN PT.
- Email — un indirizzo per le notifiche AT relative a questo sottoutente.
4. Assegnare i permessi richiesti
Sezione intitolata “4. Assegnare i permessi richiesti”Nell’elenco Perfis Atribuíveis (profili assegnabili), selezionare i permessi dalla tabella precedente (WSE, più WFA e/o WDT secondo necessità).
L’elenco è paginato. Digitare W nel campo Filtrar per individuare rapidamente i profili con prefisso W.
5. Inviare
Sezione intitolata “5. Inviare”Fare clic su Submeter. Il portale creerà il sottoutente e visualizzerà una pagina di riepilogo.
6. Annotare l’identificatore del sottoutente
Sezione intitolata “6. Annotare l’identificatore del sottoutente”Il sottoutente viene identificato nel formato NIF/numero — il NIF del contribuente, seguito da una barra e da un numero sequenziale assegnato dal Portale. Ad esempio: 501234567/5.
Questo identificatore, insieme alla password impostata nel passaggio 3, è ciò che SIGN PT utilizzerà per autenticarsi presso l’AT.
Aggiornamento di un sottoutente esistente
Sezione intitolata “Aggiornamento di un sottoutente esistente”Se esiste già un sottoutente (ad esempio, uno creato in precedenza per comunicare documenti di trasporto o inviare SAF-T), non è necessario crearne uno nuovo. Il contribuente deve invece:
- Aprire Gestão de Utilizadores.
- Individuare il sottoutente esistente e fare clic su Alterar Dados.
- Aggiungere i permessi mancanti (tipicamente WSE, più WFA e/o WDT se applicabile).
- Fare clic su Alterar Utilizador per salvare.
I sottoutenti più vecchi creati prima del 2020 (ad es. per l’invio SAF-T legacy) potrebbero non avere permessi W. In tal caso, aggiungere almeno WSE, più WFA e/o WDT secondo necessità.
Memorizzare le credenziali in SIGN PT
Sezione intitolata “Memorizzare le credenziali in SIGN PT”Le credenziali create per il sottoutente vengono quindi configurate in SIGN PT tramite gli endpoint createTaxpayer / updateTaxpayer, nella sezione credentials del blocco di fiscalizzazione portoghese. Vengono memorizzate per Contribuente (Company o Individual).
La password del sottoutente deve essere trattata come un segreto e non deve essere codificata nell’applicazione. Deve essere fornita tramite un’interfaccia di configurazione sicura e memorizzata in forma cifrata. Se la password viene modificata nel Portal das Finanças, deve essere aggiornata anche in SIGN PT.
Mantenere le credenziali valide
Sezione intitolata “Mantenere le credenziali valide”SIGN PT utilizza le credenziali del Servizio Web AT per registrare le serie e, dove applicabile, trasmettere dati di fatturazione o trasporto in tempo reale. Se le credenziali scadono, vengono bloccate o vengono inserite in modo errato, SIGN PT non può più comunicare con l’AT per conto di quel contribuente. Di conseguenza:
- le nuove serie di documenti potrebbero non riuscire a registrarsi;
- la trasmissione in tempo reale delle fatture potrebbe smettere di funzionare; e
- i dati delle transazioni potrebbero non raggiungere più l’AT come previsto.
Per evitare interruzioni del servizio, l’utente finale (il contribuente) ha bisogno di un’interfaccia nell’applicazione dove possa configurare e aggiornare periodicamente le proprie credenziali del Servizio Web AT. Si raccomanda vivamente di implementare:
- Controlli periodici dello stato — ad esempio, una chiamata pianificata leggera che verifichi che le credenziali siano ancora accettate dall’AT.
- Avvisi proattivi — notifiche via e-mail o avvisi sul dashboard quando le credenziali stanno per scadere o hanno iniziato a generare errori.
- Gestione chiara degli errori — mostrare gli errori di autenticazione al contribuente in linguaggio semplice affinché sappia di dover aggiornare le proprie credenziali.
Was this page helpful?