Supporto e segnalazione problemi

Qualcosa non funziona come previsto? Questa pagina ti aiuta a risolverlo rapidamente. La maggior parte dei problemi si risolve più in fretta quando il primo messaggio contiene già tutto ciò che ci serve: leggi la checklist prima di scriverci.

💡Hai già aperto un ticket?

Grazie. Rispondi all’e-mail del ticket con i dettagli della checklist qui sotto. Mantieni il numero del ticket nell’oggetto, così la tua risposta viene associata al caso corretto.

Prima di contattarci

Controlla lo stato del servizio

Incidenti noti e finestre di manutenzione vengono pubblicati qui per primi. Se uno stato è rosso, non serve aprire un ticket.

Cerca il codice di errore

La maggior parte degli errori API è documentata qui con causa e soluzione. Cerca per codice di errore o stato HTTP.

Esplora i prodotti

Ogni prodotto ha le proprie guide all'integrazione e FAQ. Trova il tuo nella panoramica dei prodotti.

Scegli il canale giusto

Arrivare subito al team giusto evita un giro a vuoto.

La tua situazione	A chi rivolgersi
Errore API, risposta inattesa, domanda sull’integrazione	Developer Support: dev-support@fiskaly.com, vedi sotto
Gestisci un registratore di cassa e vedi un errore sul dispositivo	Il tuo fornitore POS è il primo punto di contatto. Consulta l’Operator Center per sapere a chi chiedere cosa.
Contratti, prezzi o domande commerciali	sales@fiskaly.com
Fatture e contabilità	buchhaltung@fiskaly.com

Segnalare un problema

Invia la segnalazione a dev-support@fiskaly.com. Apri un ticket per problema. Se noti due problemi non correlati, invia due segnalazioni. I ticket misti richiedono più tempo perché possono coinvolgere ingegneri diversi.

Contatta il Developer Support

Cosa includere

1. Descrivi cosa ti aspettavi e cosa è successo

   Bastano una o due frasi. Includi il messaggio di errore esatto, se presente.

2. Dicci dove e quando

   Ambiente (TEST o LIVE), API e versione, e un timestamp con fuso orario. Segnala il prima possibile: i log si correlano più facilmente quando l’evento è recente.

3. Allega la richiesta e la risposta completa

   Includi l’identificatore che ci permette di tracciare la chiamata: l’header X-Trace-Identifier per la API unificata (SIGN IT, FR, PT, SE, BE, ES, AT, CZ, E-INVOICE) oppure il request ID dell’header di risposta X-Request-ID per SIGN DE, DSFinV-K e la Management API. Con esso troviamo la chiamata nei nostri sistemi in pochi secondi.

4. Aggiungi gli ID delle risorse coinvolte

   Gli ID rilevanti dipendono dal prodotto. Usa la tabella qui sotto come guida.

⚠️Non inviare mai credenziali

Rimuovi API secret, token bearer e password da qualsiasi richiesta che alleghi. Non te li chiederemo mai. Se sospetti che una chiave sia compromessa, ruotala prima e poi avvisaci.

ID delle risorse per prodotto

Prodotto	ID da includere
Unified API (SIGN IT, FR, PT, SE, ES, AT, CZ and E-INVOICE)	Organization ID, Taxpayer ID, Location ID, System ID, Subject ID, Record ID
SIGN DE (Specialized API)	Organization ID, TSS ID, Client ID, Transaction ID, Export ID
SIGN AT (Specialized API)	Cash Register ID, Receipt ID, Signature Creation Unit ID
SIGN ES (Specialized API)	Signer ID, Client ID, Invoice ID, Export ID
DSFinV-K	Cash Register ID, Closing ID, Export ID
SAFE	File ID, Export ID, Annotation ID
eReceipt	Receipt ID, Static ID, Revision
Management API	Organization ID, User ID, Key ID (mai il secret)

Modello di segnalazione

Copia il modello nella tua e-mail e compila ogni riga pertinente. Il modello resta in inglese perché il nostro team di supporto smista tutti i ticket in inglese. Puoi descrivere il problema nella tua lingua subito sotto.

Subject: [PRODUCT] Short description of the problem

Company / Organization:
Environment: TEST | LIVE
API and version:
First occurrence (date, time, timezone):
Frequency: once | intermittent | permanent

What I expected:
What happened instead (exact error message):

Request (method, URL, body without secrets):
Response (full body and status code):
Request ID / X-Trace-Identifier:

Affected resource IDs:

What we did right before the error:

Se la produzione è coinvolta, indicalo nell’oggetto, ad esempio [LIVE] Signing fails for all clients. Ci aiuta a vedere l’impatto a colpo d’occhio.

Cosa succede dopo

1. Conferma

   Ricevi un numero di ticket via e-mail. Usalo in tutte le comunicazioni successive.

2. Triage

   Esaminiamo la segnalazione e la inoltriamo alla persona giusta.

3. Analisi

   Potremmo farti domande aggiuntive. Più completo è il primo messaggio, meno ne serviranno.

4. Risoluzione

   Ti teniamo aggiornato nel ticket e lo chiudiamo una volta risolto il problema.

Link utili

Stato del servizio

Stato in tempo reale di tutti i servizi fiskaly e cronologia degli incidenti.

Codici di errore

Riferimento centrale per i codici di errore API e come risolverli.

Riferimento API

Endpoint, schemi ed esempi per ogni API fiskaly.