Per i clienti SIGN DE

Guida all’integrazione di SIGN ES per i clienti SIGN DE

Questa guida aiuta a integrare con successo l’API fiskaly SIGN ES e descrive tutti i passaggi necessari che voi e i vostri commercianti dovete compiere.

Configurazione: creazione delle organizzazioni

La creazione e la configurazione delle organizzazioni funziona allo stesso modo di SIGN DE.

Nota: in SIGN ES, ogni organizzazione gestita rappresenta un contribuente (identificato dal suo NIF/codice fiscale). È necessario creare un’organizzazione gestita per contribuente, non per sede o negozio.

La creazione di (organizzazioni gestite) avviene tramite la Management API fiskaly. L’aggiunta di utenti e la creazione di chiavi API vengono eseguite anch’esse tramite la Management API. La nostra guida al processo di integrazione descrive ulteriormente questi passaggi iniziali.

SIGN ES

Poiché si ha già familiarità con la nostra API SIGN DE, l’implementazione di SIGN ES dovrebbe essere abbastanza semplice. Il flusso del processo è stato progettato per essere lo stesso per entrambe le API. Per facilitare ulteriormente il processo, le differenze e le somiglianze con SIGN DE sono evidenziate nei singoli endpoint.

SIGN ES vs. SIGN DE

Una volta creata la struttura organizzativa, è possibile procedere passo dopo passo utilizzando i seguenti endpoint dell’API SIGN ES:

PUT: Crea informazioni sul contribuente

Utilizzare questo endpoint per creare il contribuente. Questo passaggio deve essere eseguito una sola volta.

Contribuente: In SIGN ES, un’organizzazione gestita rappresenta un contribuente e il suo territorio fiscale (l’indirizzo legale dell’azienda). All’interno di ogni organizzazione gestita deve essere creato un contribuente. Importante: in caso di eventuali modifiche ai dati del contribuente, deve essere creata una nuova organizzazione gestita poiché i dati del contribuente non possono essere modificati successivamente.

📘Differenze rispetto a SIGN DE

Al momento non esiste un endpoint equivalente in SIGN DE.

PUT: Crea un firmatario

Utilizzare questo endpoint per creare almeno un firmatario. Per quanto riguarda i campi private_key e public_key: queste informazioni sul certificato saranno fornite da fiskaly.

Firmatari: In SIGN ES, un firmatario rappresenta il dispositivo di firma. Deve essere creato almeno un firmatario, ma in scenari con un volume di fatture particolarmente elevato, possono essere creati più firmatari. Il firmatario contiene un certificato che deve essere associato al contribuente nei server dell’autorità fiscale.

Nota: questo certificato di dispositivo è fornito da fiskaly o, se disponibile, è possibile utilizzarne uno esistente.

💡Analogie con SIGN DE

Il firmatario corrisponde alla TSS in SIGN DE. A differenza di SIGN DE, un firmatario può essere utilizzato immediatamente poiché non ha stati diversi. Pertanto, il processo di implementazione è ancora più semplice.

PUT: Crea un client

Utilizzare questo endpoint per creare un client. Il client identifica in modo univoco un terminale, un dispositivo POS, un’applicazione o altri dispositivi utilizzati per emettere fatture.

Client: In SIGN ES, un client rappresenta il dispositivo POS. Per emettere fatture è necessario un client per dispositivo POS e almeno un dispositivo di firma.

💡Analogie con SIGN DE

Il client corrisponde all’entità client in SIGN DE. Ogni client è connesso a un firmatario, allo stesso modo in cui ogni client è connesso a una TSS in SIGN DE, con la sola differenza che la connessione tra client e firmatario in SIGN ES viene stabilita nel corpo della richiesta e non nei parametri del percorso.

• In SIGN ES, i client possono avere due stati: ENABLED e DISABLED.
• In SIGN DE, gli stati corrispondenti sono REGISTERED e DEREGISTERED.

Nota: a differenza di SIGN DE, impostare lo stato di un client su DISABLED è irreversibile in SIGN ES.

PUT: Crea una fattura

Utilizzare questo endpoint per creare una fattura. client_id e invoice_id nei parametri del percorso devono essere definiti dall’utente.

Fatture: In SIGN ES esistono sei tipi di fatture: fattura semplificata, fattura completa, fattura rettificativa, fattura di arricchimento, fattura esterna e fattura di rimedio:

1. La fattura semplificata contiene solo informazioni sull’emittente, ma nessuna informazione sul destinatario della fattura. Questa fattura può essere emessa solo fino a un importo di 400 € e in alcuni casi specifici fino a un importo di 3.000 € (vendite al dettaglio, ristoranti, servizi di parcheggio…).
2. La fattura completa include informazioni sia sull’emittente che sul destinatario della fattura; è il tipo più comunemente utilizzato per i servizi forniti da professionisti o aziende.
3. La fattura rettificativa deve essere emessa ogni volta che si è verificato un errore, ad esempio in caso di importo errato. In questa fattura, i commercianti devono indicare se si tratta di una rettifica per sostituzione o di una rettifica per differenze.
4. La fattura di arricchimento può essere emessa quando la fattura originale è stata creata senza destinatari e l’unica modifica necessaria è l’aggiunta di destinatario/i.
5. La fattura esterna è finalizzata a inserire i dettagli delle fatture emesse prima dell’integrazione dell’API SIGN ES. Questo serve a garantire che le correzioni possano essere effettuate in conformità con le normative. La creazione di una fattura esterna non attiva una trasmissione alle autorità fiscali, né genera un file XML per la fattura. Una volta creata una fattura esterna e assegnato un UUID, questo UUID può essere referenziato quando si emette una fattura rettificativa o di arricchimento.
6. La fattura di rimedio può essere emessa per rimediare a informazioni di fattura errate che non richiedono una rettifica per legge.

💡Analogie con SIGN DE

Le fatture in SIGN ES corrispondono alle transazioni in SIGN DE. A differenza di SIGN DE, le fatture vengono inviate direttamente all’autorità fiscale competente. La risposta restituisce la fattura firmata e include anche il suo stato di sincronizzazione e trasmissione all’autorità fiscale competente.

📘Differenze rispetto a SIGN DE

Poiché in Spagna non esiste alcun obbligo che richieda l’avvio, l’aggiornamento e il completamento delle transazioni, questa parte di SIGN ES è molto più semplice di SIGN DE. A differenza di SIGN DE, le fatture consegnate al consumatore devono includere un codice identificativo e un codice QR, che devono essere posizionati secondo linee guida specifiche.

I dettagli sono disponibili qui: Conformità delle fatture.

PATCH: Aggiorna una fattura

Utilizzare questo endpoint per aggiornare una fattura. Questo endpoint deve essere utilizzato solo per annullare una fattura già creata.

📘Differenze rispetto a SIGN DE

In SIGN DE non esiste un endpoint specifico per annullare le ricevute. La gestione delle cancellazioni in Spagna è quindi molto più semplice.

Come creare una ricevuta digitale

Dopo aver creato una fattura, è possibile creare una ricevuta digitale per la propria fattura utilizzando il nostro endpoint per la ricevuta digitale. L’URL restituito può essere facilmente mostrato come codice QR al consumatore durante il processo di pagamento e la ricevuta non deve più essere stampata. Questo consente di risparmiare sui costi, supporta l’ambiente, aumenta la soddisfazione del cliente e aggiunge un nuovo punto di contatto con il cliente per il commerciante.

Per saperne di più sulla ricevuta digitale oltre alle sue funzionalità di base, su come migliorare la fedeltà del cliente e sfruttare l’ecosistema di partner fiskaly, contattarci all’indirizzo sales@fiskaly.com. Per la visualizzazione di tale ricevuta digitale, consultare la nostra guida alla ricevuta digitale e utilizzare liberamente la nostra API per le ricevute disponibile pubblicamente.

Pronti per approfondire?

Date un’occhiata al nostro SIGN ES Quick Start: abbiamo creato una Postman Collection che consente di eseguire le funzioni più importanti di questa API.