Il servizio di fiscalizzazione RetailForce è un middleware di fiscalizzazione basato su .NET per la Germania e tutti gli altri paesi.
Installazione
È possibile scaricare una copia del servizio di fiscalizzazione per Windows utilizzando il seguente link:
http://www.retailforce.cloud/downloads
Si prega di scaricare la versione più recente del software.
Il programma di installazione è di facile utilizzo e non sono necessarie ulteriori informazioni.
Una volta completata l’installazione, il servizio è disponibile come servizio web REST (JSON) sulla porta 7678 (HTTP). Il servizio è in ascolto su tutte le interfacce di rete del sistema, non solo su localhost. Per la comunicazione crittografata (HTTPS sulla porta 7677), si veda la sezione “Attivazione HTTPS per una comunicazione API più sicura”.
Alternativa
In alternativa all’installazione del servizio web REST, il RetailForce Fiskal middleware è disponibile anche come:
- Contenitore Docker – scaricabile da Docker Hub all’indirizzo https://hub.docker.com/u/RetailForce, nonché
- nuget-packages – scaricabili all’indirizzo: https://www.nuget.org/profiles/RetailForceDevelopment
Le informazioni relative a queste varianti di installazione/integrazione sono disponibili nei seguenti articoli:
- Container Docker: Linux - TrustedFiscalService come container Docker
- nuget-packages: primi passi nell’implementazione tramite NuGet
Applicazione di esempio
Nella directory di download sopra indicata, all’interno della sottocartella Samples, è presente anche un’applicazione di esempio (Fiscal Service Client Sample). In questa applicazione di esempio è incluso l’intero codice sorgente per la registrazione e la firma di semplici transazioni in C#.
Per utilizzare l’applicazione di esempio, è possibile utilizzare il seguente client-guid:
{c1062c55-57c4-4ed2-9c53-aff1762326a4}
È possibile utilizzare questo GUID client per i primi test senza alcuna limitazione. Per test più avanzati, inclusa l’integrazione con il Cloud, sarà necessario creare un client di prova personale tramite RetailForce Cloud.
Qualora dovesse riscontrare problemi legati alla mancanza di file DLL, La invitiamo a consultare la cartella bin/debug del progetto nell’applicazione di esempio.
Convalida dei documenti
Per agevolare l’integrazione del Suo software, abbiamo implementato una funzione che consente di convalidare il modello a oggetti del documento che invierà al modulo di fiscalizzazione.
Quando si richiama il metodo ValidateDocument su un TrustedFiscalModule creato o sul servizio web di fiscalizzazione (a seconda della propria integrazione), si otterranno immediatamente tutti gli errori (e gli avvisi) relativi al documento. In questo modo risulta molto più semplice adattare la procedura di chiamata per completare il processo di integrazione.
Ulteriori informazioni
L’integrazione del middleware può essere effettuata nei seguenti modi
- Integrazione tramite servizio web (Windows, REST)
- Integrazione tramite servizio web (con Fiskalclient in .NET Standard, nuget)
- Integrazione tramite servizio web (con Fiskalclient in .NET Framework 2.0, nuget)
- Integrazione tramite servizio web (come DLL COM/ActiveX, disponibile su richiesta)
- Integrazione tramite pacchetto AAR su dispositivi Android (per Java) (disponibilità subordinata ai piani di Microsoft)
Alcune informazioni aggiuntive sugli aspetti tecnici
- L’intero sviluppo viene effettuato secondo il metodo Test-Driven Development
- Tutti i test vengono eseguiti durante il processo di compilazione in occasione della creazione di una nuova versione
- La distribuzione della soluzione avviene tramite pacchetti NuGet oppure mediante il download del programma di installazione per Windows.
Sistemi operativi
Il RetailForce Middleware è stato finora testato sui seguenti sistemi operativi:
- Windows 7
- Windows 10
- Android (a partire dalla versione 8) (come integrazione tramite pacchetto nuget)
- Linux (per il servizio)
Si prega di consultare anche la documentazione relativa al sistema di sicurezza per verificare se il sistema di sicurezza prescelto (TSE, HSM, ecc.) nel Paese di riferimento supporti il sistema operativo in uso.
Al momento non testato né supportato, ma dovrebbe funzionare:
- iOS (come integrazione tramite pacchetto nuget)
Gestione dei clienti fiscali
In base alla nostra esperienza, la gestione dei clienti fiscali può talvolta rivelarsi dispendiosa in termini di tempo e complessa.
Pertanto, abbiamo implementato i seguenti servizi aggiuntivi:
- Configurazione automatica dei clienti tramite il RetailForce Cloud, che esclude la necessità di manutenzione del client fiscale installato
- API di gestione RetailForce Cloud per la gestione di ulteriori società, punti vendita e terminali, nonché di tutti gli altri dati anagrafici di cui avrete bisogno.
Documentazione aggiuntiva / documentazione sui servizi
Qui troverà la documentazione aggiuntiva:
Descrizione completa del servizio per il servizio web
- http://localhost:7678/swagger (dopo l’installazione del servizio web)
Documentazione completa (modello a oggetti) del servizio fiscale
Documentazione contenuta nella sottocartella “download” dei file di installazione (link al capitolo “Installazione”)
Questa documentazione sarà presto disponibile all’indirizzo http://docs.retailforce.cloud.
Caratteristiche del Paese (fiscalCountryProperties)
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.