Vai al contenuto principale
Werkzeu.ge
Italiano
AccediInizia gratis
Esporta i tuoi dati di fatturazione in un formato compatibile con DATEV - non è una consulenza fiscale. La verità contabilizzata la verifica alla fine il tuo consulente fiscale (Steuerberater).
ProAPI e automazione

REST API & DATEV Export - API REST e interfaccia di esportazione

I dati delle tue fatture sono tuoi, quindi accedici anche in modo programmatico. Con la REST API scoped scarichi fatture, clienti e pagamenti o ne crei di nuovi, con i webhook firmati HMAC ricevi gli eventi in tempo reale, e l’esportazione DATEV genera un lotto di registrazioni (Buchungsstapel) ordinato per il tuo consulente fiscale (Steuerberater). Automatizzare la contabilità, invece di ribatterla a mano.

Uno sguardo dentro

API e automazioneREST API & DATEV Export - API REST e interfaccia di esportazioneDemo fittizia | Pro
✓Protetto
Controllo della privacy

Chiavi API scoped

1Chiavi API scoped
2Dati delle fatture via REST
3Webhook firmati HMAC
4Lotto di registrazioni DATEV
Anteprima di sola lettura. Per usarlo, apri lo strumento.

Questa anteprima sicura mostra a cosa serve lo strumento, senza eseguire azioni legate all'account.

Cosa sa fare REST API & DATEV Export - API REST e interfaccia di esportazione

Chi lavora sul serio con le fatture, prima o poi vuole uscire dal lavoro manuale a colpi di clic. I numeri devono confluire in automatico nel proprio software, il consulente fiscale deve ricevere le registrazioni senza doverle ribattere, e gli altri sistemi devono accorgersi quando una fattura è stata pagata. Proprio per questo lo strumento riunisce tre elementi: una REST API, webhook in uscita ed esportazione DATEV.

La REST API è scoped, cioè con permessi a granularità fine. Crei chiavi API e assegni i diritti in modo mirato: «Leggere vendite» (sales:read) per scaricare fatture, clienti, articoli e pagamenti, «Scrivere vendite» (sales:write) per creare bozze, rendere definitive le fatture e registrare pagamenti, e «Gestire webhook» (webhooks:manage) per le iscrizioni ai webhook. Ogni chiave mostra il suo prefisso e quando è stata usata l’ultima volta, e si può revocare in qualsiasi momento. Così una chiave di integrazione per un programma di contabilità resta limitata esattamente ai diritti che le servono.

I webhook in uscita consegnano gli eventi in tempo reale al tuo URL. Quando una fattura viene resa definitiva o viene registrato un pagamento, il sistema manda un messaggio firmato al tuo endpoint. La firma HMAC ti permette di verificare l’autenticità di ogni consegna, così nessuno può infilare eventi falsi. In questo modo reagisci in automatico agli eventi di business, invece di fare polling.

L’esportazione DATEV è il cuore della collaborazione con il consulente fiscale. Dalle tue fatture di un periodo lo strumento genera un lotto di registrazioni (Buchungsstapel) compatibile con DATEV in formato EXTF, che il tuo studio può importare direttamente in DATEV Kanzlei-Rechnungswesen. Indichi numero consulente (sette cifre), numero cliente (cinque cifre), inizio dell’anno di esercizio e piano dei conti, SKR03 o SKR04, e l’esportazione associa conti dei ricavi e dei clienti secondo le regole canoniche.

La validazione è severa perché DATEV è severo. Il numero consulente e il numero cliente devono avere esattamente il numero giusto di cifre, e la data finale deve essere dopo quella iniziale. Piccoli errori di formato portano altrimenti a problemi di importazione più tardi nello studio: meglio che lo strumento li intercetti subito, con messaggi chiari invece di criptici errori DATEV.

Questo strumento è pensato per chi vuole far crescere la propria contabilità: autonomi con molte fatture, piccole imprese con strumenti propri e chiunque voglia rendere felice il proprio consulente fiscale. Insieme all’API-Spielplatz (area di prova delle API) per provare gli endpoint e agli script per l’elaborazione successiva, ne nasce una catena di automazione che riduce parecchio il lavoro contabile manuale.

Funzioni

Chiavi API scoped

Assegna i diritti in modo mirato: leggere vendite, scrivere vendite o gestire webhook, per ogni chiave e revocabili in qualsiasi momento.

Dati delle fatture via REST

Scarica in modo programmatico fatture, clienti, articoli e pagamenti, oppure crea bozze e rendile definitive.

Webhook firmati HMAC

Gli eventi arrivano in tempo reale al tuo URL, firmati HMAC, così verifichi l’autenticità di ogni consegna.

Lotto di registrazioni DATEV

Genera un’esportazione compatibile con DATEV in formato EXTF per l’importazione diretta in DATEV Kanzlei-Rechnungswesen.

SKR03 e SKR04

Scegli il tuo piano dei conti e l’esportazione associa conti dei ricavi e dei clienti secondo le regole canoniche.

Validazione severa

Numero consulente, numero cliente e periodo vengono controllati prima, così l’importazione nello studio non fallisce.

Come funziona

  1. 1

    Crea una chiave API

    Crea una chiave e assegna solo i diritti di cui la tua integrazione ha davvero bisogno.

  2. 2

    Chiama gli endpoint

    Usa la chiave per scaricare o creare fatture e pagamenti via REST. Per provare ti aiuta l’API-Spielplatz.

  3. 3

    Configura i webhook

    Registra il tuo URL e controlla la firma HMAC di ogni messaggio in arrivo, per reagire agli eventi.

  4. 4

    Genera l’esportazione DATEV

    Inserisci numero consulente, numero cliente, anno di esercizio e piano dei conti, scegli il periodo e scarica il lotto di registrazioni.

A chi serve

→Autonomi che portano in automatico i dati delle fatture nel proprio software.
→Aziende che consegnano al proprio consulente fiscale lotti di registrazioni già pronti.
→Sviluppatori che elaborano in tempo reale gli incassi tramite webhook.
→Contabilità che vogliono abolire la ribattitura manuale dei documenti.
→Team che collegano sistemi di terze parti ai dati delle fatture in modo sicuro e scoped.

Domande frequenti

Cos’è un lotto di registrazioni DATEV?

Un file standardizzato in formato EXTF che il tuo consulente fiscale può importare direttamente in DATEV Kanzlei-Rechnungswesen. Invece di registrare ogni fattura a mano, importa il lotto in un colpo solo. Fa risparmiare tempo ed evita errori di trascrizione.

SKR03 o SKR04, quale scelgo?

Dipende dal piano dei conti della tua contabilità. Nel dubbio chiedi al tuo consulente fiscale quale usate e impostalo di conseguenza nell’esportazione. Lo strumento associa i conti dei ricavi e dei clienti in base al piano scelto.

Come metto al sicuro le mie chiavi API?

Assegna a ogni chiave solo gli scope necessari, ad esempio solo accesso in lettura per un programma di solo reporting. Se una chiave mostra un uso sospetto o un dispositivo viene compromesso, la revochi subito. L’ultimo momento di utilizzo ti aiuta a riconoscere le chiavi inutilizzate.

Perché i webhook sono firmati?

Perché tu possa avere la certezza che un evento in arrivo provenga davvero da noi. La firma HMAC viene calcolata con la tua chiave segreta. Se la verifichi dalla tua parte, nessuno può mandare eventi falsi al tuo endpoint.

Perché la validazione dei numeri è così severa?

Perché lo è DATEV. Il numero consulente deve avere esattamente sette cifre, il numero cliente esattamente cinque. Se il formato non torna, DATEV rifiuta l’importazione. Lo strumento controlla i dati prima e segnala gli errori in chiaro, così il lotto passa senza intoppi nello studio.

API-Spielplatz - Area di prova per le API

Testa richieste HTTP, gestisci collezioni e variabili d'ambiente.

Mock-Server - Server fittizio

Crea risposte API inventate e provale nello strumento: stato, header, body e ritardo.

Skripte - Script

Esegui JavaScript tuo in una sandbox isolata sul server: per calcoli, trasformazione dei dati…

Einkommensteuer-Rechner - Calcolatore dell'imposta sul reddito

Calcola la tua imposta sul reddito secondo il § 32a EStG. Tariffa base e Splittingtarif, Soli…

Formattatore JSON

Formatta, convalida e minimizza JSON con evidenziazione della sintassi e rilevamento degli er…

Pronto per REST API & DATEV Export - API REST e interfaccia di esportazione?

Nessuna installazione. Incluso a partire da Pro. Si apre direttamente nel browser.

Apri ora