Spagna (SIGN ES)

SIGN ES in sintesi

	Dettagli
Regolamento	Verifactu e SII (nazionale), TicketBAI (Paesi Baschi) e NaTicket (Navarra)
Requisiti	Generazione XML fatture, firma crittografica e concatenamento, trasmissione in tempo reale alle autorità fiscali, generazione QR
Architettura API	API specializzata — progettata appositamente per la Spagna, utilizza la Management API per la configurazione dell’organizzazione
Sforzo di integrazione	2-4 settimane da zero
Caratteristica chiave	Un’unica API che copre i sistemi di fiscalizzazione (TicketBAI, Verifactu, NaTicket) e l’e-reporting (SII) tramite una singola integrazione

Verifactu, TicketBAI, NaTicket e SII — tutto in un’unica API

La complessità del quadro fiscale spagnolo deriva dalla coesistenza del territorio comune e dei territori forali, che crea più sistemi di conformità concorrenti. I fornitori di software che commercializzano prodotti in Spagna devono garantire la conformità con ciascun sistema applicabile. SIGN ES li gestisce tutti tramite una singola API:

• Verifactu — si applica a livello nazionale in tutta la Spagna ai sensi del Decreto Reale 1007/2023. Non si applica alle aziende situate nei Paesi Baschi o in Navarra.
• TicketBAI — si applica nelle tre province basche: Álava, Bizkaia e Gipuzkoa. Ogni territorio ha la propria autorità fiscale.
• NaTicket — si applica nel territorio forale della Navarra.
• SII — sistema nazionale di dichiarazione IVA gestito dall’Agenzia delle Entrate spagnola (AEAT).

SIGN ES astrae tutti questi sistemi dietro un’unica interfaccia API. Si specifica quale regolamento si applica per contribuente e SIGN ES gestisce il resto.

💡Un'unica integrazione per tutta la Spagna

Non è necessaria un’integrazione separata per regolamento. SIGN ES instrada ogni flusso di fattura conforme all’autorità fiscale corretta in base al territorio fiscale e agli obblighi del contribuente.

Concetti chiave

Signer

Un signer rappresenta il dispositivo di firma e contiene il certificato utilizzato per firmare fatture e ricevute. Poiché fiskaly è collaboratore sociale dell’Agenzia delle Entrate spagnola, possiamo fornire il certificato di firma senza che il contribuente debba fornire il proprio certificato.

Client

Un client rappresenta un terminale POS, un dispositivo di fatturazione, un’applicazione o un sistema emittente simile. Ogni client è collegato a un signer. I client hanno due stati: ENABLED e DISABLED (impostare un client su DISABLED è irreversibile).

Invoice

Le invoice sono il modello di transazione principale in SIGN ES. Esistono sei tipi:

1. Fattura semplificata — solo dati del mittente, fino a 400 EUR (o 3.000 EUR per casi speciali come retail, ristoranti e parcheggi). La più comune per ricevute e scontrini B2C.
2. Fattura completa — dati del mittente e del destinatario. La più comune per B2B.
3. Fattura rettificativa — corregge un errore su una fattura emessa in precedenza. La correzione può essere per sostituzione o per differenze.
4. Fattura di arricchimento — aggiunge i dati del destinatario a una fattura emessa in precedenza.
5. Fattura esterna — importa fatture precedenti all’integrazione come riferimento per correzioni e non viene trasmessa all’autorità fiscale.
6. Fattura di rimedio — corregge informazioni errate, per lo più dovute a errori di integrazione, che non richiedono legalmente una fattura rettificativa.

Tutti i tipi di fattura eccetto la fattura esterna vengono firmati crittograficamente, concatenati facendo riferimento all’hash della fattura precedente e trasmessi in tempo reale all’autorità fiscale competente. Le fatture esterne sono solo record di riferimento: non generano XML e non vengono trasmesse.

Sforzo di integrazione

Scenario	Durata	Note
Nuova integrazione	2-6 settimane	Flusso completo: configurazione org con Management API, certificati, signer, client, firma e invio fatture
Aggiunta di Verifactu a TicketBAI esistente	~1 settimana	Stessa API, diverso flag di regolamento per contribuente
Già su Unified API (FR/IT)	2-4 settimane	Architettura API diversa — SIGN ES usa la Management API, non il pattern Unified

Sei già cliente di SIGN DE?

Consulta la guida progettata specificamente per i clienti SIGN DE. Può semplificare notevolmente il tuo sforzo di integrazione: Per i clienti SIGN DE.

Per iniziare

1. Crea la tua organizzazione

   Registrati su fiskaly HUB e crea un’organizzazione gestita per ogni contribuente tramite la Management API, o usa direttamente HUB.

2. Configura i certificati

   Crea il certificato elettronico richiesto. Contatta il nostro team se preferisci utilizzarne uno esistente. Consulta certificato elettronico e certificato dispositivo.

3. Crea signer e client

   Crea un signer (certificato di firma) e un client (terminale POS) per ogni terminale, dispositivo POS, applicazione o altro dispositivo usato per emettere fatture.

4. Crea le fatture

   Crea la tua prima fattura. SIGN ES genera l’XML, lo firma, lo concatena alla fattura precedente e lo trasmette all’autorità fiscale. La risposta include la fattura firmata e il suo stato di trasmissione.

5. Genera i codici QR

   Ogni fattura deve includere un codice identificativo e un codice QR sulla ricevuta stampata/visualizzata. Consulta conformità fattura.

Documentazione

Introduzione

Panoramica delle normative fiscali spagnole e di SIGN ES

Processo di integrazione

Guida all'integrazione completa passo dopo passo

Conformità fattura

Formato fattura, codici QR, codici identificativi e regole di posizionamento

Perdita di connessione

Gestione dei problemi di connettività durante la trasmissione in tempo reale

Glossario

Termini chiave per la conformità fiscale spagnola

Per i clienti SIGN DE

Guida alla migrazione: cosa cambia passando da SIGN DE