Supporto e risorse

In fiskaly ci impegniamo a migliorare costantemente noi stessi, i nostri sistemi e la qualità che offriamo. Come in tutti i progetti software, possono sorgere problemi. Siamo impegnati in un processo operativo trasparente.

Come segnalare un problema di supporto

Prima di segnalare un nuovo problema, controlla la nostra pagina di stato su status.fiskaly.com per i problemi operativi noti.

1. Raccogliere le informazioni necessarie

   Raccogli tutti i dettagli rilevanti sul problema prima di contattare il supporto. Consulta la lista di controllo qui sotto per sapere cosa ci serve.

2. Preparare il tuo rapporto

   Scrivi una descrizione chiara usando il modello di email fornito di seguito. Includi tutti gli ID risorse e i timestamp.

3. Inviare al supporto sviluppatori

   Invia il tuo rapporto via email a dev-support@fiskaly.com con un ticket per ogni problema distinto.

4. Attendere la risposta

   Il nostro team ti risponderà il prima possibile. Apprezziamo che ci invii direttamente informazioni di mercato e possibili problemi.

Lista di controllo delle informazioni necessarie

📘Includi sempre quanto segue

Quando segnali un problema, assicurati di fornire tutti questi dettagli per un’analisi qualificata:

• La tua identità — chi sei e quale azienda rappresenti?

• Timestamp — un timestamp preciso di quando si è verificato il problema (segnala il prima possibile)

• Descrizione dell’azione — quale azione è stata eseguita (es. PUT https://…) e cosa è stato fatto prima che si verificasse l’errore

• Frequenza — il problema è permanente, si è verificato una sola volta o solo su risorse selezionate?

• Versione API — es. V0, V1, V2

• Ambiente — LIVE o TEST

• UUID delle risorse — Organisation-ID, TSS-ID, TX-ID, Client-ID, Export-ID (es. 550e8400-e29b-11d4-a716-446655440000)

• Request ID — parte della risposta della nostra API, utilizzato per tracciare la richiesta attraverso tutti i sistemi

• Risposta API completa — la risposta completa dalla nostra API

• Messaggi di errore del tuo sistema — utili solo in combinazione con tutto quanto sopra

Modello di email

Usa il seguente modello quando segnali un problema:

Hey fiskaly,

I'm <XY> from Company <Z>.
We've identified a problem with the integration of fiskaly <API> in <VERSION>.
The problem occured <at time/between time /is ongoing, started at time>.

It affects:
- Request Id: <550e8400-e29b-11d4-a716-446655440000>
- Organisation-ID: <550e8400-e29b-11d4-a716-446655440000>
- TSS-ID: <550e8400-e29b-11d4-a716-446655440000>
- TX-ID: <550e8400-e29b-11d4-a716-446655440000>
- Export-ID: <550e8400-e29b-11d4-a716-446655440000>

The problem is <INSERT clear, reproducible error description>.

It happens when we <Description of API calls made>.
The full request was: <INSERT HTTP-REQUEST>
The full response was: <INSERT HTTP-RESPONSE>

Before that we were performing .. <INSERT ACTIONS before>

Looking forward to identifying the root cause and finding a solution together.
Best,

Contatta il supporto sviluppatori

Collezioni di esempi

💡Ambiente sandbox

Le collezioni di esempi qui sotto sono progettate per l’ambiente sandbox (TEST). Assicurati che le tue chiavi API e variabili di ambiente siano configurate per l’ambiente di test prima di eseguire le richieste. Non usare credenziali di produzione con queste collezioni.

📘Avviso di versione

Gli esempi Postman di seguito coprono la versione 1 del fiskaly Cloud-TSS. Per esempi della versione 2 certificata, consulta la guida Postman separata nella sezione della documentazione di SIGN DE.

Scarica la collezione Postman

Link utili

Pagina di stato fiskaly

Controlla i problemi operativi noti e gli aggiornamenti sullo stato del sistema.

Introduzione a SIGN DE

Inizia con il TSS cloud di fiskaly per la conformità fiscale tedesca.

Guida introduttiva

Guida passo-passo per configurare il tuo primo TSS ed elaborare transazioni.