Credenziali del commerciante
⚠️ Stai visualizzando la documentazione per la versione API 2026-02-03. La versione più recente è 2026-05-04. La nuova versione API non apporta modifiche all’integrazione italiana. Tuttavia, aggiunge il supporto SIGN PT, consentendo ai team che pianificano di espandersi in Portogallo di riutilizzare la stessa integrazione già in uso per l’Italia.
Credenziali dei commercianti presso l’Agenzia delle Entrate
Sezione intitolata “Credenziali dei commercianti presso l’Agenzia delle Entrate”Per accedere alla procedura web “Documento Commerciale Online” dell’Agenzia delle Entrate tramite l’API SIGN IT lite, i commercianti devono disporre di credenziali Fisconline personali. Queste credenziali possono essere ottenute da tutti i contribuenti di età superiore ai 16 anni, inclusi i cittadini italiani residenti all’estero, che possiedono una partita IVA italiana.
L’API SIGN IT consente l’inserimento delle credenziali Fisconline tramite la sezione fiscalization degli endpoint createTaxpayer e updateTaxpayer. È necessario fornire password, pin e tax_id_number dell’utente Fisconline per il Taxpayer (COMPANY o INDIVIDUAL) specifico. Tenere presente che l’utente finale avrà bisogno di un’interfaccia attraverso la quale aggiornare periodicamente le proprie credenziali.
L’API SIGN IT supporta l’autenticazione e la trasmissione di documenti commerciali fiscali al portale web dell’AdE esclusivamente tramite credenziali Fisconline. Altri metodi di autenticazione, come SPID, non sono supportati in quanto richiederebbero il rinnovo ogni 24 ore.
La password Fisconline scade ogni 90 giorni (si consiglia di rinnovarla ogni 60 giorni). I commercianti sono tenuti ad aggiornare regolarmente le proprie credenziali sul portale AdE e a trasmetterle tramite SIGN IT lite. Scopri come in questo articolo: SIGN IT - Come aggiornare le credenziali FISCONLINE
L’utilizzo di credenziali non più valide causerà un’interruzione del servizio, poiché l’API SIGN IT lite non sarà in grado di autenticarsi con la procedura web. Per questo motivo, si raccomanda di implementare un promemoria periodico per i commercianti (ad es. tramite e-mail) per evitare problemi come il blocco della trasmissione dei dati delle transazioni.
Come richiedere le credenziali Fisconline?
Sezione intitolata “Come richiedere le credenziali Fisconline?”La persona fisica che agisce come lavoratore autonomo o come rappresentante legale di un’azienda può richiedere le credenziali Fisconline all’Agenzia delle Entrate. Per una Guida al Commerciante dettagliata su come richiedere le credenziali Fisconline, si prega di contattare il nostro team commerciale.
Il contribuente deve effettuare manualmente un primo accesso al portale web dell’Agenzia delle Entrate per verificare che le credenziali funzionino correttamente e per accettare i termini, le condizioni e le clausole aggiuntive previste.
È necessario impostare una nuova password dopo il primo accesso. La password fornita dall’Agenzia delle Entrate per l’accesso iniziale non deve essere utilizzata nell’API SIGN IT.
Ulteriori informazioni sono disponibili tramite le FAQ dell’Agenzia delle Entrate
Was this page helpful?