Credenciales del comerciante

⚠️ Está viendo la documentación de la versión de API 2026-02-03. La versión más reciente es 2026-05-04. La nueva versión de la API no trae cambios en la integración italiana. Sin embargo, añade soporte para SIGN PT, lo que permite a los equipos que planean expandirse a Portugal reutilizar la misma integración ya existente para Italia.

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. Es necesario proporcionar el password, el pin y el tax_id_number del usuario Fisconline para el contribuyente (COMPANY o INDIVIDUAL) específico. Ten en cuenta que el usuario final necesitará una interfaz a través de la cual pueda actualizar periódicamente tus credenciales.

📘Note

La API SIGN IT admite únicamente la autenticación y el envío de documentos comerciales fiscales al portal web de AdE mediante credenciales Fisconline. Otros métodos de autenticación, como SPID, no son compatibles, ya que requerirían renovación cada 24 horas.

📘Importante

La contraseña de Fisconline caduca cada 90 días (recomendamos renovarla cada 60 días). Los comerciantes deben actualizar regularmente tus credenciales en el portal de 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 sean válidas provocará una interrupción del servicio, ya que la API SIGN IT lite no podrá autenticarse en 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.

¿Cómo solicitar credenciales Fisconline?

La persona física que actúe como autónomo o como representante legal de una empresa puede solicitar credenciales Fisconline a la Agencia Tributaria. Para obtener una Guía del Comerciante detallada sobre cómo solicitar credenciales Fisconline, ponte en contacto con nuestro equipo de ventas.

💡Tip

El contribuyente debe iniciar sesión manualmente en el portal web de la Agencia Tributaria por primera vez para asegurarse de que las credenciales funcionan correctamente y para aceptar los términos, condiciones y cláusulas adicionales proporcionadas.

Debe establecerse una nueva contraseña tras el 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 en las preguntas frecuentes de la Agencia Tributaria