Identifiants du marchand

Identifiants des marchands auprès de l’Agence fiscale

Pour accéder à la procédure web « Documento Commerciale Online » de l’Agence fiscale via l’API SIGN IT lite, les marchands doivent disposer d’identifiants Fisconline personnels. Ces identifiants peuvent être obtenus par tous les contribuables de plus de 16 ans, y compris les citoyens italiens résidant à l’étranger, qui possèdent un numéro de TVA italien.

L’API SIGN IT permet la saisie des identifiants Fisconline via la section fiscalization des endpoints createTaxpayer et updateTaxpayer. Le password, le pin et la tax_id_number de l’utilisateur Fisconline doivent être fournis pour le Taxpayer (COMPANY ou INDIVIDUAL) spécifique. Veuillez noter que l’utilisateur final aura besoin d’une interface lui permettant de mettre à jour périodiquement ses identifiants.

📘Note

L’API SIGN IT prend en charge l’authentification et la soumission de documents commerciaux fiscaux au portail web de l’AdE exclusivement via les identifiants Fisconline. Les autres méthodes d’authentification, telles que SPID, ne sont pas prises en charge car elles nécessiteraient un renouvellement toutes les 24 heures.

Des identifiants Fisconline valides sont uniquement requis dans l’environnement LIVE. Dans l’environnement TEST, aucune validation n’est effectuée par rapport aux données AdE, des valeurs fictives peuvent donc être utilisées — comme celles fournies dans notre collection Postman.

⚠️Important

Le mot de passe Fisconline expire tous les 90 jours (nous recommandons de le renouveler tous les 60 jours). Les marchands sont tenus de mettre à jour régulièrement leurs identifiants sur le portail AdE et de les soumettre via SIGN IT lite. Apprenez comment dans cet article : SIGN IT - How to update the FISCONLINE credentials

L’utilisation d’identifiants qui ne sont plus valides entraînera une interruption du service, car l’API SIGN IT lite ne pourra pas s’authentifier auprès de la procédure web. Pour cette raison, il est recommandé de mettre en place un rappel périodique pour les marchands (par exemple via e-mail) afin d’éviter des problèmes tels que le blocage de la transmission des données de transaction.

Pour aider les intégrateurs à détecter et à gérer plus rapidement les problèmes liés aux identifiants, la version 2026-06-01 introduit un mode DEGRADED pour le Taxpayer, déclenché automatiquement lorsque des erreurs d’identifiants Fisconline sont détectées. Pour en savoir plus, consultez l’article dédié : Qu’est-ce que le mode DEGRADED et comment intervenir ?

Comment demander des identifiants Fisconline ?

La personne physique agissant en tant que travailleur indépendant ou en tant que représentant légal d’une entreprise peut demander des identifiants Fisconline auprès de l’Agence fiscale. Pour un guide détaillé du marchand sur la façon de demander des identifiants Fisconline, veuillez contacter notre équipe commerciale.

💡Tip

Le contribuable doit effectuer manuellement une première connexion au portail web de l’Agence fiscale afin de s’assurer que les identifiants fonctionnent correctement et d’accepter les conditions générales et les clauses supplémentaires prévues.

Un nouveau mot de passe doit être défini après la première connexion. Le mot de passe fourni par l’Agence fiscale pour l’accès initial ne doit pas être utilisé dans l’API SIGN IT.

Trouvez plus d’informations via les FAQ de l’Agence fiscale