Endpoint DSFinV-K

Endpoint DSFinV-K

In questa pagina viene fornita una panoramica degli endpoint più rilevanti di DSFinV-K, nonché degli endpoint opzionali.

Endpoint opzionali

Le Definizioni IVA e le Agenzie di acquisto sono descritte come «opzionali» in quanto non sono rilevanti per la maggior parte dei contribuenti. La maggior parte dei clienti può iniziare direttamente con l’endpoint Inserire o aggiornare un sistema di cassa.

Creare o aggiornare una Definizione IVA (opzionale)

I tassi IVA di uso comune definiti dalla legge vengono forniti tramite l’API nello stesso ordine dei documenti DSFinV-K emessi dall’Ufficio Centrale Federale delle Imposte tedesco (Bundeszentralamt für Steuern — BZSt), vedere Anlage 2 zur DSFinV-K.

Alcuni contribuenti potrebbero dover creare ulteriori Definizioni IVA con vat_definition_export_id superiore a 1000.

Le Definizioni IVA individuali aggiuntive devono essere definite per ciascuna Organizzazione gestita e per il rispettivo ambiente (LIVE o TEST). Ciò significa che una Definizione IVA creata in un’Organizzazione gestita esisterà solo all’interno di quella specifica organizzazione e nell’ambiente per il quale è stata definita.

Creare o aggiornare un’Agenzia di acquisto (opzionale)

Le Agenzie di acquisto non sono necessarie per tutti i contribuenti. Un’Agenzia di acquisto è richiesta nel caso in cui gli importi siano registrati per conto di terzi (es. «negozio nel negozio»).

Per ulteriori informazioni, fare riferimento al capitolo Allegato A — Definizioni dei termini nel documento DSFinV-K emesso dall’Ufficio Centrale Federale delle Imposte tedesco (BZSt).

Inserire o aggiornare un sistema di cassa

Per ogni dispositivo di sistema di cassa in uso, è necessario creare un Sistema di cassa. Le Chiusure giornaliere vengono eseguite a livello di ogni singolo sistema di cassa. L’inserimento di un sistema di cassa non fa parte delle operazioni quotidiane; tuttavia, i sistemi di cassa esistenti devono essere aggiornati in caso di modifiche, ad esempio aggiornamenti della versione software del sistema di cassa.

Relazione master-terminale nei sistemi di cassa

Nella maggior parte dei casi, il cash_register_type sarà ‘MASTER’. Questo tipo di sistema di cassa è considerato un sistema di registrazione individuale che opera in modo indipendente. Deve essere direttamente connesso a un TSS (vedere Client in SIGN DE).

In determinati scenari, vengono utilizzati i cosiddetti sistemi di cassa terminali in aggiunta al sistema di cassa ‘MASTER’ descritto in precedenza. I dettagli su questa configurazione master-terminale sono riportati nel documento DSFinV-K emesso dall’Ufficio Centrale Federale delle Imposte tedesco (BZSt) a pagina 39. Possono essere utili anche le FAQ pubblicate dal Ministero Federale delle Finanze tedesco (in particolare il n. 7 riguardante i dispositivi portatili nella sezione Anwendungsbereich).

	Funziona in modo indipendente in modalità offline	Deve essere direttamente connesso a un TSS
Sistema di cassa master	Sì	Sì
Sistema di cassa terminale	No	No

Inserire una chiusura giornaliera

Questo endpoint fa parte delle operazioni quotidiane. Una Chiusura giornaliera è un riepilogo di tutti i processi rilevanti — vedere Tipi di processo (ricevuta) e tipi di transazione commerciale — all’interno di un sistema di cassa (di tipo ‘MASTER’) per un determinato periodo di tempo. Deve essere creata almeno una volta al giorno, ad esempio dopo la chiusura del negozio.

Da un punto di vista tecnico, alcuni campi sono contrassegnati come «obbligatori» mentre altri non lo sono. Tuttavia, questo non significa che possano essere lasciati vuoti da un punto di vista legale. Ogni volta che sono state effettuate transazioni in un giorno particolare, i dati rilevanti devono essere inclusi nella chiusura giornaliera nelle sezioni transactions e cash_statement.

Struttura di una chiusura giornaliera

Una Chiusura giornaliera è composta da 3 parti principali:

• Head: Questa sezione definisce l’ambito della chiusura giornaliera indicando il giorno specifico e l’intervallo delle transazioni incluse.

• Cash Statement: Questa parte è l’aggregazione di tutte le transazioni rappresentata in due blocchi:

  • business_cases include il flusso di pagamento totale al sistema di cassa suddiviso per caso commerciale.

  • payment_type include il flusso di pagamento totale al sistema di cassa suddiviso per tipo di pagamento.

• Transactions: Questa parte include informazioni dettagliate su ogni singola transazione all’interno della chiusura giornaliera:

  • head contiene informazioni essenziali sulla transazione.

  • data fornisce i dettagli della transazione.

  • security crea il collegamento alla firma TSS. Se non è presente una firma TSS corrispondente, deve essere fornito un messaggio di errore.

Avviare un’esportazione

Utilizzare questo endpoint per avviare un File di esportazione DSFinV-K che includa le Chiusure giornaliere. Sebbene sia possibile avviare esportazioni anche tramite il fiskaly HUB, si consiglia di implementare questo endpoint in modo tale che il contribuente possa ottenere i file di esportazione direttamente tramite il proprio sistema.

Sono disponibili due opzioni per selezionare le chiusure giornaliere da includere nell’esportazione: ByCreationDate e ByBusinessDate. La data di creazione si riferisce al giorno in cui le chiusure giornaliere sono state inviate all’API DSFinV-K. La data commerciale si riferisce al giorno per cui sono destinate le chiusure giornaliere.

È possibile scegliere TAR o ZIP come formati di esportazione. Si consiglia il formato ZIP, in quanto è supportato dai comuni strumenti di validazione.

A seconda della quantità di dati, la generazione delle esportazioni può richiedere da pochi secondi a un’ora.

Scaricare direttamente un file di esportazione

Una volta completate le esportazioni, è possibile scaricarle tramite l’endpoint Scarica direttamente un file di esportazione nel formato specificato nel passaggio precedente.