fiskaly SUBMIT DE

Introduzione

fiskaly SUBMIT DE è un servizio basato su cloud fornito da fiskaly Germany GmbH che assiste nell’adempimento dell’obbligo di presentare dichiarazioni dei sistemi di Punto Vendita (POS) disponibili per stabilimento secondo il § 146a (4) del Codice Fiscale tedesco (AO) e la sezione “1.16. Mitteilungspflicht nach § 146a (4) AO” del corrispondente Decreto Applicativo (AEAO). Il servizio consente l’inserimento e la gestione dei dati rilevanti, la generazione e la validazione sintattica delle dichiarazioni secondo il § 146a (4), e la trasmissione delle dichiarazioni al portale ELSTER tramite i servizi ERiC/ELSTER. fiskaly SUBMIT DE è accessibile tramite un’API RESTful e gestito attraverso il Dashboard di fiskaly.

Il servizio consente ai fornitori di POS (CLIENTE) di fornire questo servizio ai propri commercianti (CLIENTE FINALE) e/o di utilizzare il servizio essi stessi come CLIENTE FINALE se sono direttamente responsabili come contribuenti.

Descrizione del servizio

fiskaly fornisce fiskaly SUBMIT DE come soluzione SaaS RESTful basata su JSON. Gli aspetti chiave includono:

Inserimento, gestione e recupero dei dati dei CLIENTI FINALI.
Inserimento, recupero ed eliminazione dei dati POS — sia per i POS integrati con fiskaly SIGN DE v2 che per i POS “esterni” che non utilizzano SIGN DE v2.
Generazione, recupero, eliminazione e trasmissione dei set di dati di dichiarazione per stabilimento.
Validazione sintattica dei dati di dichiarazione utilizzando regole interne e la libreria ERiC, inclusa la validazione tramite ELSTER.
Trasmissione delle dichiarazioni al portale ELSTER utilizzando il proprio certificato ELSTER di fiskaly; le dichiarazioni vengono assegnate al CLIENTE FINALE tramite i dati del CLIENTE FINALE inclusi nella dichiarazione.
Il CLIENTE FINALE può verificare i set di dati inviati tramite il PDF restituito da ELSTER al termine della trasmissione, o accedendo al proprio account ELSTER.
Per un CLIENTE con integrazioni SIGN DE v2 esistenti, fiskaly recupera automaticamente tutti i dati TSS e POS rilevanti per la dichiarazione da SIGN DE v2. Per le integrazioni non SIGN DE v2, il CLIENTE e il CLIENTE FINALE sono gli unici responsabili della fornitura di tutti i dati richiesti.

📘Note

Il servizio non include: validazione semantica dei dati (eccetto quella fornita da ELSTER, ad es. verifica dell’esistenza dell’ID del contribuente); automazione che avvia un nuovo processo di dichiarazione (ad es. tracciamento delle modifiche ai dati); né responsabilità per errori originati dall’infrastruttura ERiC/ELSTER.

Funzionalità

Autenticazione del cliente: Autenticazione sicura del CLIENTE basata su API.
Gestione dei dati: Endpoint per l’inserimento, il recupero e l’eliminazione dei dati dei CLIENTI FINALI come dati del contribuente, dati dello stabilimento e dati POS.
Generazione delle dichiarazioni: Generazione di set di dati di dichiarazione per stabilimento, con validazione sintattica rispetto alle regole interne e agli schemi ERiC/ELSTER definiti dalle autorità fiscali tedesche.
Trasmissione delle dichiarazioni: Trasmissione delle dichiarazioni validate al portale ELSTER utilizzando il certificato ELSTER di fiskaly. Il servizio riprova le richieste a ELSTER in caso di errori temporanei e inoltra tutte le altre risposte di errore ERiC/ELSTER al cliente.
Evidenza delle dichiarazioni: Recupero delle prove di tutte le dichiarazioni sotto forma di file XML o PDF.
Integrazione SIGN DE v2: Per i POS integrati con SIGN DE v2, mirroring automatico delle istanze TSS e dei dati POS; le modifiche alle risorse SIGN DE v2 vengono rispecchiate automaticamente. Il CLIENTE FINALE deve fornire solo il set di dati aggiuntivo per POS richiesto ai fini della dichiarazione.
Supporto ERS non-SIGN DE v2: Per le integrazioni non-SIGN DE, tutti i dati rilevanti vengono forniti dal CLIENTE tramite endpoint “esterni” dedicati. Sono supportati stabilimenti misti (sia integrazioni SIGN DE che esterne).
Flusso di consenso del CLIENTE FINALE: Prima di avviare la trasmissione, il CLIENTE deve scaricare il PDF di anteprima, presentarlo al CLIENTE FINALE e ottenere la conferma della correttezza e il consenso alla trasmissione. Questo deve essere ripetuto per ogni trasmissione.

Requisiti di sistema

Un rapporto contrattuale valido con fiskaly che consenta l’utilizzo del servizio e fornisca accesso all’HUB fiskaly per la creazione delle credenziali di autenticazione.
Una connessione Internet.
Integrazione di ogni POS con un Sistema di Sicurezza Tecnica (TSS) certificato.
Non è richiesto nessun altro software o hardware speciale.
La documentazione dell’API e le guide all’integrazione sono disponibili su workspace.fiskaly.com; è disponibile anche una collezione Postman Quick-Start.

Manutenzione e supporto

fiskaly si impegna a mantenere e aggiornare fiskaly SUBMIT DE per garantirne la sicurezza, la disponibilità e la conformità con i requisiti emessi dalle autorità fiscali tedesche. Il servizio è versionato secondo il versionamento semantico; i breaking changes danno origine a nuove versioni principali e tutte le modifiche visibili ai clienti sono documentate in un changelog pubblico. Il servizio dipende dall’infrastruttura ERiC/ELSTER gestita dalle autorità fiscali tedesche; le versioni ERiC/ELSTER sono supportate per un periodo limitato (10–17 mesi) prima della deprecazione. fiskaly si impegna ad aggiornare il servizio per garantire la compatibilità continuativa. Le attività di manutenzione possono comportare l’interruzione temporanea del servizio. Per quanto possibile, queste attività saranno annunciate con almeno due (2) settimane di anticipo; le attività di manutenzione di emergenza possono deviare da questo. I clienti sono incoraggiati a iscriversi alla pagina di stato fiskaly (status.fiskaly.com). fiskaly fornisce assistenza tramite il portale di supporto fiskaly (support.fiskaly.com), incluse FAQ, guide pratiche e supporto tramite dev-support@fiskaly.com o il Widget Web dal Dashboard, dalla Pagina di Supporto e dalla Pagina dello Sviluppatore.

Test

fiskaly fornisce un ambiente TEST per fiskaly SUBMIT DE. Questo è un sistema end-to-end completamente funzionale che trasmette dati alle autorità fiscali tedesche. Le dichiarazioni nell’ambiente TEST sono contrassegnate come dati di test e non sono rilevanti ai fini delle verifiche fiscali. Le nuove versioni del servizio sono disponibili nell’ambiente TEST prima del loro rilascio LIVE. fiskaly non è responsabile se vengono forniti dati reali nell’ambiente TEST.

Limitazioni del servizio

Il servizio non fornisce la validazione semantica dei dati; la completezza e la correttezza sono di esclusiva responsabilità del CLIENTE FINALE.
Il servizio non include automazione che avvia nuovi processi di dichiarazione (ad es. tracciamento delle modifiche ai dati forniti). La generazione e la trasmissione delle dichiarazioni devono essere avviate dal CLIENTE FINALE o dal CLIENTE che agisce per suo conto in conformità con i requisiti legali.
Il servizio dipende dall’infrastruttura ERiC/ELSTER gestita dalle autorità fiscali tedesche. fiskaly non si assume responsabilità per ritardi, interruzioni o errori originati da ERiC/ELSTER. Il CLIENTE è responsabile dell’analisi di tali errori e dell’adattamento delle risposte del suo sistema di conseguenza.
ERiC/ELSTER può introdurre breaking changes che comportano la deprecazione di una versione principale. Il CLIENTE è responsabile di rimanere aggiornato e di integrare le nuove versioni principali non appena vengono annunciate e rese disponibili nell’ambiente TEST.
L’utilizzo della stessa ORGANIZZAZIONE di tipo UNIT (precedentemente tipo MANAGED) per diversi CLIENTI FINALI è espressamente sconsigliato e risulterà probabilmente in dichiarazioni errate; fiskaly declina qualsiasi responsabilità per tali casi.
Per facilitare un funzionamento fluido, fiskaly raccomanda vivamente che le integrazioni distribuiscano l’utilizzo nel tempo ed evitino richieste batch di decine o centinaia di dichiarazioni simultaneamente.

Obblighi del cliente

Deve integrare correttamente il servizio come documentato, tenendo conto delle distinzioni tra le integrazioni POS SIGN DE v2 ed esterne.
Deve informarsi dei requisiti legali ed essere in grado di fornire — o consentire al CLIENTE FINALE di fornire — il set di dati completo e corretto richiesto per le dichiarazioni.
Prima di avviare ogni trasmissione, il CLIENTE deve scaricare il PDF di anteprima, presentarlo al rispettivo CLIENTE FINALE e ottenere la sua conferma di (a) la correttezza dei dati della dichiarazione e (b) il consenso alla sua trasmissione alle autorità fiscali. Questo consenso deve essere trasmesso tramite il campo di consenso legale nell’API e deve essere ripetuto per ogni trasmissione.
Ogni ORGANIZZAZIONE CLIENTE di tipo UNIT (precedentemente tipo MANAGED) deve essere mappata a un singolo CLIENTE FINALE. I Clienti che intendono utilizzare il servizio per conto di più CLIENTI FINALI devono creare organizzazioni individuali di tipo UNIT (precedentemente tipo MANAGED) per ogni CLIENTE FINALE.
Per le integrazioni SIGN DE v2: il CLIENTE è responsabile della fornitura dei dati aggiuntivi richiesti per POS oltre a quelli recuperati automaticamente da SIGN DE v2. La gestione (creazione/disabilitazione) delle istanze TSS di SIGN DE v2 e dei client POS tramite SUBMIT DE non è possibile.
Per le integrazioni non-SIGN DE: il CLIENTE è il solo responsabile della fornitura di tutti i dati richiesti tramite gli endpoint esterni.
Deve istruire o facilitare il CLIENTE FINALE nella conservazione dei dati fiscalmente rilevanti come previsto dalla legge, in particolare i file di dichiarazione come prova dell’adempimento degli obblighi, indipendentemente dalla disponibilità degli stessi dati nel servizio fiskaly SUBMIT DE.
Deve informare fiskaly dei problemi riscontrati nell’utilizzo del servizio tramite i canali di supporto forniti.
Deve distribuire l’utilizzo del servizio nel tempo ed evitare richieste batch per facilitare un funzionamento fluido per tutti i clienti.
Deve proteggere l’accesso ai propri dati attraverso un’adeguata gestione degli utenti e misure di sicurezza delle informazioni aggiornate.

Versione: v.1 | Ultimo aggiornamento: 2026/03/24

Was this page helpful?