Credenciales del comerciante
Credenciales de los comerciantes en la Agencia Tributaria
Sección titulada «Credenciales de los comerciantes en la Agencia Tributaria»Para acceder al procedimiento web «Documento Commerciale Online» de la Agencia Tributaria a través de la API SIGN IT lite, los comerciantes deben disponer de credenciales Fisconline personales. Estas credenciales pueden ser obtenidas por todos los contribuyentes mayores de 16 años, incluidos los ciudadanos italianos residentes en el extranjero, que posean un número de IVA italiano.
La API SIGN IT permite la introducción de credenciales Fisconline a través de la sección fiscalization de los endpoints createTaxpayer y updateTaxpayer. Se deben proporcionar el password, el pin y la tax_id_number del usuario Fisconline para el Taxpayer (COMPANY o INDIVIDUAL) específico. Tenga en cuenta que el usuario final necesitará una interfaz a través de la cual pueda actualizar periódicamente sus credenciales.
La API SIGN IT admite la autenticación y la presentación de documentos comerciales fiscales
al portal web de la AdE exclusivamente mediante credenciales Fisconline.
Otros métodos de autenticación, como SPID, no están disponibles ya que requerirían
renovación cada 24 horas.
Las credenciales Fisconline válidas solo son necesarias en el entorno LIVE. En el entorno TEST, no se realiza ninguna validación con los datos de la AdE, por lo que se pueden utilizar valores de marcador de posición — como los proporcionados en nuestra colección Postman.
La contraseña Fisconline caduca cada 90 días (recomendamos renovarla cada 60 días). Los comerciantes están obligados a actualizar periódicamente sus credenciales en el portal de la AdE y enviarlas a través de SIGN IT lite. Aprenda cómo en este artículo: SIGN IT - How to update the FISCONLINE credentials
El uso de credenciales que ya no son válidas provocará una interrupción del servicio, ya que la API SIGN IT lite no podrá autenticarse con el procedimiento web. Por esta razón, se recomienda implementar un recordatorio periódico para los comerciantes (p. ej., por correo electrónico) para evitar problemas como el bloqueo de la transmisión de datos de transacciones.
Para ayudar a los integradores a detectar y gestionar más rápidamente los problemas relacionados con las credenciales, la versión 2026-06-01 introduce un modo DEGRADED para el Taxpayer, activado automáticamente cuando se detectan errores de credenciales de Fisconline. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?
¿Cómo solicitar credenciales Fisconline?
Sección titulada «¿Cómo solicitar credenciales Fisconline?»La persona física que actúa como trabajador autónomo o como representante legal de una empresa puede solicitar credenciales Fisconline a la Agencia Tributaria. Para una Guía del Comerciante detallada sobre cómo solicitar credenciales Fisconline, por favor contacte a nuestro equipo de ventas.
El contribuyente debe realizar manualmente un inicio de sesión inicial en el portal web de la Agencia Tributaria para asegurarse de que las credenciales funcionen correctamente y para aceptar los términos, condiciones y cláusulas adicionales previstas.
Se debe establecer una nueva contraseña después del primer inicio de sesión. La contraseña proporcionada por la Agencia Tributaria para el acceso inicial no debe utilizarse en la API SIGN IT.
Encuentre más información a través de las FAQ de la Agencia Tributaria
Was this page helpful?