API di ricezioneRicevute conformi conun'integrazione
L'API di PosDealer consente agli utenti di gestire i diritti, tenere traccia delle installazioni e fornire configurazioni conformi a migliaia di installazioni.
La fiskaltrust Receipt-API
La fiskaltrust Receipt-API è l’interfaccia centrale per la gestione del ciclo di vita delle ricevute. Copre la creazione, la firma, l’emissione, il trasporto, il recupero e l’accesso ai controlli delle ricevute in modo coerente e regolamentato. Le ricevute sono trattate come un componente fondamentale del sistema, indipendente dal canale, dal dispositivo o dal metodo di consegna, e funzionano allo stesso modo in tutti i mercati supportati.
L’API ti permette di concentrarti sul tuo sistema mentre fiskaltrust si occupa dell’infrastruttura di ricezione. Invece di creare e mantenere formati, logiche di trasporto e casi limite specifici per ogni paese, ti affidi a un’API unificata e open-source che rimane stabile anche quando cambiano le normative e i requisiti operativi.
Funzionalità API di base
Funzionalità API di base
- crea – Ricevuta con articoli, pagamenti e totali.
- firma – Applica le regole fiscali nazionali, le firme e il concatenamento di hash.
- emissione – Consegna la ricevuta in HTML, PDF, codice QR o via e-mail/SMS.
- retrieve – Recupera le ricevute per ID, riferimento all’ordine o intervallo di tempo.
- verify – Convalida le firme e l’integrità.
- revocare – Contrassegnare una ricevuta come annullata o corretta.
- journal – Esporta i log di audit, le chiusure e i report.
Caratteristiche principali
- Flessibilità del formato: Puoi ottenere le ricevute come visualizzazioni o dati grezzi. Scegli tra formati come HTML, PDF, PNG o JSON.
- Conformità: L’API garantisce che le tue ricevute soddisfino i requisiti legali.
- Velocità: utilizza il POS-API Helper per caricare istantaneamente le ricevute. Senza questo aiuto, il caricamento può richiedere fino a cinque minuti.
- Recupero dei dati: L’API fornisce un modo sicuro per accedere ai dati delle ricevute. Questo ti permette di integrare le ricevute nelle tue applicazioni.
Ogni operazione corrisponde alle fasi del ciclo di vita della ricevuta. Una ricevuta viene creata a partire dai dati dell’ordine e del pagamento, firmata secondo la legge nazionale e rilasciata al consumatore. Può essere recuperato per i resi, verificato per le verifiche, revocato se corretto ed esportato come parte di un giornale. L’intero processo è deterministico, a prova di manomissione e in linea con le norme di ogni paese.
Receipt-API fornisce una base resiliente per la gestione delle ricevute, facilitando l'integrazione, riducendo la complessità e garantendo la continuità aziendale anche in caso di guasti alle stampanti grazie al fallback digitale conforme.
Perché gli sviluppatori usano Receipt-API
L’API ti permette di concentrarti sul tuo sistema mentre fiskaltrust si occupa dell’infrastruttura delle ricevute. Invece di trattare le ricevute come una funzione secondaria o un componente aggiuntivo per i consumatori, Receipt-API gestisce le ricevute come un componente del sistema regolamentato di prima classe. Si integra una sola volta e si fa affidamento su un’API unificata e open-source che viene mantenuta in base all’evoluzione delle normative e dei requisiti operativi.
- Open-source: Implementazione trasparente, senza vincoli con i fornitori e completamente verificabile.
- Modello di ricevuta unificato: Un’unica struttura di dati per articoli, pagamenti, tasse, metadati, firme e stati del ciclo di vita.
- Gestione ibrida delle ricevute: Ricevute digitali e cartacee gestite attraverso la stessa API, compresi i formati HTML, ESC/POS, PDF e device-native.
- Supporto multimercato: Stessi payload e stessa logica di ciclo di vita in AT, DE, FR, IT, ES, PT e altri.
- Logica di conformità disaccoppiata: Le regole fiscali, i formati e i meccanismi di firma si evolvono indipendentemente dal codice dell’applicazione.
- Continuità aziendale: La creazione, la firma e l’emissione delle ricevute rimangono deterministiche e affidabili in scenari di rete online, offline e degradati.
- Riduzione dei tempi di integrazione: Non c’è bisogno di gestire il rendering delle ricevute, la logica di stampa o i flussi di trasporto specifici per ogni paese nella tua base di codice.
- Visualizzazione delle ricevute inclusa: Documenti di ricevuta HTML standardizzati e conformi che funzionano su tutti i dispositivi e sistemi operativi.
- Canali di trasporto integrati: Consegna delle ricevute tramite codice QR, URL, e-mail, SMS o passaggio da un dispositivo all’altro, senza logica di trasporto personalizzata.
L’API Receipt consente agli sviluppatori e ai rivenditori di creare un livello di ricevute omnichannel coerente e di esporre i dati delle ricevute come servizio riutilizzabile.
Le ricevute diventano una fonte di dati sicura e strutturata che può essere riutilizzata in tutte le integrazioni di fidelizzazione, contabilità e terze parti, trasformando le transazioni in punti di contatto estensibili del sistema piuttosto che in eventi isolati.
Opzioni di hosting
Opzioni di hosting
- Servizi locali: Windows, Linux, macOS, Android, iOS.
- Data center commerciale: Cluster Kubernetes o implementazione di IIS.
- Cloud: Regioni europee di Azure con conformità specifica al mercato.
- Fallback offline: Il broker IoT locale assicura che le operazioni di ricezione continuino durante le interruzioni.
Receipt-API supporta un’implementazione flessibile. Può essere integrata nel tuo POS, eseguita come servizio locale, distribuita su scala in un centro dati o utilizzata tramite servizi cloud ospitati da fiskaltrust. Tutti i modelli seguono lo stesso contratto API. I broker offline assicurano che la creazione e la firma delle ricevute funzionino anche in caso di interruzione della connessione internet.
Ambiente Sandbox
Puoi testare il sistema nel nostro ambiente sandbox. Registrati come partner nel portale fiskaltrust Market. Estendi il tuo endpoint per chiamare l’API. Questo processo ti permette di recuperare i dati delle ricevute nel formato che preferisci e di visualizzarli.
Come funziona in 3 passi
1.
Iscriviti sul sito fiskaltrust.Portal.
2.
Crea una cassa e collegala al tuo POS o ERP.
3.
Inizia a creare ed emettere ricevute con la Receipt-API.
Per saperne di più - La documentazione, gli SDK e gli ambienti di prova sono disponibili qui