Perdita di connessione

Finché si è connessi a SIGN ES, non c’è motivo di preoccuparsi. In caso di perdita di connessione al server dell’Agenzia delle Entrate spagnola, SIGN ES implementa un controllo di disponibilità del servizio Verifactu. La trasmissione dei registri di fatturazione riprenderà automaticamente quando la connessione al servizio sarà ripristinata.

Qualsiasi interruzione o problema di trasmissione rilevato da fiskaly verrà notificato tramite la nostra pagina di stato.

📘Note

Indichiamo automaticamente il campo incident come Sì se rileviamo problemi di disconnessione dalla nostra parte. L’API SIGN ES trasmetterà i file XML non appena la connessione al servizio dell’Agenzia delle Entrate sarà ripristinata.

📘Importante

L’utente del sistema POS deve essere notificato in caso di problemi di connessione a Internet o di un incidente che influisce sulla trasmissione all’API SIGN ES. Idealmente, viene visualizzato un messaggio nel POS che indica questa situazione.

Se si perde la connessione con noi

Anche in caso di problemi di connessione, il contribuente emetterà una fattura al cliente, conservandone una copia.

In caso di problemi di connessione a Internet nel sistema POS, il Regolamento Verifactu prevede l’indicazione di eventuali problemi con la trasmissione delle fatture emesse attraverso un campo incident nella struttura XML creata.

Nella nostra API SIGN ES, il campo incident fa parte delle annotations durante la creazione di una nuova fattura. Non appena il problema di connettività sarà risolto, le fatture emesse devono essere inserite tramite il software dell’API SIGN ES in modo correlativo e includendo questo campo incident.

Si noti che in nessun caso può essere emessa una fattura senza che essa venga trasmessa all’API SIGN ES.

Come generare il codice QR offline?

📘Importante

Finché l’API SIGN ES di fiskaly è disponibile, è necessario stampare le fatture utilizzando l’URL fornito nella risposta di creazione della fattura. Questa procedura è applicabile solo per i casi offline.

In conformità con il regolamento Verifactu, tutte le fatture devono contenere un codice QR Verifactu. Per generare il codice QR per le fatture emesse offline, forniamo il seguente frammento di pseudocodice che illustra un possibile flusso di implementazione:

GET base_url, nif, number, series, date, total_amount
IF series IS NOT EMPTY:
    SET series_number = CONCAT series, number
ELSE:
    SET series_number = number
SET date_string = DATE_FORMAT date AS "DD-MM-YYYY"
SET url_format = "$1?nif=$2&numserie=$3&fecha=$4&importe=$5"
SET url = FORMAT url_format WITH $1 = base_url, $2 = nif, $3 = series_number, $4 = date_string, $5 = total_amount
SET encoded_url = UTF-8_ENCODE url

Durante la generazione dell’URL devono essere presi in considerazione i seguenti aspetti:

L’URL deve mantenere l’ordine in cui vengono forniti i parametri:
- URL base
  - L’URL base per l’ambiente di TEST è: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR
  - L’URL base per l’ambiente LIVE è: https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR
- NIF del contribuente
  - Nell’API SIGN ES, questo corrisponde al campo Crea contribuente > content > issuer > tax_number.
- Serie e numero di fattura
  - Nell’API SIGN ES, questo corrisponde ai campi Crea una fattura > content > series e Crea una fattura > content > number, che vengono concatenati senza spazi né caratteri intermedi. Se la fattura non ha serie, viene utilizzato solo il numero.
- Importo totale della fattura
  - Nell’API SIGN ES, questo corrisponde al campo Crea una fattura > content > full_amount, che deve essere arrotondato a 2 decimali (es. “121.00” e non “121”).
Tutti i caratteri speciali devono essere codificati in UTF-8.
Non devono esserci spazi vuoti all’interno dell’URL.

⚠️Avvertenza

Questo deve essere verificato accuratamente durante l’implementazione e utilizzando l’ambiente di TEST, al fine di evitare discrepanze tra l’URL generato in scenari offline e l’URL che fiskaly genera quando il sistema torna online.

Nelle nostre FAQ troverà esempi per testare questa implementazione.

Il codice QR stampato sulle fatture offline deve seguire le stesse linee guida di quello stampato sulle fatture online, compreso il testo conforme VERI*FACTU. Per ulteriori informazioni, consultare la nostra guida sulla Conformità delle fatture Verifactu.

Was this page helpful?