Credenciales
Para emitir documentos fiscales portugueses en nombre de un contribuyente, SIGN PT debe comunicarse con la Autoridade Tributária e Aduaneira (AT) — por ejemplo, para registrar series de documentos, obtener códigos de validación ATCUD y enviar datos de facturación o transporte en tiempo real.
Esta comunicación utiliza credenciales de Servicio Web AT dedicadas que cada contribuyente crea en su propia cuenta del Portal das Finanças y proporciona a su aplicación. Estas credenciales autentican SIGN PT ante la AT — son independientes de cualquier clave de API de SIGN PT.
Por razones de seguridad y trazabilidad, la comunicación con la AT nunca debe utilizar la cuenta principal del contribuyente en el Portal das Finanças. En cambio, el contribuyente crea un subusuario dedicado (portugués: utilizador autorizado) bajo su NIF, al que solo se otorgan los permisos específicos de Servicio Web que SIGN PT necesita.
Permisos requeridos
Sección titulada «Permisos requeridos»Al subusuario del contribuyente se le deben otorgar uno o más de los siguientes permisos, dependiendo de las funcionalidades de SIGN PT que el contribuyente tenga previsto utilizar:
| Permiso | Propósito | ¿Requerido? |
|---|---|---|
| WSE — Comunicação e Gestão de Séries por Webservice | Registrar y gestionar series de documentos; obtener códigos de validación ATCUD | Siempre requerido |
| WFA — Webservice de Comunicação de Dados de Faturas | Enviar facturas a la AT en tiempo real | Requerido para informes de facturas en tiempo real |
| WDT — Webservice de Comunicação de Documentos de Transporte | Enviar documentos de transporte a la AT en tiempo real | Requerido para informes de documentos de transporte en tiempo real |
Si el contribuyente solo tiene intención de informar mediante la exportación mensual de SAF-T (PT), aún necesita WSE — el registro de series y la validación ATCUD siempre pasan por el Servicio Web AT, incluso cuando los datos de facturación se informan mediante archivo SAF-T.
Creación del subusuario en el Portal das Finanças
Sección titulada «Creación del subusuario en el Portal das Finanças»Puede compartir esta sección con sus contribuyentes o ayudarles a seguirla.
Antes de comenzar, el contribuyente necesita:
- Credenciales de la cuenta principal del Portal das Finanças (NIF y contraseña, Cartão de Cidadão o Chave Móvel Digital). Debe autenticarse como titular de la cuenta principal, no como subusuario existente.
- Un lugar seguro donde guardar la contraseña del subusuario, ya que deberá proporcionarla a su aplicación posteriormente.
1. Iniciar sesión en el Portal das Finanças
Sección titulada «1. Iniciar sesión en el Portal das Finanças»Vaya a https://www.portaldasfinancas.gov.pt y haga clic en Iniciar Sessão. Inicie sesión usando cualquiera de los métodos de autenticación disponibles.
2. Abrir la página de gestión de usuarios
Sección titulada «2. Abrir la página de gestión de usuarios»Use el cuadro de búsqueda y busque Gestão de Utilizadores, luego haga clic en Aceder en el resultado correspondiente.
Alternativamente, navegue a través de Todos os Serviços → Autenticação de Contribuintes → Gestão de Utilizadores, o use el enlace directo: https://www.acesso.gov.pt/gestaoDeUtilizadores/consulta?partID=PFAP.
3. Crear un nuevo usuario
Sección titulada «3. Crear un nuevo usuario»Haga clic en Criar Novo Utilizador y complete los campos:
- Nome — una etiqueta para el subusuario (puramente identificativa, sin relevancia fiscal). Use algo descriptivo, p. ej. fiskaly o SIGN PT.
- Senha / Confirmar Senha — elija una contraseña segura. Debe ser diferente de la contraseña principal del Portal das Finanças. Guárdela; será necesaria para configurar SIGN PT.
- Email — una dirección para las notificaciones AT relacionadas con este subusuario.
4. Asignar los permisos requeridos
Sección titulada «4. Asignar los permisos requeridos»En la lista Perfis Atribuíveis (perfiles asignables), marque los permisos de la tabla anterior (WSE, más WFA y/o WDT según sea necesario).
La lista está paginada. Escriba W en el campo Filtrar para localizar rápidamente los perfiles con prefijo W.
5. Enviar
Sección titulada «5. Enviar»Haga clic en Submeter. El Portal creará el subusuario y mostrará una página de resumen.
6. Anotar el identificador del subusuario
Sección titulada «6. Anotar el identificador del subusuario»El subusuario se identifica usando el formato NIF/número — el NIF del contribuyente, seguido de una barra, seguida de un número secuencial asignado por el Portal. Por ejemplo: 501234567/5.
Este identificador, junto con la contraseña establecida en el paso 3, es lo que SIGN PT utilizará para autenticarse ante la AT.
Actualizar un subusuario existente
Sección titulada «Actualizar un subusuario existente»Si ya existe un subusuario (por ejemplo, uno creado anteriormente para comunicar documentos de transporte o enviar SAF-T), no es necesario crear uno nuevo. En cambio, el contribuyente debe:
- Abrir Gestão de Utilizadores.
- Localizar el subusuario existente y hacer clic en Alterar Dados.
- Agregar los permisos faltantes (normalmente WSE, más WFA y/o WDT si corresponde).
- Hacer clic en Alterar Utilizador para guardar.
Los subusuarios más antiguos creados antes de 2020 (p. ej. para el envío heredado de SAF-T) pueden no tener ningún permiso W. En ese caso, agregue WSE como mínimo, más WFA y/o WDT según sea necesario.
Almacenar las credenciales en SIGN PT
Sección titulada «Almacenar las credenciales en SIGN PT»Las credenciales creadas para el subusuario se configuran luego en SIGN PT a través de los endpoints createTaxpayer / updateTaxpayer, en la sección credentials del bloque de fiscalización portugués. Se almacenan por Contribuyente (Company o Individual).
La contraseña del subusuario debe tratarse como un secreto y no debe estar codificada en su aplicación. Debe proporcionarse a través de una interfaz de configuración segura y almacenarse cifrada. Si la contraseña se cambia en el Portal das Finanças, también debe actualizarse en SIGN PT.
Mantener las credenciales válidas
Sección titulada «Mantener las credenciales válidas»SIGN PT utiliza las credenciales del Servicio Web AT para registrar series y, donde corresponda, transmitir datos de facturación o transporte en tiempo real. Si las credenciales caducan, quedan bloqueadas o se ingresan incorrectamente, SIGN PT ya no puede comunicarse con la AT en nombre de ese contribuyente. Como resultado:
- es posible que las nuevas series de documentos no se registren;
- el envío en tiempo real de facturas puede dejar de funcionar; y
- los datos de transacciones pueden dejar de llegar a la AT como se esperaba.
Para evitar interrupciones del servicio, el usuario final (el contribuyente) necesita una interfaz en su aplicación donde pueda configurar y actualizar periódicamente sus credenciales de Servicio Web AT. Recomendamos encarecidamente implementar:
- Comprobaciones de estado periódicas — por ejemplo, una llamada programada ligera que verifique que las credenciales siguen siendo aceptadas por la AT.
- Alertas proactivas — notificaciones por correo electrónico o advertencias en el panel cuando las credenciales estén a punto de caducar o hayan empezado a fallar.
- Manejo claro de errores — mostrar errores de autenticación al contribuyente en lenguaje sencillo para que sepa que debe actualizar sus credenciales.
Was this page helpful?